@dice-o-rolla/dice-assets 0.3.1 → 0.5.0

package/assets/runtime/previews/diagnostic-d8.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="2048" height="2048" viewBox="0 0 2048 2048"><defs><pattern id="grid" width="16" height="16" patternUnits="userSpaceOnUse"><path d="M 16 0 H 0 V 16" fill="none" stroke="#142035" stroke-opacity=".2" stroke-width="1"/></pattern></defs><polygon points="1024,1290.0430040425795 1638.3999999999999,1290.0430040425795 1331.2,757.9569959574203" fill="#a8d98c" stroke="#a8d98c" stroke-width="16" stroke-linejoin="round"/><polygon points="1024,1290.0430040425795 1331.2,757.9569959574205 716.8000000000001,757.9569959574205" fill="#8ccce8" stroke="#8ccce8" stroke-width="16" stroke-linejoin="round"/><polygon points="1024,1290.0430040425795 716.8000000000001,757.9569959574205 409.59999999999997,1290.0430040425795" fill="#e5a2cb" stroke="#e5a2cb" stroke-width="16" stroke-linejoin="round"/><polygon points="1024,1290.0430040425795 1331.2,1822.1290121277386 1638.3999999999999,1290.0430040425795" fill="#d3bcf3" stroke="#d3bcf3" stroke-width="16" stroke-linejoin="round"/><polygon points="1024,225.87098787226114 716.8000000000001,757.9569959574205 1331.2,757.9569959574205" fill="#f0da85" stroke="#f0da85" stroke-width="16" stroke-linejoin="round"/><polygon points="1945.6000000000001,757.9569959574203 1331.2,757.9569959574203 1638.3999999999999,1290.0430040425795" fill="#87d9cd" stroke="#87d9cd" stroke-width="16" stroke-linejoin="round"/><polygon points="1945.6000000000001,1822.1290121277386 1638.3999999999999,1290.0430040425795 1331.2,1822.1290121277386" fill="#ef9c99" stroke="#ef9c99" stroke-width="16" stroke-linejoin="round"/><polygon points="102.39999999999992,757.9569959574205 409.59999999999997,1290.0430040425795 716.8000000000001,757.9569959574205" fill="#f6b573" stroke="#f6b573" stroke-width="16" stroke-linejoin="round"/><defs><clipPath id="face-1"><polygon points="1024,1290.0430040425795 1638.3999999999999,1290.0430040425795 1331.2,757.9569959574203"/></clipPath></defs><g clip-path="url(#face-1)"><polygon points="1024,1290.0430040425795 1638.3999999999999,1290.0430040425795 1331.2,757.9569959574203" fill="url(#grid)"/><polygon points="1024,1290.0430040425795 1638.3999999999999,1290.0430040425795 1331.2,757.9569959574203" fill="none" stroke="#162338" stroke-width="3"/><path d="M 1208.32 1290.0430040425795 l 50.50336890020568 -72.89533407379194" stroke="#fff" stroke-width="10"/><circle cx="1208.32" cy="1290.0430040425795" r="6" fill="#132035"/><text x="1331.1999999999998" y="1265.212323665272" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:2</text><path d="M 1546.2399999999998 1130.4172016170317 l -88.38089557536004 -7.289533407379226" stroke="#fff" stroke-width="10"/><circle cx="1546.2399999999998" cy="1130.4172016170317" r="6" fill="#132035"/><text x="1463.2959999999998" y="1036.4153401886535" font-size="30.15154045815901" text-anchor="middle" fill="#142035">2:4</text><path d="M 1116.16 1130.4172016170317 l 88.38089557536004 -7.289533407379233" stroke="#fff" stroke-width="10"/><circle cx="1116.16" cy="1130.4172016170317" r="6" fill="#132035"/><text x="1199.1039999999998" y="1036.4153401886535" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:4</text><text x="1331.1999999999998" y="1112.6810013475263" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">1</text><path d="M 1224.782798382968 1236.8344032340633 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="1331.1999999999998" y="999.1693196226923" font-size="28.377920431208477" text-anchor="middle">d8 / F1</text></g><defs><clipPath id="face-2"><polygon points="1024,1290.0430040425795 1331.2,757.9569959574205 716.8000000000001,757.9569959574205"/></clipPath></defs><g clip-path="url(#face-2)"><polygon points="1024,1290.0430040425795 1331.2,757.9569959574205 716.8000000000001,757.9569959574205" fill="url(#grid)"/><polygon points="1024,1290.0430040425795 1331.2,757.9569959574205 716.8000000000001,757.9569959574205" fill="none" stroke="#162338" stroke-width="3"/><path d="M 1116.1599999999999 1130.4172016170317 l -37.877526675154286 -80.1848674811711" stroke="#fff" stroke-width="10"/><circle cx="1116.1599999999999" cy="1130.4172016170317" r="6" fill="#132035"/><text x="1156.096" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:4</text><path d="M 901.1200000000001 757.9569959574205 l 50.50336890020572 72.89533407379191" stroke="#fff" stroke-width="10"/><circle cx="901.1200000000001" cy="757.9569959574205" r="6" fill="#132035"/><text x="1024" y="782.7876763347278" font-size="30.15154045815901" text-anchor="middle" fill="#142035">3:4</text><path d="M 931.84 1130.4172016170317 l 37.87752667515433 -80.18486748117107" stroke="#fff" stroke-width="10"/><circle cx="931.84" cy="1130.4172016170317" r="6" fill="#132035"/><text x="891.9040000000001" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:3</text><text x="1024" y="935.3189986524735" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">2</text><path d="M 917.5827983829682 1059.4724005390106 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="1024" y="821.8073169276396" font-size="28.377920431208477" text-anchor="middle">d8 / F2</text></g><defs><clipPath id="face-3"><polygon points="1024,1290.0430040425795 716.8000000000001,757.9569959574205 409.59999999999997,1290.0430040425795"/></clipPath></defs><g clip-path="url(#face-3)"><polygon points="1024,1290.0430040425795 716.8000000000001,757.9569959574205 409.59999999999997,1290.0430040425795" fill="url(#grid)"/><polygon points="1024,1290.0430040425795 716.8000000000001,757.9569959574205 409.59999999999997,1290.0430040425795" fill="none" stroke="#162338" stroke-width="3"/><path d="M 931.8399999999999 1130.4172016170317 l -88.38089557536006 -7.289533407379137" stroke="#fff" stroke-width="10"/><circle cx="931.8399999999999" cy="1130.4172016170317" r="6" fill="#132035"/><text x="848.8960000000001" y="1036.4153401886538" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:3</text><path d="M 624.64 917.5827983829682 l 37.87752667515434 80.18486748117107" stroke="#fff" stroke-width="10"/><circle cx="624.64" cy="917.5827983829682" r="6" fill="#132035"/><text x="584.7040000000001" y="1036.4153401886538" font-size="30.15154045815901" text-anchor="middle" fill="#142035">3:5</text><path d="M 839.68 1290.0430040425795 l -50.50336890020572 -72.89533407379191" stroke="#fff" stroke-width="10"/><circle cx="839.68" cy="1290.0430040425795" r="6" fill="#132035"/><text x="716.8" y="1265.212323665272" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:5</text><text x="716.8000000000001" y="1112.6810013475265" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">3</text><path d="M 610.3827983829683 1236.8344032340635 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="716.8000000000001" y="999.1693196226926" font-size="28.377920431208477" text-anchor="middle">d8 / F3</text></g><defs><clipPath id="face-4"><polygon points="1024,1290.0430040425795 1331.2,1822.1290121277386 1638.3999999999999,1290.0430040425795"/></clipPath></defs><g clip-path="url(#face-4)"><polygon points="1024,1290.0430040425795 1331.2,1822.1290121277386 1638.3999999999999,1290.0430040425795" fill="url(#grid)"/><polygon points="1024,1290.0430040425795 1331.2,1822.1290121277386 1638.3999999999999,1290.0430040425795" fill="none" stroke="#162338" stroke-width="3"/><path d="M 1116.1599999999999 1449.668806468127 l 88.38089557536003 7.289533407379318" stroke="#fff" stroke-width="10"/><circle cx="1116.1599999999999" cy="1449.668806468127" r="6" fill="#132035"/><text x="1199.1039999999998" y="1543.6706678965052" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:5</text><path d="M 1546.24 1449.668806468127 l -88.38089557536003 7.28953340737931" stroke="#fff" stroke-width="10"/><circle cx="1546.24" cy="1449.668806468127" r="6" fill="#132035"/><text x="1463.2959999999998" y="1543.6706678965052" font-size="30.15154045815901" text-anchor="middle" fill="#142035">2:5</text><path d="M 1208.32 1290.0430040425795 l 50.50336890020568 72.89533407379194" stroke="#fff" stroke-width="10"/><circle cx="1208.32" cy="1290.0430040425795" r="6" fill="#132035"/><text x="1331.1999999999998" y="1314.8736844198868" font-size="30.15154045815901" text-anchor="middle" fill="#142035">0:2</text><text x="1331.1999999999998" y="1467.4050067376327" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">4</text><path d="M 1224.782798382968 1591.5584086241697 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="1331.1999999999998" y="1353.8933250127989" font-size="28.377920431208477" text-anchor="middle">d8 / F4</text></g><defs><clipPath id="face-5"><polygon points="1024,225.87098787226114 716.8000000000001,757.9569959574205 1331.2,757.9569959574205"/></clipPath></defs><g clip-path="url(#face-5)"><polygon points="1024,225.87098787226114 716.8000000000001,757.9569959574205 1331.2,757.9569959574205" fill="url(#grid)"/><polygon points="1024,225.87098787226114 716.8000000000001,757.9569959574205 1331.2,757.9569959574205" fill="none" stroke="#162338" stroke-width="3"/><path d="M 931.8399999999999 385.49679029780896 l 37.877526675154314 80.1848674811711" stroke="#fff" stroke-width="10"/><circle cx="931.8399999999999" cy="385.49679029780896" r="6" fill="#132035"/><text x="891.9040000000001" y="504.32933210349455" font-size="30.151540458159012" text-anchor="middle" fill="#142035">1:3</text><path d="M 901.12 757.9569959574205 l 50.50336890020574 -72.89533407379193" stroke="#fff" stroke-width="10"/><circle cx="901.12" cy="757.9569959574205" r="6" fill="#132035"/><text x="1024" y="733.1263155801131" font-size="30.151540458159012" text-anchor="middle" fill="#142035">3:4</text><path d="M 1116.16 385.49679029780896 l -37.877526675154314 80.1848674811711" stroke="#fff" stroke-width="10"/><circle cx="1116.16" cy="385.49679029780896" r="6" fill="#132035"/><text x="1156.096" y="504.32933210349455" font-size="30.151540458159012" text-anchor="middle" fill="#142035">1:4</text><text x="1024" y="580.5949932623674" font-size="177.362002695053" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">5</text><path d="M 917.5827983829682 704.7483951489046 h 212.83440323406361 l -35.4724005390106 -24.830680377307424 m 35.4724005390106 24.830680377307424 l -35.4724005390106 24.830680377307424" fill="none" stroke="#142035" stroke-width="3"/><text x="1024" y="467.0833115375335" font-size="28.37792043120848" text-anchor="middle">d8 / F5</text></g><defs><clipPath id="face-6"><polygon points="1945.6000000000001,757.9569959574203 1331.2,757.9569959574203 1638.3999999999999,1290.0430040425795"/></clipPath></defs><g clip-path="url(#face-6)"><polygon points="1945.6000000000001,757.9569959574203 1331.2,757.9569959574203 1638.3999999999999,1290.0430040425795" fill="url(#grid)"/><polygon points="1945.6000000000001,757.9569959574203 1331.2,757.9569959574203 1638.3999999999999,1290.0430040425795" fill="none" stroke="#162338" stroke-width="3"/><path d="M 1761.2800000000002 757.9569959574203 l -50.50336890020583 72.89533407379184" stroke="#fff" stroke-width="10"/><circle cx="1761.2800000000002" cy="757.9569959574203" r="6" fill="#132035"/><text x="1638.4" y="782.7876763347278" font-size="30.15154045815901" text-anchor="middle" fill="#142035">1:4</text><path d="M 1546.24 1130.4172016170317 l 37.87752667515427 -80.18486748117111" stroke="#fff" stroke-width="10"/><circle cx="1546.24" cy="1130.4172016170317" r="6" fill="#132035"/><text x="1506.3039999999999" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">2:4</text><path d="M 1853.44 917.5827983829681 l -88.38089557536004 7.289533407379172" stroke="#fff" stroke-width="10"/><circle cx="1853.44" cy="917.5827983829681" r="6" fill="#132035"/><text x="1770.4959999999999" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">1:2</text><text x="1638.3999999999999" y="935.3189986524734" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">6</text><path d="M 1531.982798382968 1059.4724005390106 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="1638.3999999999999" y="821.8073169276395" font-size="28.377920431208477" text-anchor="middle">d8 / F6</text></g><defs><clipPath id="face-7"><polygon points="1945.6000000000001,1822.1290121277386 1638.3999999999999,1290.0430040425795 1331.2,1822.1290121277386"/></clipPath></defs><g clip-path="url(#face-7)"><polygon points="1945.6000000000001,1822.1290121277386 1638.3999999999999,1290.0430040425795 1331.2,1822.1290121277386" fill="url(#grid)"/><polygon points="1945.6000000000001,1822.1290121277386 1638.3999999999999,1290.0430040425795 1331.2,1822.1290121277386" fill="none" stroke="#162338" stroke-width="3"/><path d="M 1853.44 1662.5032097021908 l -88.38089557536004 -7.289533407379125" stroke="#fff" stroke-width="10"/><circle cx="1853.44" cy="1662.5032097021908" r="6" fill="#132035"/><text x="1770.4959999999999" y="1568.5013482738127" font-size="30.151540458159005" text-anchor="middle" fill="#142035">1:2</text><path d="M 1546.2399999999998 1449.668806468127 l 37.877526675154286 80.18486748117108" stroke="#fff" stroke-width="10"/><circle cx="1546.2399999999998" cy="1449.668806468127" r="6" fill="#132035"/><text x="1506.3039999999999" y="1568.5013482738127" font-size="30.151540458159005" text-anchor="middle" fill="#142035">2:5</text><path d="M 1761.2800000000002 1822.1290121277386 l -50.503368900205835 -72.89533407379182" stroke="#fff" stroke-width="10"/><circle cx="1761.2800000000002" cy="1822.1290121277386" r="6" fill="#132035"/><text x="1638.4" y="1797.2983317504313" font-size="30.151540458159005" text-anchor="middle" fill="#142035">1:5</text><text x="1638.3999999999999" y="1644.7670094326857" font-size="177.36200269505295" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">7</text><path d="M 1531.9827983829682 1768.9204113192227 h 212.83440323406353 l -35.47240053901059 -24.830680377307417 m 35.47240053901059 24.830680377307417 l -35.47240053901059 24.830680377307417" fill="none" stroke="#142035" stroke-width="3"/><text x="1638.3999999999999" y="1531.2553277078518" font-size="28.377920431208473" text-anchor="middle">d8 / F7</text></g><defs><clipPath id="face-8"><polygon points="102.39999999999992,757.9569959574205 409.59999999999997,1290.0430040425795 716.8000000000001,757.9569959574205"/></clipPath></defs><g clip-path="url(#face-8)"><polygon points="102.39999999999992,757.9569959574205 409.59999999999997,1290.0430040425795 716.8000000000001,757.9569959574205" fill="url(#grid)"/><polygon points="102.39999999999992,757.9569959574205 409.59999999999997,1290.0430040425795 716.8000000000001,757.9569959574205" fill="none" stroke="#162338" stroke-width="3"/><path d="M 194.55999999999992 917.5827983829682 l 88.38089557536006 7.289533407379178" stroke="#fff" stroke-width="10"/><circle cx="194.55999999999992" cy="917.5827983829682" r="6" fill="#132035"/><text x="277.50399999999996" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">1:5</text><path d="M 624.64 917.5827983829683 l -88.38089557536006 7.289533407379131" stroke="#fff" stroke-width="10"/><circle cx="624.64" cy="917.5827983829683" r="6" fill="#132035"/><text x="541.696" y="1011.5846598113462" font-size="30.15154045815901" text-anchor="middle" fill="#142035">3:5</text><path d="M 286.71999999999997 757.9569959574205 l 50.50336890020576 72.89533407379189" stroke="#fff" stroke-width="10"/><circle cx="286.71999999999997" cy="757.9569959574205" r="6" fill="#132035"/><text x="409.6" y="782.7876763347278" font-size="30.15154045815901" text-anchor="middle" fill="#142035">1:3</text><text x="409.59999999999997" y="935.3189986524735" font-size="177.36200269505298" font-family="sans-serif" font-weight="bold" text-anchor="middle" dominant-baseline="central" fill="#101a2d" stroke="#fff" stroke-width="1">8</text><path d="M 303.1827983829682 1059.4724005390106 h 212.83440323406356 l -35.4724005390106 -24.83068037730742 m 35.4724005390106 24.83068037730742 l -35.4724005390106 24.83068037730742" fill="none" stroke="#142035" stroke-width="3"/><text x="409.59999999999997" y="821.8073169276396" font-size="28.377920431208477" text-anchor="middle">d8 / F8</text></g></svg>

