@playcademy/vite-plugin 0.0.1-beta.9 → 0.1.1

package/dist/lib/cli-server.d.ts

@@ -0,0 +1,27 @@
+import { startPlaycademyDevServer } from 'playcademy/utils';
+import type { PlaycademyConfig } from 'playcademy/types';
+import type { ResolvedConfig } from 'vite';
+/**
+ * Determines if the CLI dev server is needed based on configuration.
+ * Checks for integrations or custom routes that require the game backend.
+ *
+ * @param config - Playcademy configuration
+ * @returns True if CLI dev server is needed
+ */
+export declare function needsCliDevServer(config: PlaycademyConfig): boolean;
+interface CliServerManager {
+    server: Awaited<ReturnType<typeof startPlaycademyDevServer>>;
+    stopHotReload: () => void;
+}
+export interface CliDevServerOptions {
+    port: number;
+    config: PlaycademyConfig;
+    viteConfig: ResolvedConfig;
+    platformUrl?: string;
+}
+/**
+ * Starts the CLI dev server with hot reload enabled.
+ * Used by the Vite plugin to manage the game backend server.
+ */
+export declare function startCliDevServer(options: CliDevServerOptions): Promise<CliServerManager>;
+export {};

package/dist/lib/logging.d.ts

@@ -0,0 +1,23 @@
+import type { ResolvedConfig } from 'vite';
+import type { ProjectInfo } from '../types';
+/**
+ * Centralized logging utilities for the Vite plugin.
+ * Provides clear, prefixed, and color-coded output for multiple servers.
+ */
+export declare const log: {
+    sandbox: (msg: string) => void;
+    backend: (msg: string) => void;
+    playcademy: (msg: string) => void;
+};
+/**
+ * Prints a startup banner showing all running servers in Vite's style.
+ *
+ * @param viteConfig - Vite resolved configuration
+ * @param servers - Object containing port numbers for each server
+ * @param projectInfo - Project information
+ * @param sandboxVersion - Sandbox version string
+ */
+export declare function printBanner(viteConfig: ResolvedConfig, servers: {
+    sandbox: number;
+    backend?: number;
+}, projectInfo: ProjectInfo, sandboxVersion: string): void;

package/dist/lib/manifest.d.ts

@@ -2,19 +2,7 @@
  * Manifest generation and build output functionality
  */
 import type { ResolvedConfig } from 'vite';
-import type { ManifestV1 } from '@playcademy/types';
-export interface PlaycademyOutputData {
-    manifestPath?: string;
-    manifestSizeKb?: string;
-    zipPath?: string;
-    zipSizeKb?: string;
-}
-export interface ManifestOptions {
-    bootMode: ManifestV1['bootMode'];
-    entryPoint: string;
-    styles: string[];
-    platform: ManifestV1['platform'];
-}
+import type { ManifestOptions, PlaycademyOutputData } from '../types';
 export declare function generatePlaycademyManifest(config: ResolvedConfig, options: ManifestOptions, outDir: string, buildOutputs: PlaycademyOutputData): Promise<void>;
 export declare function createOutputZipArchive(config: ResolvedConfig, outDir: string, buildOutputs: PlaycademyOutputData): Promise<void>;
 export declare function performPlaycademyLogging(config: ResolvedConfig, buildOutputs: PlaycademyOutputData): void;

package/dist/lib/sandbox.d.ts

@@ -1,9 +1,7 @@
-import { type ProjectInfo } from '../utils';
 import type { ResolvedConfig } from 'vite';
-interface SandboxManager {
-    url: string;
-    project: ProjectInfo | null;
-    cleanup: () => void;
-}
-export declare function startSandbox(viteConfig: ResolvedConfig, autoStart?: boolean, verbose?: boolean, customUrl?: string): Promise<SandboxManager>;
-export {};
+import type { SandboxManager } from '../types';
+export declare function startSandbox(viteConfig: ResolvedConfig, autoStart?: boolean, options?: {
+    verbose?: boolean;
+    customUrl?: string;
+    quiet?: boolean;
+}): Promise<SandboxManager>;

package/dist/lib/server.d.ts

@@ -1,3 +1,3 @@
 import type { ViteDevServer } from 'vite';
-import type { ProjectInfo } from '../utils';
-export declare function devServerMiddleware(server: ViteDevServer, sandboxUrl: string, project: ProjectInfo): void;
+import type { SandboxManager } from '../types';
+export declare function devServerMiddleware(server: ViteDevServer, sandbox: SandboxManager, gameUrl: string | undefined, showBadge: boolean): void;

