kaggle-environments 1.23.1__tar.gz → 1.23.2__tar.gz

{kaggle_environments-1.23.1 → kaggle_environments-1.23.2}/.gitignore

@@ -146,6 +146,7 @@ temp.*
 
 # node.js files
 node_modules
+**/node_modules
 
 # Java class files
 *.class

kaggle_environments-1.23.2/.stylelintrc.js

@@ -0,0 +1,4 @@
+module.exports = {
+    extends: ['stylelint-config-recommended'],
+    customSyntax: 'postcss-styled-syntax'
+};

{kaggle_environments-1.23.1 → kaggle_environments-1.23.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kaggle-environments
-Version: 1.23.1
+Version: 1.23.2
 Summary: Kaggle Environments
 Author-email: Kaggle <support@kaggle.com>
 Requires-Python: >=3.10

kaggle_environments-1.23.2/VISUALIZER_README.md

@@ -0,0 +1,89 @@
+# Kaggle Environments Visualizer Development
+
+This document provides technical guidance for developers working on simulation visualizers. It covers the current Vite-based development workflow and explains the legacy Cloud Function-based system for historical context.
+
+## How to Develop a Visualizer (Vite Workflow)
+
+All new visualizers are developed as standalone packages within a `pnpm` monorepo. This approach uses Vite for a fast, modern development experience with hot-reloading and generates static assets for production.
+
+### 1. Directory Structure
+
+Each visualizer lives in its own package directory. To create a new visualizer for a game named `my-game`, you would create the following structure:
+
+```
+/kaggle_environments
+└── envs/
+    └── my-game/
+        ├── my-game.py
+        └── visualizer/
+            └── default/
+                ├── src/
+                │   └── main.ts         // Your visualizer's entry point
+                ├── index.html          // The HTML entry point for Vite
+                ├── package.json        // Defines dependencies (e.g., three.js)
+                ├── tsconfig.json       // TypeScript configuration
+                └── vite.config.ts      // Vite configuration (can often extend a base config)
+```
+
+### 2. Development Workflow
+
+1.  **Install Dependencies**: From the root of the `kaggle-environments` repository, run `pnpm install`. This will install all dependencies for all visualizer packages.
+
+2.  **Run the Dev Server**: To start the development server for a specific visualizer, use the `--filter` flag with the `pnpm dev` script. For example, to run the `connectx` visualizer:
+
+    ```bash
+    # The package name is defined in kaggle_environments/envs/connectx/visualizer/default/package.json
+    pnpm --filter @kaggle-environments/connectx-visualizer dev
+    ```
+
+    This will start a local server with hot-reloading, allowing you to see your changes instantly.
+
+    You can also run the dev server from the folder you are working in, or just run `pnpm dev` from the root of the repository and a selector will find the currently existing visualizers
+
+### 3. Data Handling
+
+Visualizers are rendered inside an iframe on the Kaggle platform. The replay data is not loaded directly by the visualizer. Instead, it is passed from the parent window using `window.postMessage`.
+
+Your `main.ts` file should include a listener to receive this data:
+
+```typescript
+// src/main.ts
+
+window.addEventListener("message", (event) => {
+  const replayData = event.data;
+
+  render(replayData);
+});
+
+function render(data) {
+  console.log("Received data:", data);
+}
+```
+
+A test replay file (e.g., `replays/test-replay.json`) is often included in the visualizer package to allow for local development and testing of the rendering logic.
+
+### 4. Building for Production
+
+To create a production-ready build, run the build script from the root directory:
+
+```bash
+pnpm build
+```
+
+This command iterates through all visualizer packages and runs `vite build` for each one, generating a `dist` directory containing the optimized static HTML, JavaScript, and CSS files. These are the files that will be deployed to Google Cloud Storage (GCS).
+
+---
+
+## How the Legacy System Worked (Cloud Function)
+
+The previous system relied on a Google Cloud Function to render visualizers on the server side. This process is now deprecated but is documented here for context.
+
+### Rendering Process
+
+1.  **Request**: A user's browser requested a replay from the Kaggle backend.
+2.  **Cloud Function Invocation**: If a pre-rendered static HTML file was not available in GCS, the backend invoked a Cloud Function.
+3.  **File Fetching**: The Cloud Function would fetch the necessary raw assets from the repository, such as a generic `player.html` template and the game-specific JavaScript file (e.g., `connectx.js`).
+4.  **On-the-Fly Bundling**: The function would dynamically inject the game's JavaScript and the replay JSON data directly into the HTML template. The replay data was often placed inside a `<script>` tag as a global variable.
+5.  **Response**: The fully-formed HTML file was returned to the user's browser and rendered.
+
+This server-side rendering approach was slow and made for a difficult developer experience, which is why the project was migrated to the current static-site generation model.

kaggle_environments-1.23.2/cicd/cloudbuild.yaml

@@ -0,0 +1,37 @@
+steps:
+  # Step 1: Install dependencies and build all static assets.
+  # This runs our 'build-ci' script which builds all visualizers and
+  # collects the artifacts into a single './build' directory.
+  # If this gets much more complicated, we should make a bash or docker file.
+  - name: "gcr.io/cloud-builders/npm"
+    id: "build-all-visualizers"
+    entrypoint: "bash"
+    args:
+      - "-c"
+      - |
+        set -e
+        apt-get update && apt-get install -y jq
+        npm install -g pnpm
+        pnpm install
+        pnpm build-ci
+
+  # Step 2: Deploy the collected artifacts to Google Cloud Storage.
+  # 'rsync -d' syncs the directory and deletes any files in the destination
+  # that are not in the source, We probably want to change this to keep versions
+  # once we figure out a decent versioning scheme.
+  - name: "gcr.io/cloud-builders/gcloud"
+    id: "deploy-to-gcs"
+    entrypoint: "gsutil"
+    args:
+      - "-m"
+      - "rsync"
+      - "-d"
+      - "-r"
+      - "./build"
+      - "gs://$_BUCKET_NAME/episode-visualizers"
+    waitFor: ["build-all-visualizers"]
+
+substitutions:
+  _BUCKET_NAME: "kaggle-static"
+
+tags: ["kaggle-environments", "visualizer-deployment"]

{kaggle_environments-1.23.1 → kaggle_environments-1.23.2}/docker/cicd-publish-to-pypi.sh

@@ -71,6 +71,10 @@ else
     echo "❌ Failed to find package on PyPI after $MAX_RETRIES attempts. Aborting."
     exit 1
   fi
+  # --- SAFETY BUFFER ---
+  # The package is available, but let's wait a bit longer for CDN propagation.
+  echo "Waiting 45 seconds as a safety buffer for CDN propagation..."
+  sleep 45
   # --- RETRY LOGIC END ---
 
   echo "Successfully published and verified. Updating Cloud Run requirements at $CLOUD_RUN_REQS_PATH..."

kaggle_environments-1.23.2/eslint.config.mjs

@@ -0,0 +1,14 @@
+import eslint from "@eslint/js";
+import { defineConfig } from "eslint/config";
+import tseslint from "typescript-eslint";
+
+export default defineConfig([
+  eslint.configs.recommended,
+  tseslint.configs.recommended,
+  {
+    files: ["**/*.ts", "**/*.tsx", "**/*.d.ts"], // Apply these rules only to TypeScript files
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+    },
+  },
+]);

kaggle_environments-1.23.2/kaggle_environments/envs/connectx/visualizer/default/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ConnectX Visualizer</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

kaggle_environments-1.23.2/kaggle_environments/envs/connectx/visualizer/default/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@kaggle-environments/connectx-visualizer",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "cross-env VITE_REPLAY_FILE=./replays/test-replay.json vite",
+    "dev:iframe": "vite",
+    "build": "tsc && vite build",
+    "preview": "vite preview"
+  },
+  "devDependencies": {
+    "cross-env": "^10.1.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0"
+  },
+  "dependencies": {
+    "@kaggle-environments/core": "workspace:*",
+    "htm": "^3.1.1",
+    "preact": "^10.27.2"
+  }
+}