@ankhorage/zora-game 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @ankhorage/zora-game
+
+## 0.1.0
+
+### Minor Changes
+
+- 5eb7739: Add the initial generic game presentation plugin with embeddable field, entity, and overlay primitives.
+
+## 0.0.0
+
+Initial package bootstrap. Future release entries are managed by Changesets.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ankhorage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,19 @@
+<!-- markdownlint-disable MD013 MD033 -->
+<!-- This file is generated by Paradox. Do not edit manually. -->
+
+# @ankhorage/zora-game
+
+![license: MIT](././paradox/badges/license.svg) ![npm: v0.1.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+
+Generic game presentation primitives for React Native and React Native Web apps built on ZORA.
+
+## Generated documentation
+
+- [Interactive documentation app](././paradox/index.html)
+- [Public API reference](././paradox/exports.md)
+- [Component registry](././paradox/components.md)
+- [Architecture overview](././paradox/diagrams/architecture-overview.mmd)
+- [Module relationships](././paradox/diagrams/module-relationships.mmd)
+- [Export graph](././paradox/diagrams/export-graph.mmd)
+- [GameEntity sequence](././paradox/diagrams/sequences/game-entity.mmd)
+- [GameOverlay sequence](././paradox/diagrams/sequences/game-overlay.mmd)

package/dist/ZORA_GAME_COMPONENT_META.d.ts

@@ -0,0 +1,224 @@
+/*** Register the generic game presentation metadata owned by this package. */
+export declare const ZORA_GAME_COMPONENT_META: {
+    readonly GameEntity: {
+        readonly name: "GameEntity";
+        readonly category: "component";
+        readonly description: "Positions arbitrary visual content inside a GameField without owning game rules.";
+        readonly directManifestNode: true;
+        readonly allowedChildren: readonly ["Badge", "Icon", "Image", "Text", "View"];
+        readonly blueprint: {
+            readonly label: "Game entity";
+            readonly defaultProps: {
+                readonly x: 0;
+                readonly y: 0;
+                readonly opacity: 1;
+                readonly scale: 1;
+                readonly rotation: 0;
+                readonly zIndex: 0;
+            };
+        };
+        readonly props: {
+            readonly x: {
+                readonly type: "number";
+                readonly category: "Position";
+                readonly label: "X (%)";
+                readonly default: 0;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly y: {
+                readonly type: "number";
+                readonly category: "Position";
+                readonly label: "Y (%)";
+                readonly default: 0;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly width: {
+                readonly type: "number";
+                readonly category: "Size";
+                readonly label: "Width";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly height: {
+                readonly type: "number";
+                readonly category: "Size";
+                readonly label: "Height";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly opacity: {
+                readonly type: "number";
+                readonly category: "Appearance";
+                readonly label: "Opacity";
+                readonly default: 1;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly scale: {
+                readonly type: "number";
+                readonly category: "Transform";
+                readonly label: "Scale";
+                readonly default: 1;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly rotation: {
+                readonly type: "number";
+                readonly category: "Transform";
+                readonly label: "Rotation";
+                readonly default: 0;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly zIndex: {
+                readonly type: "number";
+                readonly category: "Position";
+                readonly label: "Z index";
+                readonly default: 0;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly hidden: {
+                readonly type: "boolean";
+                readonly category: "State";
+                readonly label: "Hidden";
+                readonly default: false;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly pointerEvents: {
+                readonly type: "enum";
+                readonly category: "Interaction";
+                readonly label: "Pointer events";
+                readonly enum: readonly ["auto", "box-none", "box-only", "none"];
+                readonly default: "auto";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly accessibilityLabel: {
+                readonly type: "string";
+                readonly category: "Accessibility";
+                readonly label: "Accessibility label";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+        };
+    };
+    readonly GameField: {
+        readonly name: "GameField";
+        readonly category: "layout";
+        readonly description: "Relative positioning surface for embeddable game presentation content.";
+        readonly directManifestNode: true;
+        readonly allowedChildren: readonly ["GameEntity", "GameOverlay", "Gradient", "Image", "View"];
+        readonly blueprint: {
+            readonly label: "Game field";
+            readonly defaultProps: {
+                readonly minHeight: 320;
+                readonly clip: true;
+            };
+        };
+        readonly props: {
+            readonly aspectRatio: {
+                readonly type: "number";
+                readonly category: "Layout";
+                readonly label: "Aspect ratio";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly minHeight: {
+                readonly type: "number";
+                readonly category: "Layout";
+                readonly label: "Minimum height";
+                readonly default: 320;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly clip: {
+                readonly type: "boolean";
+                readonly category: "Layout";
+                readonly label: "Clip overflow";
+                readonly default: true;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly accessibilityLabel: {
+                readonly type: "string";
+                readonly category: "Accessibility";
+                readonly label: "Accessibility label";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+        };
+    };
+    readonly GameOverlay: {
+        readonly name: "GameOverlay";
+        readonly category: "layout";
+        readonly description: "Absolute presentation layer for HUD, feedback, controls, and phase content.";
+        readonly directManifestNode: true;
+        readonly allowedChildren: readonly ["Badge", "Button", "ButtonGroup", "Card", "GameEntity", "Heading", "Icon", "Image", "Progress", "ProgressRing", "Text", "View"];
+        readonly blueprint: {
+            readonly label: "Game overlay";
+            readonly defaultProps: {
+                readonly placement: "fill";
+                readonly blocking: false;
+                readonly padding: 0;
+            };
+        };
+        readonly props: {
+            readonly placement: {
+                readonly type: "enum";
+                readonly category: "Layout";
+                readonly label: "Placement";
+                readonly enum: readonly ["fill", "center", "top", "bottom", "top-left", "top-right", "bottom-left", "bottom-right"];
+                readonly default: "fill";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly blocking: {
+                readonly type: "boolean";
+                readonly category: "Interaction";
+                readonly label: "Block pointer input";
+                readonly default: false;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly padding: {
+                readonly type: "number";
+                readonly category: "Layout";
+                readonly label: "Padding";
+                readonly default: 0;
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+            readonly accessibilityLabel: {
+                readonly type: "string";
+                readonly category: "Accessibility";
+                readonly label: "Accessibility label";
+                readonly authoring: {
+                    readonly authority: "instance";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=ZORA_GAME_COMPONENT_META.d.ts.map

package/dist/ZORA_GAME_COMPONENT_META.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZORA_GAME_COMPONENT_META.d.ts","sourceRoot":"","sources":["../src/ZORA_GAME_COMPONENT_META.ts"],"names":[],"mappings":"AAIA,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAI3B,CAAC"}

package/dist/ZORA_GAME_COMPONENT_META.js

@@ -0,0 +1,10 @@
+import { gameEntityMeta } from './features/game-presentation/meta/gameEntityMeta';
+import { gameFieldMeta } from './features/game-presentation/meta/gameFieldMeta';
+import { gameOverlayMeta } from './features/game-presentation/meta/gameOverlayMeta';
+/*** Register the generic game presentation metadata owned by this package. */
+export const ZORA_GAME_COMPONENT_META = {
+    GameEntity: gameEntityMeta,
+    GameField: gameFieldMeta,
+    GameOverlay: gameOverlayMeta,
+};
+//# sourceMappingURL=ZORA_GAME_COMPONENT_META.js.map

package/dist/ZORA_GAME_COMPONENT_META.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZORA_GAME_COMPONENT_META.js","sourceRoot":"","sources":["../src/ZORA_GAME_COMPONENT_META.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kDAAkD,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AAEpF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,eAAe;CACpB,CAAC","sourcesContent":["import { gameEntityMeta } from './features/game-presentation/meta/gameEntityMeta';\nimport { gameFieldMeta } from './features/game-presentation/meta/gameFieldMeta';\nimport { gameOverlayMeta } from './features/game-presentation/meta/gameOverlayMeta';\n\n/*** Register the generic game presentation metadata owned by this package. */\nexport const ZORA_GAME_COMPONENT_META = {\n  GameEntity: gameEntityMeta,\n  GameField: gameFieldMeta,\n  GameOverlay: gameOverlayMeta,\n} as const;\n"]}

package/dist/ZORA_GAME_PLUGIN.d.ts

@@ -0,0 +1,247 @@
+import { GameEntity } from './features/game-presentation/adapters/inbound/GameEntity';
+import { GameField } from './features/game-presentation/adapters/inbound/GameField';
+import { GameOverlay } from './features/game-presentation/adapters/inbound/GameOverlay';
+/*** Expose the runtime component registry together with metadata for ZORA plugin consumers. */
+export declare const ZORA_GAME_PLUGIN: {
+    readonly componentRegistry: {
+        readonly GameEntity: typeof GameEntity;
+        readonly GameField: typeof GameField;
+        readonly GameOverlay: typeof GameOverlay;
+    };
+    readonly packageName: "@ankhorage/zora-game";
+    readonly displayName: "ZORA Game";
+    readonly componentMeta: {
+        readonly GameEntity: {
+            readonly name: "GameEntity";
+            readonly category: "component";
+            readonly description: "Positions arbitrary visual content inside a GameField without owning game rules.";
+            readonly directManifestNode: true;
+            readonly allowedChildren: readonly ["Badge", "Icon", "Image", "Text", "View"];
+            readonly blueprint: {
+                readonly label: "Game entity";
+                readonly defaultProps: {
+                    readonly x: 0;
+                    readonly y: 0;
+                    readonly opacity: 1;
+                    readonly scale: 1;
+                    readonly rotation: 0;
+                    readonly zIndex: 0;
+                };
+            };
+            readonly props: {
+                readonly x: {
+                    readonly type: "number";
+                    readonly category: "Position";
+                    readonly label: "X (%)";
+                    readonly default: 0;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly y: {
+                    readonly type: "number";
+                    readonly category: "Position";
+                    readonly label: "Y (%)";
+                    readonly default: 0;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly width: {
+                    readonly type: "number";
+                    readonly category: "Size";
+                    readonly label: "Width";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly height: {
+                    readonly type: "number";
+                    readonly category: "Size";
+                    readonly label: "Height";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly opacity: {
+                    readonly type: "number";
+                    readonly category: "Appearance";
+                    readonly label: "Opacity";
+                    readonly default: 1;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly scale: {
+                    readonly type: "number";
+                    readonly category: "Transform";
+                    readonly label: "Scale";
+                    readonly default: 1;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly rotation: {
+                    readonly type: "number";
+                    readonly category: "Transform";
+                    readonly label: "Rotation";
+                    readonly default: 0;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly zIndex: {
+                    readonly type: "number";
+                    readonly category: "Position";
+                    readonly label: "Z index";
+                    readonly default: 0;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly hidden: {
+                    readonly type: "boolean";
+                    readonly category: "State";
+                    readonly label: "Hidden";
+                    readonly default: false;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly pointerEvents: {
+                    readonly type: "enum";
+                    readonly category: "Interaction";
+                    readonly label: "Pointer events";
+                    readonly enum: readonly ["auto", "box-none", "box-only", "none"];
+                    readonly default: "auto";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                    readonly category: "Accessibility";
+                    readonly label: "Accessibility label";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+            };
+        };
+        readonly GameField: {
+            readonly name: "GameField";
+            readonly category: "layout";
+            readonly description: "Relative positioning surface for embeddable game presentation content.";
+            readonly directManifestNode: true;
+            readonly allowedChildren: readonly ["GameEntity", "GameOverlay", "Gradient", "Image", "View"];
+            readonly blueprint: {
+                readonly label: "Game field";
+                readonly defaultProps: {
+                    readonly minHeight: 320;
+                    readonly clip: true;
+                };
+            };
+            readonly props: {
+                readonly aspectRatio: {
+                    readonly type: "number";
+                    readonly category: "Layout";
+                    readonly label: "Aspect ratio";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly minHeight: {
+                    readonly type: "number";
+                    readonly category: "Layout";
+                    readonly label: "Minimum height";
+                    readonly default: 320;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly clip: {
+                    readonly type: "boolean";
+                    readonly category: "Layout";
+                    readonly label: "Clip overflow";
+                    readonly default: true;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                    readonly category: "Accessibility";
+                    readonly label: "Accessibility label";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+            };
+        };
+        readonly GameOverlay: {
+            readonly name: "GameOverlay";
+            readonly category: "layout";
+            readonly description: "Absolute presentation layer for HUD, feedback, controls, and phase content.";
+            readonly directManifestNode: true;
+            readonly allowedChildren: readonly ["Badge", "Button", "ButtonGroup", "Card", "GameEntity", "Heading", "Icon", "Image", "Progress", "ProgressRing", "Text", "View"];
+            readonly blueprint: {
+                readonly label: "Game overlay";
+                readonly defaultProps: {
+                    readonly placement: "fill";
+                    readonly blocking: false;
+                    readonly padding: 0;
+                };
+            };
+            readonly props: {
+                readonly placement: {
+                    readonly type: "enum";
+                    readonly category: "Layout";
+                    readonly label: "Placement";
+                    readonly enum: readonly ["fill", "center", "top", "bottom", "top-left", "top-right", "bottom-left", "bottom-right"];
+                    readonly default: "fill";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly blocking: {
+                    readonly type: "boolean";
+                    readonly category: "Interaction";
+                    readonly label: "Block pointer input";
+                    readonly default: false;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly padding: {
+                    readonly type: "number";
+                    readonly category: "Layout";
+                    readonly label: "Padding";
+                    readonly default: 0;
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+                readonly accessibilityLabel: {
+                    readonly type: "string";
+                    readonly category: "Accessibility";
+                    readonly label: "Accessibility label";
+                    readonly authoring: {
+                        readonly authority: "instance";
+                    };
+                };
+            };
+        };
+    };
+    readonly extensionHosts: readonly ["GameField", "GameEntity", "GameOverlay"];
+    readonly placements: readonly [{
+        readonly child: "GameField";
+        readonly parents: readonly ["Card", "Grid", "Screen", "ScreenSection", "View"];
+    }, {
+        readonly child: "GameEntity";
+        readonly parents: readonly ["GameField", "GameOverlay"];
+    }, {
+        readonly child: "GameOverlay";
+        readonly parents: readonly ["GameField"];
+    }];
+};
+//# sourceMappingURL=ZORA_GAME_PLUGIN.d.ts.map

package/dist/ZORA_GAME_PLUGIN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZORA_GAME_PLUGIN.d.ts","sourceRoot":"","sources":["../src/ZORA_GAME_PLUGIN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0DAA0D,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,yDAAyD,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,2DAA2D,CAAC;AAGxF,+FAA+F;AAC/F,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOnB,CAAC"}

package/dist/ZORA_GAME_PLUGIN.js

@@ -0,0 +1,14 @@
+import { GameEntity } from './features/game-presentation/adapters/inbound/GameEntity';
+import { GameField } from './features/game-presentation/adapters/inbound/GameField';
+import { GameOverlay } from './features/game-presentation/adapters/inbound/GameOverlay';
+import { ZORA_PLUGIN_METADATA } from './ZORA_PLUGIN_METADATA';
+/*** Expose the runtime component registry together with metadata for ZORA plugin consumers. */
+export const ZORA_GAME_PLUGIN = {
+    ...ZORA_PLUGIN_METADATA,
+    componentRegistry: {
+        GameEntity,
+        GameField,
+        GameOverlay,
+    },
+};
+//# sourceMappingURL=ZORA_GAME_PLUGIN.js.map

package/dist/ZORA_GAME_PLUGIN.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZORA_GAME_PLUGIN.js","sourceRoot":"","sources":["../src/ZORA_GAME_PLUGIN.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0DAA0D,CAAC;AACtF,OAAO,EAAE,SAAS,EAAE,MAAM,yDAAyD,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,2DAA2D,CAAC;AACxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,+FAA+F;AAC/F,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,oBAAoB;IACvB,iBAAiB,EAAE;QACjB,UAAU;QACV,SAAS;QACT,WAAW;KACZ;CACO,CAAC","sourcesContent":["import { GameEntity } from './features/game-presentation/adapters/inbound/GameEntity';\nimport { GameField } from './features/game-presentation/adapters/inbound/GameField';\nimport { GameOverlay } from './features/game-presentation/adapters/inbound/GameOverlay';\nimport { ZORA_PLUGIN_METADATA } from './ZORA_PLUGIN_METADATA';\n\n/*** Expose the runtime component registry together with metadata for ZORA plugin consumers. */\nexport const ZORA_GAME_PLUGIN = {\n  ...ZORA_PLUGIN_METADATA,\n  componentRegistry: {\n    GameEntity,\n    GameField,\n    GameOverlay,\n  },\n} as const;\n"]}