@oasiz/sdk 1.8.2 → 1.8.4

package/README.md

@@ -134,6 +134,103 @@ Supported `device` presets:
 | `iphone-17e` | `390 × 844` |
 | `iphone-air` | `420 × 912` |
 
+### Player character animations
+
+Use the Jibble animation constants when wiring a player character atlas so you can reference known animation IDs during local development instead of publishing first and reading logs.
+
+The atlas animation IDs are stable strings. Directional animations use the pattern
+`<action>_<direction>`, where the direction suffix is one of `n`, `ne`, `e`, `se`,
+`s`, `sw`, `w`, or `nw`.
+
+| Player-facing direction | Compass direction | Suffix |
+| --- | --- | --- |
+| `front`, `forward`, `forth` | South | `s` |
+| `front-right`, `forward-right` | SouthEast | `se` |
+| `right` | East | `e` |
+| `back-right`, `backward-right` | NorthEast | `ne` |
+| `back`, `backward` | North | `n` |
+| `back-left`, `backward-left` | NorthWest | `nw` |
+| `left` | West | `w` |
+| `front-left`, `forward-left` | SouthWest | `sw` |
+
+You can also pass compass names directly, such as `north`, `south`, `north-east`,
+or `southwest`.
+
+#### Animation catalog
+
+| Action | Constant | Animation IDs |
+| --- | --- | --- |
+| Idle | `JIBBLE_ANIMATION.Idle` | `idle_n`, `idle_ne`, `idle_e`, `idle_se`, `idle_s`, `idle_sw`, `idle_w`, `idle_nw` |
+| Walk | `JIBBLE_ANIMATION.Walk` | `walk_n`, `walk_ne`, `walk_e`, `walk_se`, `walk_s`, `walk_sw`, `walk_w`, `walk_nw` |
+| Backflip | `JIBBLE_ANIMATION.Backflip` | `backflip` |
+
+`backflip` is not directional, so `getJibbleAnimationId("backflip", "left")`
+still returns `backflip`.
+
+#### HTML5 / TypeScript
+
+```ts
+import {
+  JIBBLE_ANIMATION,
+  JIBBLE_ANIMATION_IDS,
+  getJibbleAnimationId,
+  oasiz,
+} from "@oasiz/sdk";
+
+const character = await oasiz.getPlayerCharacter();
+if (!character) return;
+
+const atlas = character.textureAtlas;
+
+// Print the full SDK catalog while debugging.
+console.table(JIBBLE_ANIMATION_IDS);
+
+const walkBack = getJibbleAnimationId("walk", "back"); // "walk_n"
+const walkBackAnimation = atlas.animations.find((anim) => anim.animationId === walkBack);
+
+const idleFrontAnimation = atlas.animations.find(
+  (anim) => anim.animationId === JIBBLE_ANIMATION.Idle.South,
+);
+
+const backflipAnimation = atlas.animations.find(
+  (anim) => anim.animationId === JIBBLE_ANIMATION.Backflip,
+);
+
+const availableAnimations = new Set(atlas.animations.map((anim) => anim.animationId));
+const animationToPlay = availableAnimations.has(walkBack)
+  ? walkBack
+  : JIBBLE_ANIMATION.Idle.South;
+```
+
+Not every custom atlas is guaranteed to contain every catalog ID. Check
+`atlas.animations` before playing an animation and choose a fallback, usually
+`idle_s` or the closest available direction.
+
+#### Unity
+
+```csharp
+using Oasiz;
+
+var walkBackId = JibbleAnimations.GetId(
+  JibbleAnimationAction.Walk,
+  JibbleDirection.Back); // "walk_n"
+
+var walkFrontRightId = JibbleAnimations.GetId(
+  JibbleAnimationAction.Walk,
+  JibbleDirection.FrontRight); // "walk_se"
+
+var idleFrontId = JibbleAnimations.GetId(
+  JibbleAnimationAction.Idle,
+  JibbleDirection.Front); // "idle_s"
+
+var backflipId = JibbleAnimations.Backflip; // "backflip"
+
+foreach (var animationId in JibbleAnimations.All)
+{
+  Debug.Log(animationId);
+}
+```
+
 ### Score
 
 #### `oasiz.submitScore(score: number)`