package/dist/asset-registry.d.ts

@@ -1,4 +1,4 @@
-import type { AudioBankDefinition, AudioSpriteManifest, DiceAssetCatalogManifest, DiceFaceAtlasDefinition, DiceMaterialDefinition, DicePatternDefinition, DiceSkinDefinition } from './types.js';
+import type { AudioBankDefinition, AudioSpriteManifest, DiceAssetCatalogManifest, DiceFaceAtlasDefinition, DiceMaterialDefinition, DicePatternDefinition, DiceSkinDefinition, DiceSkinSetDefinition } from './types.js';
 export interface RegisterDiceAssetOptions {
     readonly replace?: boolean;
 }
@@ -20,6 +20,7 @@ export declare class DiceAssetRegistry {
     readonly materials: AssetRegistry<DiceMaterialDefinition>;
     readonly patterns: AssetRegistry<DicePatternDefinition>;
     readonly skins: AssetRegistry<DiceSkinDefinition>;
+    readonly skinSets: AssetRegistry<DiceSkinSetDefinition>;
     readonly faces: AssetRegistry<DiceFaceAtlasDefinition>;
     get revision(): number;
     registerCatalog(catalog: DiceAssetCatalogManifest): void;

package/dist/asset-registry.js

@@ -60,6 +60,7 @@ export class DiceAssetRegistry {
     materials = new AssetRegistry(validateMaterial);
     patterns = new AssetRegistry(validatePattern);
     skins = new AssetRegistry(validateSkin);
+    skinSets = new AssetRegistry(validateSkinSet);
     faces = new AssetRegistry(validateFaceAtlas);
     get revision() {
         return (this.audio.revision +
@@ -67,6 +68,7 @@ export class DiceAssetRegistry {
             this.materials.revision +
             this.patterns.revision +
             this.skins.revision +
+            this.skinSets.revision +
             this.faces.revision);
     }
     registerCatalog(catalog) {
@@ -84,9 +86,17 @@ export class DiceAssetRegistry {
             this.faces.register(asset);
         for (const asset of catalog.skins ?? [])
             this.skins.register(asset);
+        for (const asset of catalog.skinSets ?? [])
+            this.skinSets.register(asset);
         this.validateReferences();
     }
     validateReferences() {
+        for (const set of this.skinSets.list()) {
+            for (const [dieType, skinId] of Object.entries(set.skins)) {
+                if (!this.skins.has(skinId))
+                    throw new Error(`Skin set "${set.id}" ${dieType} references missing skin "${skinId}"`);
+            }
+        }
         for (const bank of this.audioBanks.list()) {
             const sprite = this.audio.get(bank.spriteId);
             if (sprite === undefined)
@@ -177,6 +187,25 @@ function validateMaterial(material) {
     }
 }
 function validatePattern(pattern) {
+    if (pattern.unwrap !== undefined) {
+        assertId(pattern.unwrap.geometryId);
+        if (pattern.repeat !== undefined)
+            throw new RangeError('unwrapped patterns cannot repeat');
+        if (Object.keys(pattern.unwrap.faces).length === 0)
+            throw new RangeError('unwrap must contain faces');
+        for (const [face, uvs] of Object.entries(pattern.unwrap.faces)) {
+            if (!/^[1-9]\d*$/.test(face) ||
+                !Array.isArray(uvs) ||
+                uvs.length < 3 ||
+                !uvs.every((uv) => Array.isArray(uv) &&
+                    uv.length === 2 &&
+                    uv.every((value) => Number.isFinite(value) && value >= 0 && value <= 1))) {
+                throw new RangeError(`Pattern "${pattern.id}" face ${face}: invalid surface UVs`);
+            }
+        }
+        if (pattern.unwrap.preview !== undefined)
+            validateReference(pattern.unwrap.preview, 'unwrap preview');
+    }
     validateTexture(pattern.baseColor, 'baseColor');
     if (pattern.normal !== undefined)
         validateTexture(pattern.normal, 'normal');
@@ -201,3 +230,11 @@ function validateFaceAtlas(atlas) {
         throw new RangeError('face atlas dimensions must be positive integers');
     }
 }
+function validateSkinSet(set) {
+    if (Object.keys(set.skins).length === 0)
+        throw new RangeError('skin set must contain skins');
+    for (const [dieType, skinId] of Object.entries(set.skins)) {
+        assertId(dieType);
+        assertId(skinId);
+    }
+}

package/dist/catalog-loader.js

@@ -35,6 +35,16 @@ export function resolveCatalogReferences(catalog, catalogUri) {
                 patterns: catalog.patterns.map((pattern) => ({
                     ...pattern,
                     baseColor: resolveReference(pattern.baseColor),
+                    ...(pattern.unwrap === undefined
+                        ? {}
+                        : {
+                            unwrap: {
+                                ...pattern.unwrap,
+                                ...(pattern.unwrap.preview === undefined
+                                    ? {}
+                                    : { preview: resolveReference(pattern.unwrap.preview) }),
+                            },
+                        }),
                     ...(pattern.normal === undefined ? {} : { normal: resolveReference(pattern.normal) }),
                     ...(pattern.orm === undefined ? {} : { orm: resolveReference(pattern.orm) }),
                 })),
@@ -69,7 +79,15 @@ function isCatalogManifest(source) {
         return false;
     if (source.schemaVersion !== 1)
         return false;
-    for (const key of ['audioSprites', 'audioBanks', 'materials', 'patterns', 'skins', 'faces']) {
+    for (const key of [
+        'audioSprites',
+        'audioBanks',
+        'materials',
+        'patterns',
+        'skins',
+        'faces',
+        'skinSets',
+    ]) {
         if (source[key] !== undefined && !Array.isArray(source[key]))
             return false;
     }

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { resolveImpactGain, WebAudioSpritePlayer, type AudioBufferSourceNodeLike
 export { ThreeAssetMaterialProvider, type ThreeAssetMaterialProviderOptions, } from './three-material-provider.js';
 export { DiceAssetCatalogLoader, parseCatalog, resolveCatalogReferences, type DiceAssetCatalogLoaderOptions, } from './catalog-loader.js';
 export { ImpactSoundGate, type SoundCollisionEvent, type SoundImpactEvent, } from './impact-sound-gate.js';
-export type { AudioBankDefinition, AudioBankKind, AudioSpriteClip, AudioSpriteManifest, DiceAssetCatalogManifest, DiceAssetMetadataValue, DiceAssetReference, DiceFaceAtlasDefinition, DiceFaceRegion, DiceMaterialDefinition, DicePatternDefinition, DiceSkinCompositeMode, DiceSkinDefinition, RuntimeTextureReference, } from './types.js';
+export type { AudioBankDefinition, AudioBankKind, AudioSpriteClip, AudioSpriteManifest, DiceAssetCatalogManifest, DiceAssetMetadataValue, DiceAssetReference, DiceFaceAtlasDefinition, DiceFaceRegion, DiceMaterialDefinition, DicePatternDefinition, DiceSkinCompositeMode, DiceSkinDefinition, DiceSkinSetDefinition, DiceSurfaceUnwrap, RuntimeTextureReference, } from './types.js';
+export { prepareTexturedSkinSet, type PreparedTexturedSkinSet, type PrepareTexturedSkinSetOptions, type TexturedSkinSetTarget, type TexturedSkinSetProvider, type TexturedSkinSetSelectionContext, } from './textured-skin-set.js';

package/dist/index.js

@@ -3,3 +3,4 @@ export { resolveImpactGain, WebAudioSpritePlayer, } from './web-audio-player.js'
 export { ThreeAssetMaterialProvider, } from './three-material-provider.js';
 export { DiceAssetCatalogLoader, parseCatalog, resolveCatalogReferences, } from './catalog-loader.js';
 export { ImpactSoundGate, } from './impact-sound-gate.js';
+export { prepareTexturedSkinSet, } from './textured-skin-set.js';

package/dist/textured-skin-set.d.ts

@@ -0,0 +1,32 @@
+import type { VisualPresetDescriptor } from '@dice-o-rolla/dice-renderer';
+import type { DiceAssetRegistry } from './asset-registry.js';
+export interface TexturedSkinSetTarget {
+    registerVisualPreset(preset: VisualPresetDescriptor): VisualPresetDescriptor;
+    unregisterVisualPreset(id: string): boolean;
+}
+export interface TexturedSkinSetProvider {
+    readonly registry: DiceAssetRegistry;
+    prepareSkin(id: string): Promise<void>;
+}
+export interface PrepareTexturedSkinSetOptions {
+    readonly registry: DiceAssetRegistry;
+    readonly provider: TexturedSkinSetProvider;
+    readonly skinSetId: string;
+    readonly presetPrefix?: string;
+    readonly soundPackId?: string;
+}
+export interface TexturedSkinSetSelectionContext {
+    readonly physicalDieType: string;
+    readonly component?: {
+        readonly role: string;
+        readonly groupType: string;
+    };
+}
+export interface PreparedTexturedSkinSet {
+    readonly presets: readonly VisualPresetDescriptor[];
+    /** Register without changing defaults. Repeated registration through this API is idempotent. */
+    register(engine: TexturedSkinSetTarget): void;
+    readonly visualPresetSelector: (context: TexturedSkinSetSelectionContext) => string | undefined;
+}
+/** Validate and load first; engine registration is an explicit, separate operation. */
+export declare function prepareTexturedSkinSet(options: PrepareTexturedSkinSetOptions): Promise<PreparedTexturedSkinSet>;

package/dist/textured-skin-set.js

@@ -0,0 +1,115 @@
+import { getDieGeometry } from '@dice-o-rolla/dice-geometry';
+import { validateSurfaceUvs } from '@dice-o-rolla/dice-renderer-three';
+const registrations = new WeakMap();
+const geometries = {
+    d4: 'd4',
+    d6: 'd6',
+    d8: 'd8',
+    d10: 'd10',
+    d12: 'd12',
+    d20: 'd20',
+    d100: 'd10',
+    d66: 'd6',
+};
+const identifier = /^[a-z0-9][a-z0-9._:-]*$/i;
+/** Validate and load first; engine registration is an explicit, separate operation. */
+export async function prepareTexturedSkinSet(options) {
+    const { registry, provider, skinSetId } = options;
+    if (provider.registry !== registry)
+        throw new Error('The material provider must use the supplied asset registry');
+    registry.validateReferences();
+    const set = registry.skinSets.get(skinSetId);
+    if (set === undefined)
+        throw new Error(`Unknown skin set: ${skinSetId}`);
+    const prefix = options.presetPrefix ?? `skin-set:${skinSetId}`;
+    if (!identifier.test(prefix) ||
+        (options.soundPackId !== undefined && !identifier.test(options.soundPackId)))
+        throw new RangeError('Preset prefix and sound pack id must be portable identifiers');
+    const entries = Object.entries(set.skins).map(([type, skinId]) => {
+        const geometryId = Object.hasOwn(geometries, type) ? geometries[type] : undefined;
+        if (geometryId === undefined)
+            throw new Error(`Skin set "${skinSetId}" has unsupported type "${type}"`);
+        const skin = registry.skins.get(skinId);
+        const pattern = registry.patterns.get(skin.patternId);
+        if (pattern.unwrap?.geometryId !== geometryId)
+            throw new Error(`Skin "${skinId}" for ${type} requires an unwrap for ${geometryId}`);
+        try {
+            validateSurfaceUvs(getDieGeometry(geometryId), pattern.unwrap.faces);
+        }
+        catch (error) {
+            throw new Error(`Skin "${skinId}": ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+        const preset = Object.freeze({
+            id: `${prefix}:${type}`,
+            dieType: geometryId,
+            geometryId,
+            skinId,
+            ...(options.soundPackId === undefined ? {} : { soundPackId: options.soundPackId }),
+        });
+        return {
+            type,
+            skinId,
+            preset,
+            fingerprint: canonical({
+                preset,
+                skin,
+                pattern,
+                material: registry.materials.get(skin.materialId),
+                atlas: skin.faceAtlasId === undefined ? null : registry.faces.get(skin.faceAtlasId),
+            }),
+        };
+    });
+    await Promise.all([...new Set(entries.map((entry) => entry.skinId))].map((id) => provider.prepareSkin(id)));
+    const byType = new Map(entries.map((entry) => [entry.type, entry.preset.id]));
+    return Object.freeze({
+        presets: Object.freeze(entries.map((entry) => entry.preset)),
+        register(engine) {
+            const known = registrations.get(engine) ?? new Map();
+            for (const entry of entries) {
+                const previous = known.get(entry.preset.id);
+                if (previous !== undefined && previous !== entry.fingerprint)
+                    throw new Error(`Conflicting preset: ${entry.preset.id}`);
+            }
+            const added = [];
+            try {
+                for (const entry of entries) {
+                    if (known.has(entry.preset.id))
+                        continue;
+                    engine.registerVisualPreset(entry.preset);
+                    added.push(entry.preset.id);
+                    known.set(entry.preset.id, entry.fingerprint);
+                }
+            }
+            catch (error) {
+                const rollbackErrors = [];
+                for (const id of added.toReversed()) {
+                    try {
+                        engine.unregisterVisualPreset(id);
+                        known.delete(id);
+                    }
+                    catch (rollbackError) {
+                        rollbackErrors.push(rollbackError);
+                    }
+                }
+                registrations.set(engine, known);
+                if (rollbackErrors.length > 0)
+                    throw new AggregateError([error, ...rollbackErrors], 'Preset registration and rollback failed', { cause: error });
+                throw error;
+            }
+            registrations.set(engine, known);
+        },
+        visualPresetSelector(context) {
+            return byType.get(context.component?.role === 'tens' ? context.component.groupType : context.physicalDieType);
+        },
+    });
+}
+function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    if (value !== null && typeof value === 'object')
+        return `{${Object.entries(value)
+            .toSorted(([a], [b]) => a.localeCompare(b))
+            .map(([key, child]) => `${JSON.stringify(key)}:${canonical(child)}`)
+            .join(',')}}`;
+    return JSON.stringify(value) ?? 'null';
+}

package/dist/three-material-provider.d.ts

@@ -10,6 +10,7 @@ export declare class ThreeAssetMaterialProvider implements ThreeFaceMaterialProv
     #private;
     readonly registry: DiceAssetRegistry;
     constructor(registry: DiceAssetRegistry, options: ThreeAssetMaterialProviderOptions);
+    getSurfaceUvs(...[definition, preset]: Parameters<NonNullable<ThreeFaceMaterialProvider['getSurfaceUvs']>>): Readonly<Record<number, readonly (readonly [u: number, v: number])[]>> | undefined;
     prepareSkin(skinId: string): Promise<void>;
     createFace(context: FaceMaterialContext): FaceMaterialResource;
     dispose(): void;

package/dist/three-material-provider.js

@@ -1,5 +1,5 @@
-import { ThreeMaterialFactory, } from '@dice-o-rolla/dice-renderer-three';
-import { Color, MeshPhysicalMaterial, RepeatWrapping, SRGBColorSpace, } from 'three';
+import { validateSurfaceUvs, ThreeMaterialFactory, } from '@dice-o-rolla/dice-renderer-three';
+import { Color, ClampToEdgeWrapping, MeshPhysicalMaterial, RepeatWrapping, SRGBColorSpace, } from 'three';
 import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader.js';
 /** KTX2-backed PBR adapter; lower-level renderer packages remain asset-schema agnostic. */
 export class ThreeAssetMaterialProvider {
@@ -8,13 +8,33 @@ export class ThreeAssetMaterialProvider {
     #textures = new Map();
     #skins = new Map();
     #fallback = new ThreeMaterialFactory();
+    #disposed = false;
     constructor(registry, options) {
         this.registry = registry;
         this.#loader = new KTX2Loader()
             .setTranscoderPath(options.transcoderPath)
             .detectSupport(options.renderer);
     }
+    getSurfaceUvs(...[definition, preset]) {
+        const skin = preset?.skinId === undefined ? undefined : this.registry.skins.get(preset.skinId);
+        if (skin === undefined)
+            return undefined;
+        const unwrap = this.registry.patterns.get(skin.patternId)?.unwrap;
+        if (unwrap === undefined)
+            return undefined;
+        if (unwrap.geometryId !== definition.id)
+            throw new RangeError(`Skin "${skin.id}" requires geometry "${unwrap.geometryId}", received "${definition.id}"`);
+        try {
+            validateSurfaceUvs(definition, unwrap.faces);
+        }
+        catch (error) {
+            throw new RangeError(`Skin "${skin.id}": ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return unwrap.faces;
+    }
     async prepareSkin(skinId) {
+        if (this.#disposed)
+            throw new Error('Asset material provider is disposed');
         if (this.#skins.has(skinId))
             return;
         this.registry.validateReferences();
@@ -24,16 +44,15 @@ export class ThreeAssetMaterialProvider {
         const pattern = this.registry.patterns.get(skin.patternId);
         const atlas = skin.faceAtlasId === undefined ? undefined : this.registry.faces.get(skin.faceAtlasId);
         const [baseColor, normal, orm, faces] = await Promise.all([
-            this.#load(pattern.baseColor),
-            pattern.normal === undefined ? undefined : this.#load(pattern.normal),
-            pattern.orm === undefined ? undefined : this.#load(pattern.orm),
+            this.#load(pattern.baseColor, pattern.unwrap !== undefined),
+            pattern.normal === undefined
+                ? undefined
+                : this.#load(pattern.normal, pattern.unwrap !== undefined),
+            pattern.orm === undefined ? undefined : this.#load(pattern.orm, pattern.unwrap !== undefined),
             atlas === undefined ? undefined : this.#load(atlas.texture),
         ]);
-        baseColor.wrapS = baseColor.wrapT = RepeatWrapping;
-        if (normal !== undefined)
-            normal.wrapS = normal.wrapT = RepeatWrapping;
-        if (orm !== undefined)
-            orm.wrapS = orm.wrapT = RepeatWrapping;
+        if (this.#disposed)
+            throw new Error('Asset material provider is disposed');
         this.#skins.set(skinId, {
             skin,
             baseColor,
@@ -70,7 +89,7 @@ export class ThreeAssetMaterialProvider {
         if (definition.normalScale !== undefined)
             material.normalScale.setScalar(definition.normalScale);
         if (loaded.faces !== undefined && region !== undefined && atlas !== undefined) {
-            configureCompositingShader(material, loaded.faces, region, atlas.width, atlas.height, loaded.skin);
+            configureCompositingShader(material, loaded.faces, region, atlas.width, atlas.height, loaded.skin, loaded.baseColor.channel === 1);
         }
         return {
             material,
@@ -80,23 +99,41 @@ export class ThreeAssetMaterialProvider {
         };
     }
     dispose() {
-        for (const pending of this.#textures.values())
-            void pending.then((texture) => texture.dispose());
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        const pending = [...this.#textures.values()];
+        for (const texture of pending)
+            void texture.then((value) => value.dispose(), () => undefined);
         this.#textures.clear();
         this.#skins.clear();
-        this.#loader.dispose();
+        // Let active transcodes settle before terminating their workers.
+        void Promise.allSettled(pending).then(() => this.#loader.dispose());
     }
-    #load(reference) {
-        const existing = this.#textures.get(reference.uri);
+    #load(reference, surface = false) {
+        const key = `${reference.uri}:${reference.colorSpace}:${surface}`;
+        const existing = this.#textures.get(key);
         if (existing !== undefined)
             return existing;
-        const pending = this.#loader.loadAsync(reference.uri).then((texture) => {
+        const pending = this.#loader
+            .loadAsync(reference.uri)
+            .then((texture) => {
+            if (this.#disposed) {
+                texture.dispose();
+                throw new Error('Asset material provider is disposed');
+            }
             texture.colorSpace = reference.colorSpace === 'srgb' ? SRGBColorSpace : '';
+            texture.channel = surface ? 1 : 0;
+            texture.wrapS = texture.wrapT = surface ? ClampToEdgeWrapping : RepeatWrapping;
             texture.generateMipmaps = false;
             texture.needsUpdate = true;
             return texture;
+        })
+            .catch((error) => {
+            this.#textures.delete(key);
+            throw new Error(`Texture "${reference.uri}": ${error instanceof Error ? error.message : 'load failed'}`, { cause: error });
         });
-        this.#textures.set(reference.uri, pending);
+        this.#textures.set(key, pending);
         return pending;
     }
     #createFallback(context) {
@@ -110,7 +147,7 @@ export class ThreeAssetMaterialProvider {
         };
     }
 }
-function configureCompositingShader(material, atlas, region, width, height, skin) {
+function configureCompositingShader(material, atlas, region, width, height, skin, surface) {
     const labelColor = new Color(skin.labelColor ?? '#111111');
     material.onBeforeCompile = (shader) => {
         shader.uniforms.faceAtlas = { value: atlas };
@@ -124,9 +161,13 @@ function configureCompositingShader(material, atlas, region, width, height, skin
         shader.uniforms.compositeMode = {
             value: skin.composite === 'overlay' ? 2 : skin.composite === 'multiply' ? 1 : 0,
         };
+        shader.vertexShader = shader.vertexShader
+            .replace('#include <common>', '#include <common>\nvarying vec2 diceLabelUv;')
+            .replace('#include <uv_vertex>', '#include <uv_vertex>\ndiceLabelUv = uv;');
         shader.fragmentShader = shader.fragmentShader
+            .replace('#include <common>', '#include <common>\nvarying vec2 diceLabelUv;')
             .replace('#include <map_pars_fragment>', `#include <map_pars_fragment>\nuniform sampler2D faceAtlas;\nuniform vec4 faceRect;\nuniform vec3 labelColor;\nuniform float skinHue;\nuniform float skinSaturation;\nuniform vec2 patternScale;\nuniform int compositeMode;`)
-            .replace('#include <map_fragment>', `#ifdef USE_MAP\nvec4 skinPattern = texture2D(map, fract(vMapUv * patternScale));\nvec3 skinTint = diffuseColor.rgb;\nif (compositeMode == 0) diffuseColor.rgb = mix(skinTint, skinPattern.rgb, skinPattern.a);\nelse if (compositeMode == 1) diffuseColor.rgb = skinTint * skinPattern.rgb;\nelse { vec3 low = 2.0 * skinTint * skinPattern.rgb; vec3 high = 1.0 - 2.0 * (1.0 - skinTint) * (1.0 - skinPattern.rgb); diffuseColor.rgb = mix(low, high, step(vec3(0.5), skinTint)); }\ndiffuseColor.a *= skinPattern.a;\n#endif\nvec3 skinGray = vec3(dot(diffuseColor.rgb, vec3(0.2126, 0.7152, 0.0722)));\ndiffuseColor.rgb = mix(skinGray, diffuseColor.rgb, skinSaturation);\nfloat skinAngle = skinHue * 6.28318530718;\nvec3 skinAxis = normalize(vec3(1.0));\ndiffuseColor.rgb = diffuseColor.rgb * cos(skinAngle) + cross(skinAxis, diffuseColor.rgb) * sin(skinAngle) + skinAxis * dot(skinAxis, diffuseColor.rgb) * (1.0 - cos(skinAngle));\nvec2 faceUv = faceRect.xy + vMapUv * faceRect.zw;\nfloat faceMask = texture2D(faceAtlas, faceUv).a;\ndiffuseColor.rgb = mix(diffuseColor.rgb, labelColor, faceMask);`);
+            .replace('#include <map_fragment>', `#ifdef USE_MAP\nvec4 skinPattern = texture2D(map, ${surface ? 'vMapUv' : 'fract(vMapUv * patternScale)'});\nvec3 skinTint = diffuseColor.rgb;\nif (compositeMode == 0) diffuseColor.rgb = mix(skinTint, skinPattern.rgb, skinPattern.a);\nelse if (compositeMode == 1) diffuseColor.rgb = skinTint * skinPattern.rgb;\nelse { vec3 low = 2.0 * skinTint * skinPattern.rgb; vec3 high = 1.0 - 2.0 * (1.0 - skinTint) * (1.0 - skinPattern.rgb); diffuseColor.rgb = mix(low, high, step(vec3(0.5), skinTint)); }\ndiffuseColor.a *= skinPattern.a;\n#endif\nvec3 skinGray = vec3(dot(diffuseColor.rgb, vec3(0.2126, 0.7152, 0.0722)));\ndiffuseColor.rgb = mix(skinGray, diffuseColor.rgb, skinSaturation);\nfloat skinAngle = skinHue * 6.28318530718;\nvec3 skinAxis = normalize(vec3(1.0));\ndiffuseColor.rgb = diffuseColor.rgb * cos(skinAngle) + cross(skinAxis, diffuseColor.rgb) * sin(skinAngle) + skinAxis * dot(skinAxis, diffuseColor.rgb) * (1.0 - cos(skinAngle));\nvec2 faceUv = faceRect.xy + diceLabelUv * faceRect.zw;\nfloat faceMask = texture2D(faceAtlas, faceUv).a;\ndiffuseColor.rgb = mix(diffuseColor.rgb, labelColor, faceMask);`);
     };
     material.customProgramCacheKey = () => `dice-skin:${skin.id}`;
 }

package/dist/tools/build.d.ts

@@ -0,0 +1,2 @@
+import type { BuildTexturedSkinSetOptions, BuiltTexturedSkinSet } from './types.js';
+export declare function buildTexturedSkinSet(options: BuildTexturedSkinSetOptions): Promise<BuiltTexturedSkinSet>;