@bitefoundry/retrieviewer 0.0.9 → 0.0.11

package/pet-q5-manifest.json

@@ -77,36 +77,72 @@
    "width": 320,
    "height": 320,
    "frames": 162,
-   "uniqueFrames": 142,
+   "uniqueFrames": 126,
    "sourceSha256": "7918261fb64c57a91739729841fd84c6dd53891196c7fb76ee9c27712ab6ef5d",
    "sourcePackedSha256": "7785ef65b8a2a5bf6f7ce600fe9957a60d9af82066ff49275bba061eac5392d1",
-   "encodedBytes": 6227235,
-   "gzipBytes": 1426084,
-   "residentPixelBytes": 3871386,
-   "encodedSha256": "783eafb78fac8e004efd4d44c88776ba6cb486ed18092738a4aaf74a6906b8ed",
-   "quantizedSha256": "f2d89ac5f6fb230b4d5ac6bcf09865185a00900947dbbfc7cbacc40f8f9719b6",
+   "encodedBytes": 5797825,
+   "gzipBytes": 1270759,
+   "residentPixelBytes": 3605128,
+   "encodedSha256": "cb045558ca490436c5d6703f6468daba26f20ed76bc886e829787889253ccbb9",
+   "quantizedSha256": "eb5007588c9f1843a9279fa21ee701e0f1ac3238d2dda70cc8e8c0c900e3c34b",
    "watchRegistration": {
-    "sourceVersion": "0.0.5",
-    "sourceEncodedSha256": "38cfdfcee9c857c56a14f0a9734cb3301b4a04cb8e1ae3fb2e2b2ffe3666240f",
-    "canonicalSeat": 50,
-    "method": "single-source-torso-envelope-and-paw-registration",
-    "protectedFaceRows": 180,
-    "torsoWarpStartY": 180,
-    "torsoEnvelopeFullY": [
-     205,
-     265
+    "sourceSize": [
+     1619,
+     972
     ],
-    "pawWarpFullFromY": 275,
-    "groundRow": 300,
-    "headTranslateY": 0,
-    "neckConnected": true,
+    "scale": 0.7627737226277372,
+    "dx": 24.607664233576628,
+    "dy": 66.82846715328466,
+    "wholeBodyArt": true,
     "bodyCompositing": false,
-    "paws": [
-     105,
-     138,
-     185,
-     218
+    "collarMatte": false,
+    "nonlinearWarp": false,
+    "perKeyScale": false,
+    "runtimeCompositing": false,
+    "pixelBlending": false,
+    "sourceKeys": [
+     7,
+     8,
+     9,
+     10,
+     11,
+     11,
+     12,
+     13,
+     14,
+     14,
+     13,
+     12,
+     11,
+     11,
+     10,
+     9,
+     8,
+     7,
+     7,
+     6,
+     5,
+     4,
+     3,
+     3,
+     2,
+     1,
+     0,
+     0,
+     1,
+     2,
+     3,
+     3,
+     4,
+     5,
+     6,
+     7
     ],
+    "keys": 15,
+    "frames": 36,
+    "sourceSheetSha256": "34b9bbca507f82c739c39e4b42e2390202863189d6d1b5e6e8ca7293555e19d3",
+    "canonicalSeat": 50,
+    "method": "authored-whole-body-connected-weight-transfer",
     "unchangedOtherFrames": true
    }
   },

package/puppy-comfort-sprites.mjs

@@ -1,5 +1,18 @@
 import {grayFrameReader,isGrayFrameSource} from './puppy-frame-store.mjs';
 
+export function comfortMotionKey(progress,motion){
+ if(!Number.isFinite(progress)||progress<0||progress>1)throw Error('Invalid motion progress');
+ const age=progress*motion.duration;let key=0;
+ while(key<motion.times.length-1&&age>=motion.times[key+1])key++;
+ return key;
+}
+export function comfortMotion(pose,info){return pose?.clip==='scramble'?info.scramble:pose?.clip==='pickup'?info.pickups?.[pose.view]:pose?.clip==='carry-trot'?info.carryTrot:pose?.clip==='carry-settle'?info.carryTrot?.settle:null;}
+function validateMotion(motion,count){
+ if(!motion||!Array.isArray(motion.frames)||!Array.isArray(motion.times)||motion.frames.length<2||motion.frames.length>32||motion.frames.length!==motion.times.length||motion.times[0]!==0||!Number.isFinite(motion.duration)||motion.duration<=0||motion.duration>3||(motion.cyclic?motion.times.at(-1)>=motion.duration:motion.times.at(-1)!==motion.duration)||motion.frames.some(i=>!Number.isInteger(i)||i<0||i>=count)||motion.times.some((t,i)=>!Number.isFinite(t)||(i&&t<=motion.times[i-1])))throw Error('Invalid fetch motion metadata');
+ if(!Array.isArray(motion.floorOffsets)||motion.floorOffsets.length!==motion.frames.length||motion.floorOffsets.some(v=>!Number.isFinite(v)||Math.abs(v)>64))throw Error('Invalid fetch floor metadata');
+ if(motion.mouth&&(!Array.isArray(motion.mouth)||motion.mouth.length!==motion.frames.length||motion.mouth.some(p=>!Array.isArray(p)||p.length!==2||p.some(v=>!Number.isFinite(v)||v<0||v>320))))throw Error('Invalid fetch mouth metadata');
+}
+
 // A handful of authored keys, not an expanded 30fps film or a live image morph.
 // First/last keys are the exact shared seated source; all keys use one scale.
 export function comfortFrameIndex(progress,info){
@@ -13,14 +26,24 @@ export function comfortFrameIndex(progress,info){
 }
 
 export function createComfortSpriteSampler(bytes,info,output){
- if(!isGrayFrameSource(bytes)||![1,2].includes(info?.version)||info.width!==320||info.height!==320||info.frames!==(info.version===2?13:9))throw Error('Invalid comfort sprites');
+ if(!isGrayFrameSource(bytes)||![1,2,3,4,5,6].includes(info?.version)||info.width!==320||info.height!==320||(info.version>=4?(!Number.isInteger(info.frames)||info.frames<19||info.frames>64):info.frames!==({1:9,2:13,3:19}[info.version])))throw Error('Invalid comfort sprites');
+ if(info.version===3){
+  const s=info.scramble;
+  if(!s||!Array.isArray(s.frames)||!Array.isArray(s.times)||s.frames.length!==7||s.times.length!==7||s.times[0]!==0||!Number.isFinite(s.duration)||s.duration<=0||s.duration>3||s.times.at(-1)!==s.duration||s.frames[0]!==s.frames.at(-1)||s.frames.some(i=>!Number.isInteger(i)||i<0||i>=info.frames)||s.times.some((t,i)=>!Number.isFinite(t)||(i&&t<=s.times[i-1])))throw Error('Invalid scramble metadata');
+ }
+ if(info.version>=4){validateMotion(info.scramble,info.frames);for(const view of ['rear','front'])validateMotion(info.pickups?.[view],info.frames);}
+ if(info.version>=6){validateMotion(info.carryTrot,info.frames);validateMotion(info.carryTrot?.settle,info.frames);if(info.carryTrot.cyclic!==true||!info.carryTrot.mouth||!info.carryTrot.settle.mouth||!Array.isArray(info.carryTrot.feet)||info.carryTrot.feet.length!==info.carryTrot.frames.length||info.carryTrot.feet.some(list=>!Array.isArray(list)||list.some(f=>typeof f.id!=='string'||typeof f.stance!=='boolean'||![f.x,f.y].every(v=>Number.isFinite(v)&&v>=0&&v<320))))throw Error('Invalid carry metadata');}
  if(output!==undefined&&(!(output instanceof Uint8ClampedArray)||output.length!==320*320*4))throw Error('Invalid comfort output');
  const frames=grayFrameReader(bytes,320,320,info.frames);let rgba=output??null;
  if(rgba)for(let i=3;i<rgba.length;i+=4)rgba[i]=255;
  return pose=>{
-  if(!['tug','sleep'].includes(pose?.clip))throw Error('Invalid comfort clip');
+  if(!['tug','sleep','scramble','pickup','carry-trot','carry-settle'].includes(pose?.clip))throw Error('Invalid comfort clip');
   if(!rgba){rgba=new Uint8ClampedArray(320*320*4);for(let i=3;i<rgba.length;i+=4)rgba[i]=255;}
-  const index=pose.clip==='sleep'?info.sleep?.[pose.variant]:comfortFrameIndex(pose.progress,info);
+  let index;
+  if(['scramble','pickup','carry-trot','carry-settle'].includes(pose.clip)){
+   const motion=comfortMotion(pose,info);if(!motion)throw Error('Invalid scramble/pickup pose');
+   index=motion.frames[comfortMotionKey(pose.progress,motion)];
+  }else index=pose.clip==='sleep'?info.sleep?.[pose.variant]:comfortFrameIndex(pose.progress,info);
   if(!Number.isInteger(index))throw Error('Invalid sleep variant');
   const frame=frames.getFrame(index),base=pose.base,blend=pose.blend??1;
   if(!Number.isFinite(blend)||blend<0||blend>1)throw Error('Invalid sleep blend');

package/puppy-companion-ball.mjs

@@ -0,0 +1,36 @@
+// Analytic ball travel in the same ground/camera as the dog. No physics engine,
+// per-frame integration drift, timer, image or growing path-history allocation.
+import {planPaperTravel} from './puppy-paper-world.mjs';
+export function createBallPath({from={x:0,z:.2},landing={x:0,z:-4},stop=landing,flight=.65,peak=.75,deceleration=.6}={}){
+ if(![from.x,from.z,landing.x,landing.z,stop.x,stop.z,flight,peak,deceleration].every(Number.isFinite)||flight<0||peak<0||deceleration<=0)throw Error('Invalid ball path');
+ from=Object.freeze({...from});landing=Object.freeze({...landing});stop=Object.freeze({...stop});
+ const dx=stop.x-landing.x,dz=stop.z-landing.z,distance=Math.hypot(dx,dz),speed=Math.sqrt(2*deceleration*distance);
+ const roll=distance?planPaperTravel(distance,{speed,startSpeed:speed,acceleration:deceleration,deceleration}):null;
+ const duration=flight+(roll?.duration??0);
+ return Object.freeze({duration,from,landing,stop,
+  at(age){
+   if(!Number.isFinite(age))throw Error('Invalid ball age');
+   const t=Math.max(0,age);
+   if(t<flight){const p=t/flight;return{x:from.x+(landing.x-from.x)*p,z:from.z+(landing.z-from.z)*p,height:4*peak*p*(1-p),spin:0,speed:0,phase:'flight',settled:false};}
+   const state=roll?.at(t-flight),ratio=distance?state.distance/distance:1;
+   return{x:landing.x+dx*ratio,z:landing.z+dz*ratio,height:0,spin:(state?.distance??0)/.035,speed:state?.speed??0,phase:t>=duration?'rest':'roll',settled:t>=duration};
+  }
+ });
+}
+
+// First throw remains the familiar clean fetch. Later throws use a seeded
+// weighted choice, no immediate repeat, and at least four throws between tumbles.
+export function createFetchPatterns(random,{canTumble=false}={}){
+ if(typeof random!=='function')throw Error('Fetch pattern RNG is required');
+ let count=0,last=null,lastTumble=-4;
+ return(allowTumble=canTumble)=>{
+  if(typeof allowTumble!=='boolean')throw Error('Invalid tumble availability');
+  count++;
+  const weights={clean:4,rolling:3,miss:2,tumble:canTumble&&allowTumble&&count>=4&&count-lastTumble>=4?.6:0};
+  if(last)weights[last]=0;
+  let pattern='clean';
+  if(count>1){let pick=random()*Object.values(weights).reduce((a,b)=>a+b,0);pattern=Object.keys(weights).find(k=>(pick-=weights[k])<0)??'clean';}
+  if(pattern==='tumble')lastTumble=count;
+  last=pattern;return pattern;
+ };
+}

package/puppy-companion-comfort.json

@@ -1,18 +1,22 @@
 {
-  "version": 2,
+  "version": 6,
   "width": 320,
   "height": 320,
-  "frames": 13,
+  "frames": 45,
   "clips": [
     "tug",
-    "sleep"
+    "sleep",
+    "scramble",
+    "pickup-rear",
+    "pickup-side",
+    "carry-trot"
   ],
-  "gzipBytes": 129148,
-  "residentPixelBytes": 341139,
+  "gzipBytes": 457052,
+  "residentPixelBytes": 1302445,
   "sourceSheetSha256": "10fde9dacca5cb45acd68f387e7ed3bcf88cd72cf0f9c4220d31d819db91731e",
   "neutralSha256": "19f89a8bcb5a937e528593a8f36db846a0d45a5ee398f1b0873c056e5be2fa0a",
-  "encodedSha256": "35327cc103b1f7ac2ff1b09ed98658fd8ff1dcef322de9c9b18071a4358b7b87",
-  "method": "Built-in imagegen authored tug keys. One fixed scale, ground/center translation only. Exact existing Q5 seat first/last. No expanded tween film or live body deformation.",
+  "encodedSha256": "f4e7604e3a581f5b610eb0f7873deee317a6e2ad0ff548106db2e64f6bead89b",
+  "method": "Approved momentum poses, single depth pursuit, exact source endpoints; one common scale per authored batch, no runtime image warp or expanded film.",
   "registration": {
     "sheetSize": [
       1774,
@@ -136,5 +140,327 @@
     "belly": "e1967d9156a119d04e25fd6428fe5dcdbd2156c5e4eba0347217847874006109",
     "curl": "10c9a85701af3587c48c1d8158972a07026e79a18a2375d86108538eda05aae7",
     "chin": "e971eaa6861b597f0dba3a487403cee5f120cba0a9f9584d831b5634d096dee7"
+  },
+  "scramble": {
+    "frames": [
+      25,
+      26,
+      27,
+      28,
+      29,
+      30,
+      31,
+      32,
+      33,
+      34,
+      35,
+      36
+    ],
+    "times": [
+      0,
+      0.035,
+      0.07,
+      0.105,
+      0.14,
+      0.19,
+      0.25,
+      0.32,
+      0.39,
+      0.48,
+      0.57,
+      0.65
+    ],
+    "duration": 0.65,
+    "floorOffsets": [
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0,
+      0
+    ],
+    "entryView": "rear",
+    "entryPhase": 0.25,
+    "trajectory": "single-pass-target",
+    "brakeSeconds": 0.19,
+    "catchSeconds": 0.29,
+    "catchSpeedRatio": 0.24,
+    "registration": {
+      "commonScale": 0.7160493827160493,
+      "commonDx": 39.580246913580254,
+      "wholeFrameFloorTranslations": true,
+      "approvedBatchScale": 0.47313240809175766,
+      "approvedBatchDx": 1.1088664421997976,
+      "approvedOriginalKeys": [
+        2,
+        4,
+        6,
+        8
+      ],
+      "perPoseScale": false,
+      "bodyCompositing": false,
+      "nonlinearWarp": false,
+      "exactSourceEndpoints": true
+    }
+  },
+  "pickups": {
+    "rear": {
+      "frames": [
+        13,
+        14,
+        15,
+        16,
+        17,
+        18
+      ],
+      "times": [
+        0,
+        0.09,
+        0.18,
+        0.28,
+        0.4,
+        0.52
+      ],
+      "duration": 0.52,
+      "floorOffsets": [
+        0,
+        2,
+        2,
+        1,
+        1,
+        0
+      ]
+    },
+    "front": {
+      "frames": [
+        19,
+        20,
+        21,
+        22,
+        23,
+        24
+      ],
+      "times": [
+        0,
+        0.09,
+        0.18,
+        0.28,
+        0.4,
+        0.52
+      ],
+      "duration": 0.52,
+      "floorOffsets": [
+        -4,
+        1,
+        1,
+        1,
+        1,
+        -4
+      ],
+      "mouth": [
+        [
+          255,
+          151
+        ],
+        [
+          250,
+          225
+        ],
+        [
+          280,
+          275
+        ],
+        [
+          274,
+          287
+        ],
+        [
+          268,
+          238
+        ],
+        [
+          255,
+          151
+        ]
+      ]
+    }
+  },
+  "sourceComfort": {
+    "ref": "9fc9628b6e42bd5da1efb02521ed4ab6e59f7763",
+    "encodedSha256": "35327cc103b1f7ac2ff1b09ed98658fd8ff1dcef322de9c9b18071a4358b7b87",
+    "frames": 13,
+    "gzipBytes": 129148
+  },
+  "approvedArtwork": "Owner-approved whole-body momentum study, 2026-10-23",
+  "sourceSheetHashes": {
+    "rear": "7beaf6a3250590563d98af860c369c91993d5aea6b7b901f368d3992d120b09b",
+    "breakdowns": "7a565ccf2aa54f38a89979826ecc7d2d77110abbcd1bfbe6ab2cb4d86093daf2"
+  },
+  "carryTrot": {
+    "frames": [
+      37,
+      38,
+      39,
+      40
+    ],
+    "times": [
+      0,
+      0.25,
+      0.5,
+      0.75
+    ],
+    "duration": 1,
+    "cyclic": true,
+    "floorOffsets": [
+      0,
+      0,
+      0,
+      0
+    ],
+    "mouth": [
+      [
+        198,
+        177
+      ],
+      [
+        197,
+        179
+      ],
+      [
+        189,
+        178
+      ],
+      [
+        190,
+        179
+      ]
+    ],
+    "registration": {
+      "commonScale": 0.6843853820598007,
+      "commonDx": 68.1594684385382,
+      "perPoseScale": false,
+      "bodyCompositing": false,
+      "wholeFrameFloorTranslation": true,
+      "selectedSourceKeys": [
+        0,
+        1,
+        2,
+        6,
+        8,
+        9,
+        10,
+        11
+      ]
+    },
+    "settle": {
+      "frames": [
+        41,
+        42,
+        43,
+        44
+      ],
+      "times": [
+        0,
+        0.07,
+        0.14,
+        0.22
+      ],
+      "duration": 0.22,
+      "floorOffsets": [
+        0,
+        0,
+        0,
+        0
+      ],
+      "mouth": [
+        [
+          203,
+          179
+        ],
+        [
+          194,
+          180
+        ],
+        [
+          191,
+          180
+        ],
+        [
+          195,
+          183
+        ]
+      ]
+    },
+    "feet": [
+      [
+        {
+          "id": "fore-left",
+          "x": 168,
+          "y": 260,
+          "stance": false
+        },
+        {
+          "id": "fore-right",
+          "x": 220,
+          "y": 298,
+          "stance": true
+        }
+      ],
+      [
+        {
+          "id": "fore-left",
+          "x": 174,
+          "y": 267,
+          "stance": false
+        },
+        {
+          "id": "fore-right",
+          "x": 210,
+          "y": 298,
+          "stance": true
+        }
+      ],
+      [
+        {
+          "id": "fore-left",
+          "x": 164,
+          "y": 298,
+          "stance": true
+        },
+        {
+          "id": "fore-right",
+          "x": 217,
+          "y": 260,
+          "stance": false
+        }
+      ],
+      [
+        {
+          "id": "fore-left",
+          "x": 160,
+          "y": 298,
+          "stance": true
+        },
+        {
+          "id": "fore-right",
+          "x": 216,
+          "y": 270,
+          "stance": false
+        }
+      ]
+    ]
+  },
+  "carrySource": {
+    "encodedSha256": "efa81c6f464646d101873223869cebf5ca28c80529ad4ab26380d3b97cc2af54",
+    "frames": 37,
+    "gzipBytes": 375968,
+    "residentPixelBytes": 1043388,
+    "sheetSha256": "43e41a678d348439bf989535bf30761cc23ac9d4ca049705a9a651e1e8b61ee0"
   }
 }