package/dist/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Type definitions for the Playcademy Vite Plugin
+ */
+import type { ManifestV1 } from '@playcademy/data/types';
+/**
+ * Project information extracted from package.json and directory structure
+ */
+export interface ProjectInfo {
+    slug: string;
+    displayName: string;
+    version: string;
+    description?: string;
+}
+/**
+ * Configuration options for exporting Playcademy games
+ */
+export interface PlaycademyExportOptions {
+    bootMode?: ManifestV1['bootMode'];
+    entryPoint?: string;
+    styles?: string[];
+    platform?: ManifestV1['platform'];
+    autoZip?: boolean;
+}
+/**
+ * Configuration options for the Playcademy sandbox server
+ */
+export interface PlaycademySandboxOptions {
+    autoStart?: boolean;
+    url?: string;
+    verbose?: boolean;
+}
+/**
+ * Configuration options for the dev server shell
+ */
+export interface PlaycademyDevOptions {
+    /**
+     * Show the Playcademy badge in the corner during development
+     * @default true
+     */
+    showBadge?: boolean;
+}
+/**
+ * Main plugin configuration options
+ */
+export interface PlaycademyPluginOptions {
+    export?: PlaycademyExportOptions;
+    sandbox?: PlaycademySandboxOptions;
+    dev?: PlaycademyDevOptions;
+}
+/**
+ * Build output data for logging and tracking
+ */
+export interface PlaycademyOutputData {
+    manifestPath?: string;
+    manifestSizeKb?: string;
+    zipPath?: string;
+    zipSizeKb?: string;
+}
+/**
+ * Options for manifest generation
+ */
+export interface ManifestOptions {
+    bootMode: ManifestV1['bootMode'];
+    entryPoint: string;
+    styles: string[];
+    platform: ManifestV1['platform'];
+}
+/**
+ * Sandbox manager interface for controlling sandbox lifecycle
+ */
+export interface SandboxManager {
+    baseUrl: string;
+    realtimeUrl: string;
+    project: ProjectInfo | null;
+    cleanup: () => void;
+}

package/dist/utils.d.ts

@@ -2,12 +2,15 @@
  * Utility functions for the Playcademy Vite plugin
  */
 import type { ResolvedConfig } from 'vite';
-export interface ProjectInfo {
-    slug: string;
-    displayName: string;
-    version: string;
-    description?: string;
-}
+import type { PlaycademyConfig } from '@playcademy/sdk/server';
+import type { ProjectInfo } from './types';
 export declare function extractProjectInfo(viteConfig: ResolvedConfig): ProjectInfo;
 export declare function formatNumberWithCommas(numStr: string): string;
 export declare function findAvailablePort(startPort?: number): Promise<number>;
+/**
+ * Loads the Playcademy configuration from the project root.
+ *
+ * @param viteConfig - Vite resolved configuration
+ * @returns Playcademy configuration or null if not found
+ */
+export declare function loadPlaycademyConfig(viteConfig: ResolvedConfig): Promise<PlaycademyConfig | null>;

package/package.json

@@ -1,34 +1,41 @@
 {
     "name": "@playcademy/vite-plugin",
+    "version": "0.1.1",
     "type": "module",
-    "version": "0.0.1-beta.9",
-    "main": "dist/index.js",
-    "module": "dist/index.js",
     "exports": {
         ".": {
             "import": "./dist/index.js",
             "types": "./dist/index.d.ts"
+        },
+        "./types": {
+            "import": "./dist/types.js",
+            "types": "./dist/types.d.ts"
         }
     },
+    "main": "dist/index.js",
+    "module": "dist/index.js",
     "files": [
         "dist"
     ],
     "scripts": {
         "build": "rm -rf dist && bun build.ts",
-        "pub": "bun run build && bun run bump && bun publish --access public",
-        "bump": "bunx bumpp --no-tag --no-push -c \"chore(@playcademy/vite-plugin): release v%s\""
+        "pub": "bun publish.ts",
+        "docs": "typedoc --skipErrorChecking"
+    },
+    "dependencies": {
+        "archiver": "^7.0.1",
+        "picocolors": "^1.1.1"
     },
     "devDependencies": {
-        "@playcademy/types": "latest",
-        "@playcademy/sandbox": "0.1.0-beta.3",
+        "@inquirer/prompts": "^7.8.6",
+        "@playcademy/sandbox": "0.1.0",
+        "playcademy": "0.11.4",
         "@types/archiver": "^6.0.3",
-        "@types/bun": "latest"
+        "@types/bun": "latest",
+        "yocto-spinner": "^0.2.2"
     },
     "peerDependencies": {
-        "typescript": "^5"
-    },
-    "dependencies": {
-        "archiver": "^7.0.1",
-        "picocolors": "^1.1.1"
+        "typescript": "^5",
+        "vite": "^5 || ^6"
     }
 }