package/dist/index.cjs

@@ -20,6 +20,9 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  JIBBLE_ANIMATION: () => JIBBLE_ANIMATION,
+  JIBBLE_ANIMATION_IDS: () => JIBBLE_ANIMATION_IDS,
+  JIBBLE_DIRECTIONS: () => JIBBLE_DIRECTIONS,
   addScore: () => addScore,
   enableAppSimulator: () => enableAppSimulator,
   enableBackButtonTesting: () => enableBackButtonTesting,
@@ -27,6 +30,7 @@ __export(index_exports, {
   flushGameState: () => flushGameState,
   getGameId: () => getGameId,
   getGraphicsPerformance: () => getGraphicsPerformance,
+  getJibbleAnimationId: () => getJibbleAnimationId,
   getPlayerAvatar: () => getPlayerAvatar,
   getPlayerCharacter: () => getPlayerCharacter,
   getPlayerId: () => getPlayerId,
@@ -36,6 +40,7 @@ __export(index_exports, {
   getViewportInsets: () => getViewportInsets,
   leaveGame: () => leaveGame,
   loadGameState: () => loadGameState,
+  normalizeJibbleDirection: () => normalizeJibbleDirection,
   oasiz: () => oasiz,
   onBackButton: () => onBackButton,
   onLeaveGame: () => onLeaveGame,
@@ -1498,6 +1503,106 @@ function triggerHaptic(type) {
   }
 }
 
+// src/jibble.ts
+var JIBBLE_DIRECTIONS = [
+  "n",
+  "ne",
+  "e",
+  "se",
+  "s",
+  "sw",
+  "w",
+  "nw"
+];
+var JIBBLE_DIRECTION_ALIASES = {
+  n: "n",
+  ne: "ne",
+  e: "e",
+  se: "se",
+  s: "s",
+  sw: "sw",
+  w: "w",
+  nw: "nw",
+  north: "n",
+  "north-east": "ne",
+  northeast: "ne",
+  east: "e",
+  "south-east": "se",
+  southeast: "se",
+  south: "s",
+  "south-west": "sw",
+  southwest: "sw",
+  west: "w",
+  "north-west": "nw",
+  northwest: "nw",
+  front: "s",
+  forward: "s",
+  forth: "s",
+  back: "n",
+  backward: "n",
+  left: "w",
+  right: "e",
+  "front-right": "se",
+  "forward-right": "se",
+  "front-left": "sw",
+  "forward-left": "sw",
+  "back-right": "ne",
+  "backward-right": "ne",
+  "back-left": "nw",
+  "backward-left": "nw"
+};
+var JIBBLE_ANIMATION = {
+  Idle: {
+    North: "idle_n",
+    NorthEast: "idle_ne",
+    East: "idle_e",
+    SouthEast: "idle_se",
+    South: "idle_s",
+    SouthWest: "idle_sw",
+    West: "idle_w",
+    NorthWest: "idle_nw"
+  },
+  Walk: {
+    North: "walk_n",
+    NorthEast: "walk_ne",
+    East: "walk_e",
+    SouthEast: "walk_se",
+    South: "walk_s",
+    SouthWest: "walk_sw",
+    West: "walk_w",
+    NorthWest: "walk_nw"
+  },
+  Backflip: "backflip"
+};
+var JIBBLE_ANIMATION_IDS = [
+  JIBBLE_ANIMATION.Idle.North,
+  JIBBLE_ANIMATION.Idle.NorthEast,
+  JIBBLE_ANIMATION.Idle.East,
+  JIBBLE_ANIMATION.Idle.SouthEast,
+  JIBBLE_ANIMATION.Idle.South,
+  JIBBLE_ANIMATION.Idle.SouthWest,
+  JIBBLE_ANIMATION.Idle.West,
+  JIBBLE_ANIMATION.Idle.NorthWest,
+  JIBBLE_ANIMATION.Walk.North,
+  JIBBLE_ANIMATION.Walk.NorthEast,
+  JIBBLE_ANIMATION.Walk.East,
+  JIBBLE_ANIMATION.Walk.SouthEast,
+  JIBBLE_ANIMATION.Walk.South,
+  JIBBLE_ANIMATION.Walk.SouthWest,
+  JIBBLE_ANIMATION.Walk.West,
+  JIBBLE_ANIMATION.Walk.NorthWest,
+  JIBBLE_ANIMATION.Backflip
+];
+function normalizeJibbleDirection(direction) {
+  return JIBBLE_DIRECTION_ALIASES[direction];
+}
+function getJibbleAnimationId(action, direction = "front") {
+  if (action === "backflip") {
+    return JIBBLE_ANIMATION.Backflip;
+  }
+  return `${action}_${normalizeJibbleDirection(direction)}`;
+}
+
 // src/log-overlay.ts
 var CONSOLE_METHODS = [
   "debug",
@@ -3344,6 +3449,10 @@ function getGraphicsPerformance() {
 var oasiz = {
   submitScore,
   enableAppSimulator,
+  getJibbleAnimationId,
+  jibbleAnimations: JIBBLE_ANIMATION,
+  jibbleAnimationIds: JIBBLE_ANIMATION_IDS,
+  jibbleDirections: JIBBLE_DIRECTIONS,
   addScore,
   setScore,
   getPlayerCharacter,
@@ -3392,6 +3501,9 @@ var oasiz = {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  JIBBLE_ANIMATION,
+  JIBBLE_ANIMATION_IDS,
+  JIBBLE_DIRECTIONS,
   addScore,
   enableAppSimulator,
   enableBackButtonTesting,
@@ -3399,6 +3511,7 @@ var oasiz = {
   flushGameState,
   getGameId,
   getGraphicsPerformance,
+  getJibbleAnimationId,
   getPlayerAvatar,
   getPlayerCharacter,
   getPlayerId,
@@ -3408,6 +3521,7 @@ var oasiz = {
   getViewportInsets,
   leaveGame,
   loadGameState,
+  normalizeJibbleDirection,
   oasiz,
   onBackButton,
   onLeaveGame,

package/dist/index.d.cts

@@ -249,6 +249,75 @@ declare function getPlayerCharacter(): Promise<PlayerCharacter | null>;
 
 declare function triggerHaptic(type: HapticType): void;
 
+declare const JIBBLE_DIRECTIONS: readonly ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
+type JibbleDirectionCode = (typeof JIBBLE_DIRECTIONS)[number];
+declare const JIBBLE_DIRECTION_ALIASES: {
+    readonly n: "n";
+    readonly ne: "ne";
+    readonly e: "e";
+    readonly se: "se";
+    readonly s: "s";
+    readonly sw: "sw";
+    readonly w: "w";
+    readonly nw: "nw";
+    readonly north: "n";
+    readonly "north-east": "ne";
+    readonly northeast: "ne";
+    readonly east: "e";
+    readonly "south-east": "se";
+    readonly southeast: "se";
+    readonly south: "s";
+    readonly "south-west": "sw";
+    readonly southwest: "sw";
+    readonly west: "w";
+    readonly "north-west": "nw";
+    readonly northwest: "nw";
+    readonly front: "s";
+    readonly forward: "s";
+    readonly forth: "s";
+    readonly back: "n";
+    readonly backward: "n";
+    readonly left: "w";
+    readonly right: "e";
+    readonly "front-right": "se";
+    readonly "forward-right": "se";
+    readonly "front-left": "sw";
+    readonly "forward-left": "sw";
+    readonly "back-right": "ne";
+    readonly "backward-right": "ne";
+    readonly "back-left": "nw";
+    readonly "backward-left": "nw";
+};
+type JibbleFacingDirection = keyof typeof JIBBLE_DIRECTION_ALIASES;
+type JibbleAnimationAction = "idle" | "walk" | "backflip";
+declare const JIBBLE_ANIMATION: {
+    readonly Idle: {
+        readonly North: "idle_n";
+        readonly NorthEast: "idle_ne";
+        readonly East: "idle_e";
+        readonly SouthEast: "idle_se";
+        readonly South: "idle_s";
+        readonly SouthWest: "idle_sw";
+        readonly West: "idle_w";
+        readonly NorthWest: "idle_nw";
+    };
+    readonly Walk: {
+        readonly North: "walk_n";
+        readonly NorthEast: "walk_ne";
+        readonly East: "walk_e";
+        readonly SouthEast: "walk_se";
+        readonly South: "walk_s";
+        readonly SouthWest: "walk_sw";
+        readonly West: "walk_w";
+        readonly NorthWest: "walk_nw";
+    };
+    readonly Backflip: "backflip";
+};
+declare const JIBBLE_ANIMATION_IDS: readonly ["idle_n", "idle_ne", "idle_e", "idle_se", "idle_s", "idle_sw", "idle_w", "idle_nw", "walk_n", "walk_ne", "walk_e", "walk_se", "walk_s", "walk_sw", "walk_w", "walk_nw", "backflip"];
+type JibbleAnimationId = (typeof JIBBLE_ANIMATION_IDS)[number];
+declare function normalizeJibbleDirection(direction: JibbleFacingDirection): JibbleDirectionCode;
+declare function getJibbleAnimationId(action: JibbleAnimationAction, direction?: JibbleFacingDirection): JibbleAnimationId;
+
 declare function enableLogOverlay(options?: LogOverlayOptions): LogOverlayHandle;
 
 interface ShareRoomCodeOptions {
@@ -315,6 +384,32 @@ declare function flushGameState(): void;
 declare const oasiz: {
     submitScore: typeof submitScore;
     enableAppSimulator: typeof enableAppSimulator;
+    getJibbleAnimationId: typeof getJibbleAnimationId;
+    jibbleAnimations: {
+        readonly Idle: {
+            readonly North: "idle_n";
+            readonly NorthEast: "idle_ne";
+            readonly East: "idle_e";
+            readonly SouthEast: "idle_se";
+            readonly South: "idle_s";
+            readonly SouthWest: "idle_sw";
+            readonly West: "idle_w";
+            readonly NorthWest: "idle_nw";
+        };
+        readonly Walk: {
+            readonly North: "walk_n";
+            readonly NorthEast: "walk_ne";
+            readonly East: "walk_e";
+            readonly SouthEast: "walk_se";
+            readonly South: "walk_s";
+            readonly SouthWest: "walk_sw";
+            readonly West: "walk_w";
+            readonly NorthWest: "walk_nw";
+        };
+        readonly Backflip: "backflip";
+    };
+    jibbleAnimationIds: readonly ["idle_n", "idle_ne", "idle_e", "idle_se", "idle_s", "idle_sw", "idle_w", "idle_nw", "walk_n", "walk_ne", "walk_e", "walk_se", "walk_s", "walk_sw", "walk_w", "walk_nw", "backflip"];
+    jibbleDirections: readonly ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
     addScore: typeof addScore;
     setScore: typeof setScore;
     getPlayerCharacter: typeof getPlayerCharacter;
@@ -346,4 +441,4 @@ declare const oasiz: {
     readonly graphicsPerformance: GraphicsPerformanceMetric;
 };
 
-export { type AppSimulatorDevice, type AppSimulatorDeviceName, type AppSimulatorHandle, type AppSimulatorOptions, type AppSimulatorOrientation, type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableAppSimulator, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };
+export { type AppSimulatorDevice, type AppSimulatorDeviceName, type AppSimulatorHandle, type AppSimulatorOptions, type AppSimulatorOrientation, type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, JIBBLE_ANIMATION, JIBBLE_ANIMATION_IDS, JIBBLE_DIRECTIONS, type JibbleAnimationAction, type JibbleAnimationId, type JibbleDirectionCode, type JibbleFacingDirection, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableAppSimulator, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getJibbleAnimationId, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, normalizeJibbleDirection, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.d.ts

@@ -249,6 +249,75 @@ declare function getPlayerCharacter(): Promise<PlayerCharacter | null>;
 
 declare function triggerHaptic(type: HapticType): void;
 
+declare const JIBBLE_DIRECTIONS: readonly ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
+type JibbleDirectionCode = (typeof JIBBLE_DIRECTIONS)[number];
+declare const JIBBLE_DIRECTION_ALIASES: {
+    readonly n: "n";
+    readonly ne: "ne";
+    readonly e: "e";
+    readonly se: "se";
+    readonly s: "s";
+    readonly sw: "sw";
+    readonly w: "w";
+    readonly nw: "nw";
+    readonly north: "n";
+    readonly "north-east": "ne";
+    readonly northeast: "ne";
+    readonly east: "e";
+    readonly "south-east": "se";
+    readonly southeast: "se";
+    readonly south: "s";
+    readonly "south-west": "sw";
+    readonly southwest: "sw";
+    readonly west: "w";
+    readonly "north-west": "nw";
+    readonly northwest: "nw";
+    readonly front: "s";
+    readonly forward: "s";
+    readonly forth: "s";
+    readonly back: "n";
+    readonly backward: "n";
+    readonly left: "w";
+    readonly right: "e";
+    readonly "front-right": "se";
+    readonly "forward-right": "se";
+    readonly "front-left": "sw";
+    readonly "forward-left": "sw";
+    readonly "back-right": "ne";
+    readonly "backward-right": "ne";
+    readonly "back-left": "nw";
+    readonly "backward-left": "nw";
+};
+type JibbleFacingDirection = keyof typeof JIBBLE_DIRECTION_ALIASES;
+type JibbleAnimationAction = "idle" | "walk" | "backflip";
+declare const JIBBLE_ANIMATION: {
+    readonly Idle: {
+        readonly North: "idle_n";
+        readonly NorthEast: "idle_ne";
+        readonly East: "idle_e";
+        readonly SouthEast: "idle_se";
+        readonly South: "idle_s";
+        readonly SouthWest: "idle_sw";
+        readonly West: "idle_w";
+        readonly NorthWest: "idle_nw";
+    };
+    readonly Walk: {
+        readonly North: "walk_n";
+        readonly NorthEast: "walk_ne";
+        readonly East: "walk_e";
+        readonly SouthEast: "walk_se";
+        readonly South: "walk_s";
+        readonly SouthWest: "walk_sw";
+        readonly West: "walk_w";
+        readonly NorthWest: "walk_nw";
+    };
+    readonly Backflip: "backflip";
+};
+declare const JIBBLE_ANIMATION_IDS: readonly ["idle_n", "idle_ne", "idle_e", "idle_se", "idle_s", "idle_sw", "idle_w", "idle_nw", "walk_n", "walk_ne", "walk_e", "walk_se", "walk_s", "walk_sw", "walk_w", "walk_nw", "backflip"];
+type JibbleAnimationId = (typeof JIBBLE_ANIMATION_IDS)[number];
+declare function normalizeJibbleDirection(direction: JibbleFacingDirection): JibbleDirectionCode;
+declare function getJibbleAnimationId(action: JibbleAnimationAction, direction?: JibbleFacingDirection): JibbleAnimationId;
+
 declare function enableLogOverlay(options?: LogOverlayOptions): LogOverlayHandle;
 
 interface ShareRoomCodeOptions {
@@ -315,6 +384,32 @@ declare function flushGameState(): void;
 declare const oasiz: {
     submitScore: typeof submitScore;
     enableAppSimulator: typeof enableAppSimulator;
+    getJibbleAnimationId: typeof getJibbleAnimationId;
+    jibbleAnimations: {
+        readonly Idle: {
+            readonly North: "idle_n";
+            readonly NorthEast: "idle_ne";
+            readonly East: "idle_e";
+            readonly SouthEast: "idle_se";
+            readonly South: "idle_s";
+            readonly SouthWest: "idle_sw";
+            readonly West: "idle_w";
+            readonly NorthWest: "idle_nw";
+        };
+        readonly Walk: {
+            readonly North: "walk_n";
+            readonly NorthEast: "walk_ne";
+            readonly East: "walk_e";
+            readonly SouthEast: "walk_se";
+            readonly South: "walk_s";
+            readonly SouthWest: "walk_sw";
+            readonly West: "walk_w";
+            readonly NorthWest: "walk_nw";
+        };
+        readonly Backflip: "backflip";
+    };
+    jibbleAnimationIds: readonly ["idle_n", "idle_ne", "idle_e", "idle_se", "idle_s", "idle_sw", "idle_w", "idle_nw", "walk_n", "walk_ne", "walk_e", "walk_se", "walk_s", "walk_sw", "walk_w", "walk_nw", "backflip"];
+    jibbleDirections: readonly ["n", "ne", "e", "se", "s", "sw", "w", "nw"];
     addScore: typeof addScore;
     setScore: typeof setScore;
     getPlayerCharacter: typeof getPlayerCharacter;
@@ -346,4 +441,4 @@ declare const oasiz: {
     readonly graphicsPerformance: GraphicsPerformanceMetric;
 };
 
-export { type AppSimulatorDevice, type AppSimulatorDeviceName, type AppSimulatorHandle, type AppSimulatorOptions, type AppSimulatorOrientation, type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableAppSimulator, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };
+export { type AppSimulatorDevice, type AppSimulatorDeviceName, type AppSimulatorHandle, type AppSimulatorOptions, type AppSimulatorOrientation, type BackButtonTestingHandle, type BackButtonTestingOptions, type FacingFrameMap, type GameState, type GraphicsPerformanceMetric, type GraphicsPerformanceTier, type HapticType, JIBBLE_ANIMATION, JIBBLE_ANIMATION_IDS, JIBBLE_DIRECTIONS, type JibbleAnimationAction, type JibbleAnimationId, type JibbleDirectionCode, type JibbleFacingDirection, type LogOverlayEntry, type LogOverlayHandle, type LogOverlayLevel, type LogOverlayOptions, type PlayerCharacter, type ScoreEditResult, type ShareRequest, type ShareRoomCodeOptions, type TextureAtlas, type TextureAtlasAnimation, type TextureAtlasFrame, type Unsubscribe, type ViewportInsetEdges, type ViewportInsetSide, type ViewportInsets, addScore, enableAppSimulator, enableBackButtonTesting, enableLogOverlay, flushGameState, getGameId, getGraphicsPerformance, getJibbleAnimationId, getPlayerAvatar, getPlayerCharacter, getPlayerId, getPlayerName, getRoomCode, getSafeAreaTop, getViewportInsets, leaveGame, loadGameState, normalizeJibbleDirection, oasiz, onBackButton, onLeaveGame, onPause, onResume, openInviteModal, saveGameState, setLeaderboardVisible, setScore, share, shareRoomCode, submitScore, triggerHaptic };

package/dist/index.js

@@ -1444,6 +1444,106 @@ function triggerHaptic(type) {
   }
 }
 
+// src/jibble.ts
+var JIBBLE_DIRECTIONS = [
+  "n",
+  "ne",
+  "e",
+  "se",
+  "s",
+  "sw",
+  "w",
+  "nw"
+];
+var JIBBLE_DIRECTION_ALIASES = {
+  n: "n",
+  ne: "ne",
+  e: "e",
+  se: "se",
+  s: "s",
+  sw: "sw",
+  w: "w",
+  nw: "nw",
+  north: "n",
+  "north-east": "ne",
+  northeast: "ne",
+  east: "e",
+  "south-east": "se",
+  southeast: "se",
+  south: "s",
+  "south-west": "sw",
+  southwest: "sw",
+  west: "w",
+  "north-west": "nw",
+  northwest: "nw",
+  front: "s",
+  forward: "s",
+  forth: "s",
+  back: "n",
+  backward: "n",
+  left: "w",
+  right: "e",
+  "front-right": "se",
+  "forward-right": "se",
+  "front-left": "sw",
+  "forward-left": "sw",
+  "back-right": "ne",
+  "backward-right": "ne",
+  "back-left": "nw",
+  "backward-left": "nw"
+};
+var JIBBLE_ANIMATION = {
+  Idle: {
+    North: "idle_n",
+    NorthEast: "idle_ne",
+    East: "idle_e",
+    SouthEast: "idle_se",
+    South: "idle_s",
+    SouthWest: "idle_sw",
+    West: "idle_w",
+    NorthWest: "idle_nw"
+  },
+  Walk: {
+    North: "walk_n",
+    NorthEast: "walk_ne",
+    East: "walk_e",
+    SouthEast: "walk_se",
+    South: "walk_s",
+    SouthWest: "walk_sw",
+    West: "walk_w",
+    NorthWest: "walk_nw"
+  },
+  Backflip: "backflip"
+};
+var JIBBLE_ANIMATION_IDS = [
+  JIBBLE_ANIMATION.Idle.North,
+  JIBBLE_ANIMATION.Idle.NorthEast,
+  JIBBLE_ANIMATION.Idle.East,
+  JIBBLE_ANIMATION.Idle.SouthEast,
+  JIBBLE_ANIMATION.Idle.South,
+  JIBBLE_ANIMATION.Idle.SouthWest,
+  JIBBLE_ANIMATION.Idle.West,
+  JIBBLE_ANIMATION.Idle.NorthWest,
+  JIBBLE_ANIMATION.Walk.North,
+  JIBBLE_ANIMATION.Walk.NorthEast,
+  JIBBLE_ANIMATION.Walk.East,
+  JIBBLE_ANIMATION.Walk.SouthEast,
+  JIBBLE_ANIMATION.Walk.South,
+  JIBBLE_ANIMATION.Walk.SouthWest,
+  JIBBLE_ANIMATION.Walk.West,
+  JIBBLE_ANIMATION.Walk.NorthWest,
+  JIBBLE_ANIMATION.Backflip
+];
+function normalizeJibbleDirection(direction) {
+  return JIBBLE_DIRECTION_ALIASES[direction];
+}
+function getJibbleAnimationId(action, direction = "front") {
+  if (action === "backflip") {
+    return JIBBLE_ANIMATION.Backflip;
+  }
+  return `${action}_${normalizeJibbleDirection(direction)}`;
+}
+
 // src/log-overlay.ts
 var CONSOLE_METHODS = [
   "debug",
@@ -3290,6 +3390,10 @@ function getGraphicsPerformance() {
 var oasiz = {
   submitScore,
   enableAppSimulator,
+  getJibbleAnimationId,
+  jibbleAnimations: JIBBLE_ANIMATION,
+  jibbleAnimationIds: JIBBLE_ANIMATION_IDS,
+  jibbleDirections: JIBBLE_DIRECTIONS,
   addScore,
   setScore,
   getPlayerCharacter,
@@ -3337,6 +3441,9 @@ var oasiz = {
   }
 };
 export {
+  JIBBLE_ANIMATION,
+  JIBBLE_ANIMATION_IDS,
+  JIBBLE_DIRECTIONS,
   addScore,
   enableAppSimulator,
   enableBackButtonTesting,
@@ -3344,6 +3451,7 @@ export {
   flushGameState,
   getGameId,
   getGraphicsPerformance,
+  getJibbleAnimationId,
   getPlayerAvatar,
   getPlayerCharacter,
   getPlayerId,
@@ -3353,6 +3461,7 @@ export {
   getViewportInsets,
   leaveGame,
   loadGameState,
+  normalizeJibbleDirection,
   oasiz,
   onBackButton,
   onLeaveGame,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oasiz/sdk",
-  "version": "1.8.2",
+  "version": "1.8.4",
   "description": "Typed SDK for Oasiz game platform bridge APIs.",
   "type": "module",
   "main": "./dist/index.cjs",