vanaheimr 0.4.0

package/lib/tools.ts

@@ -0,0 +1,42 @@
+export type ToolDefinition = {
+  id: string;
+  name: string;
+  description: string;
+  href: string;
+  icon: string;
+};
+
+export const TOOLS: ToolDefinition[] = [
+  {
+    id: "entity-studio",
+    name: "Entity studio",
+    description:
+      "Define entity classes (allies, enemies, and custom types) with schemas, player data, and records.",
+    href: "/tools/entity-studio",
+    icon: "◎",
+  },
+  {
+    id: "publish",
+    name: "Publish",
+    description:
+      "Review draft changes, assign a version number, and push live for your game to consume.",
+    href: "/tools/publish",
+    icon: "▲",
+  },
+  {
+    id: "analytics",
+    name: "Player analytics",
+    description:
+      "Per-player field values reported from the game (e.g. has_defeated) keyed by anonymous player id.",
+    href: "/tools/analytics",
+    icon: "▤",
+  },
+  {
+    id: "docs-tool",
+    name: "SDK reference",
+    description:
+      "getEntityClasses(), getEntities(slug), player schemas, and AllyTree types.",
+    href: "/tools/docs-tool",
+    icon: "≡",
+  },
+];

package/lib/types.ts

@@ -0,0 +1,37 @@
+export type FieldType = "int" | "string" | "image" | "bool";
+
+export type SchemaField = {
+  id: string;
+  key: string;
+  type: FieldType;
+  /** Optional schema-level default used when a row has no value for this key yet. */
+  defaultValue?: number | string | boolean | null;
+};
+
+export type AllySchema = {
+  fields: SchemaField[];
+};
+
+/** Values stored on an ally/enemy row (content schema; includes bool when used as a field type). */
+export type AllyRowValue = number | string | boolean | null;
+
+export type AllyRow = {
+  id: string;
+  values: Record<string, AllyRowValue>;
+};
+
+export type AllyStore = {
+  schema: AllySchema;
+  /** Per-player tracking fields defined by the studio author (e.g. has_defeated, flawless). */
+  playerSchema: AllySchema;
+  allies: AllyRow[];
+};
+
+export const FIELD_TYPES: FieldType[] = ["int", "string", "image", "bool"];
+
+/** Subset of field types suitable for player-data fields (no images). */
+export const PLAYER_FIELD_TYPES: FieldType[] = ["bool", "int", "string"];
+
+export function emptyStore(): AllyStore {
+  return { schema: { fields: [] }, playerSchema: { fields: [] }, allies: [] };
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "vanaheimr",
+  "version": "0.4.0",
+  "description": "Runtime access to studio entity classes, rows (PK → props), and player-data schemas.",
+  "files": [
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/entry.ts",
+      "default": "./lib/entry.ts"
+    },
+    "./sdk": {
+      "types": "./lib/sdk/index.ts",
+      "default": "./lib/sdk/index.ts"
+    },
+    "./node": {
+      "types": "./lib/sdk/node.ts",
+      "default": "./lib/sdk/node.ts"
+    }
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.758.0",
+    "@supabase/ssr": "^0.10.3",
+    "@supabase/supabase-js": "^2.105.4",
+    "@vercel/blob": "^0.27.0",
+    "next": "16.2.4",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.4",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}