@playcademy/vite-plugin 0.0.1-beta.2 → 0.0.1-beta.20

package/dist/lib/manifest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Manifest generation and build output functionality
+ */
+import type { ResolvedConfig } from 'vite';
+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

@@ -0,0 +1,3 @@
+import type { ResolvedConfig } from 'vite';
+import type { SandboxManager } from '../types';
+export declare function startSandbox(viteConfig: ResolvedConfig, autoStart?: boolean, verbose?: boolean, customUrl?: string): Promise<SandboxManager>;

package/dist/lib/server.d.ts

@@ -0,0 +1,3 @@
+import type { ViteDevServer } from 'vite';
+import type { SandboxManager } from '../types';
+export declare function devServerMiddleware(server: ViteDevServer, sandbox: SandboxManager): void;

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 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;
+}
+/**
+ * Main plugin configuration options
+ */
+export interface PlaycademyPluginOptions {
+    export?: PlaycademyExportOptions;
+    sandbox?: PlaycademySandboxOptions;
+}
+/**
+ * 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

@@ -0,0 +1,8 @@
+/**
+ * Utility functions for the Playcademy Vite plugin
+ */
+import type { ResolvedConfig } from 'vite';
+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>;

package/package.json

@@ -1,28 +1,38 @@
 {
     "name": "@playcademy/vite-plugin",
+    "version": "0.0.1-beta.20",
     "type": "module",
-    "version": "0.0.1-beta.2",
-    "module": "src/index.ts",
     "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": "bun build.ts",
-        "pub": "bun run build && bunx bumpp --no-tag --no-push -m \"chore(@playcademy/vite-plugin): release v{version}\" && bun publish --access public"
+        "build": "rm -rf dist && bun build.ts",
+        "bump": "SKIP_TESTS=1 bunx bumpp --no-tag --no-push -c \"chore(@playcademy/vite-plugin): release v%s\"",
+        "pub": "bun run build && bun run bump && bun publish --access public"
+    },
+    "dependencies": {
+        "archiver": "^7.0.1",
+        "picocolors": "^1.1.1"
     },
     "devDependencies": {
-        "@playcademy/types": "latest",
+        "@playcademy/sandbox": "0.1.0-beta.14",
         "@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"
     }
 }

package/build.ts

@@ -1,45 +0,0 @@
-import { $ } from 'bun'
-import packageJson from './package.json' assert { type: 'json' }
-import yoctoSpinner from 'yocto-spinner'
-
-const startTime = performance.now()
-const spinner = yoctoSpinner({ text: 'Building JavaScript...' }).start()
-
-const buildDir = './dist'
-const entrypoints = ['./src/index.ts']
-
-try {
-    await $`rm -rf ${buildDir}`
-
-    await Bun.build({
-        entrypoints,
-        external: [...Object.keys(packageJson.peerDependencies)],
-        outdir: buildDir,
-        format: 'esm',
-        target: 'node',
-    })
-
-    spinner.text = 'Generating types...'
-
-    const { stderr } =
-        await $`tsc --emitDeclarationOnly --declaration --project tsconfig.types.json --outDir ${buildDir}`
-
-    if (stderr.toString().length) {
-        spinner.error(`Type generation failed:\n${stderr.toString()}`)
-        process.exit(1) // Exit with error code
-    } else {
-        const duration = ((performance.now() - startTime) / 1000).toFixed(2)
-        spinner.success(`Build complete in ${duration}s!`)
-
-        // Log built entrypoints
-        for (const entry of entrypoints) {
-            console.log(`  - ${entry}`)
-        }
-    }
-    process.exit(0)
-} catch (error) {
-    const duration = ((performance.now() - startTime) / 1000).toFixed(2)
-    console.log({ error })
-    spinner.error(`Build failed in ${duration}s: ${error}`)
-    process.exit(1) // Exit with error code
-}

package/src/index.ts

@@ -1,219 +0,0 @@
-import path from 'node:path'
-import fs from 'node:fs/promises'
-import { createWriteStream } from 'node:fs'
-import archiver from 'archiver'
-import pc from 'picocolors'
-
-import type { Plugin, ResolvedConfig } from 'vite'
-import type { ManifestV1 } from '@playcademy/types'
-
-export interface PlaycademyPluginOptions {
-    bootMode?: ManifestV1['bootMode']
-    entryPoint?: string
-    styles?: string[]
-    engine?: ManifestV1['engine']
-    autoZip?: boolean
-}
-
-const LOG_LINE_TOTAL_WIDTH = 60
-
-interface PlaycademyOutputData {
-    manifestPath?: string
-    manifestSizeKb?: string
-    zipPath?: string
-    zipSizeKb?: string
-}
-
-function formatNumberWithCommas(numStr: string): string {
-    if (!numStr) return numStr
-    const parts = numStr.split('.')
-    if (parts[0] === undefined) return numStr
-    parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',')
-    return parts.join('.')
-}
-
-async function generatePlaycademyManifest(
-    config: ResolvedConfig,
-    options: Required<Omit<PlaycademyPluginOptions, 'autoZip'>>,
-    outDir: string,
-    buildOutputs: PlaycademyOutputData,
-) {
-    const manifestData: ManifestV1 = {
-        version: '1',
-        bootMode: options.bootMode,
-        entryPoint: options.entryPoint,
-        styles: options.styles || [],
-        engine: options.engine || 'custom',
-        createdAt: new Date().toISOString(),
-    }
-
-    const manifestPath = path.resolve(outDir, 'playcademy.manifest.json')
-    const manifestJson = JSON.stringify(manifestData, null, 2)
-
-    await fs.writeFile(manifestPath, manifestJson)
-
-    try {
-        const stats = await fs.stat(manifestPath)
-        buildOutputs.manifestPath = path.relative(config.root, manifestPath)
-        buildOutputs.manifestSizeKb = (stats.size / 1024).toFixed(2)
-    } catch (statError) {
-        config.logger.warn(
-            `[Playcademy] Could not get stats for manifest file: ${statError}`,
-        )
-    }
-}
-
-async function createOutputZipArchive(
-    config: ResolvedConfig,
-    outDir: string,
-    buildOutputs: PlaycademyOutputData,
-) {
-    const projectRoot = path.resolve(config.root)
-    const projectName = path.basename(projectRoot)
-    const playcademyDir = path.resolve(projectRoot, '.playcademy')
-
-    await fs.mkdir(playcademyDir, { recursive: true })
-
-    const zipName = `${projectName}.zip`
-    const zipOutPath = path.resolve(playcademyDir, zipName)
-
-    const output = createWriteStream(zipOutPath)
-    const archive = archiver('zip', {
-        zlib: { level: 9 },
-    })
-
-    await new Promise<void>((resolve, reject) => {
-        output.on('close', () => {
-            buildOutputs.zipPath = path.relative(config.root, zipOutPath)
-            buildOutputs.zipSizeKb = (archive.pointer() / 1024).toFixed(2)
-            resolve()
-        })
-        output.on('error', reject)
-        archive.pipe(output)
-        archive.directory(outDir, false)
-        archive.finalize()
-    })
-}
-
-function performPlaycademyLogging(
-    config: ResolvedConfig,
-    buildOutputs: PlaycademyOutputData,
-) {
-    if (!buildOutputs.manifestPath && !buildOutputs.zipSizeKb) {
-        return
-    }
-
-    config.logger.info('') // newline
-    config.logger.info(pc.magenta('[Playcademy]'))
-
-    if (buildOutputs.manifestPath && buildOutputs.manifestSizeKb) {
-        const dir = path.dirname(buildOutputs.manifestPath)
-        const file = path.basename(buildOutputs.manifestPath)
-        const uncoloredPathLength =
-            (dir === '.' ? 0 : dir.length + 1) + file.length
-        const coloredPath = `${pc.dim(dir === '.' ? '' : dir + '/')}${pc.green(file)}`
-
-        const formattedNumber = formatNumberWithCommas(
-            buildOutputs.manifestSizeKb!,
-        )
-        const sizeString = `${formattedNumber} kB`
-        const formattedSize = pc.bold(pc.yellow(sizeString))
-
-        const paddingNeeded = Math.max(
-            2,
-            LOG_LINE_TOTAL_WIDTH - uncoloredPathLength - sizeString.length,
-        )
-        const paddingSpaces = ' '.repeat(paddingNeeded)
-
-        config.logger.info(`${coloredPath}${paddingSpaces}${formattedSize}`)
-    }
-
-    if (buildOutputs.zipPath && buildOutputs.zipSizeKb) {
-        let dir = path.dirname(buildOutputs.zipPath)
-        const file = path.basename(buildOutputs.zipPath)
-        if (dir === '.') dir = ''
-        const uncoloredPathLength = (dir ? dir.length + 1 : 0) + file.length
-        const coloredPath = `${dir ? pc.dim(dir + '/') : ''}${pc.green(file)}`
-
-        const formattedNumber = formatNumberWithCommas(buildOutputs.zipSizeKb!)
-        const sizeString = `${formattedNumber} kB`
-        const formattedSize = pc.bold(pc.yellow(sizeString))
-
-        const paddingNeeded = Math.max(
-            2,
-            LOG_LINE_TOTAL_WIDTH - uncoloredPathLength - sizeString.length,
-        )
-        const paddingSpaces = ' '.repeat(paddingNeeded)
-
-        config.logger.info(`${coloredPath}${paddingSpaces}${formattedSize}`)
-    }
-
-    config.logger.info('') // newline
-}
-
-export function playcademy(options: PlaycademyPluginOptions = {}): Plugin {
-    let viteConfig: ResolvedConfig
-    let currentBuildOutputs: PlaycademyOutputData = {}
-
-    const finalOptions = {
-        bootMode: options.bootMode ?? 'iframe',
-        entryPoint: options.entryPoint ?? 'index.html',
-        styles: options.styles ?? [],
-        engine: options.engine ?? 'custom',
-        autoZip: process.env.CI === 'true' ? false : (options.autoZip ?? false),
-    }
-
-    return {
-        name: 'vite-plugin-playcademy',
-
-        config(userConfig) {
-            if (userConfig.base === undefined) {
-                return {
-                    base: './',
-                }
-            }
-            return {}
-        },
-
-        configResolved(resolvedConfig) {
-            viteConfig = resolvedConfig
-            currentBuildOutputs = {}
-        },
-
-        async writeBundle() {
-            const outDir =
-                viteConfig.build.outDir || path.join(process.cwd(), 'dist')
-
-            try {
-                await generatePlaycademyManifest(
-                    viteConfig,
-                    finalOptions,
-                    outDir,
-                    currentBuildOutputs,
-                )
-                if (finalOptions.autoZip) {
-                    await createOutputZipArchive(
-                        viteConfig,
-                        outDir,
-                        currentBuildOutputs,
-                    )
-                }
-            } catch (error) {
-                if (
-                    error instanceof Error &&
-                    error.message.includes('[Playcademy]')
-                ) {
-                    viteConfig.logger.error(error.message)
-                } else {
-                    viteConfig.logger.error(
-                        `[Playcademy] An unexpected error occurred during writeBundle: ${error instanceof Error ? error.message : String(error)}`,
-                    )
-                }
-            }
-        },
-
-        closeBundle() {
-            performPlaycademyLogging(viteConfig, currentBuildOutputs)
-        },
-    }
-}

package/sst-env.d.ts

@@ -1,9 +0,0 @@
-/* This file is auto-generated by SST. Do not edit. */
-/* tslint:disable */
-/* eslint-disable */
-/* deno-fmt-ignore-file */
-
-/// <reference path="../../sst-env.d.ts" />
-
-import "sst"
-export {}

package/tsconfig.json

@@ -1,28 +0,0 @@
-{
-    "compilerOptions": {
-        // Environment setup & latest features
-        "lib": ["ESNext"],
-        "target": "ESNext",
-        "module": "ESNext",
-        "moduleDetection": "force",
-        "jsx": "react-jsx",
-        "allowJs": true,
-
-        // Bundler mode
-        "moduleResolution": "bundler",
-        "allowImportingTsExtensions": true,
-        "verbatimModuleSyntax": true,
-        "noEmit": true,
-
-        // Best practices
-        "strict": true,
-        "skipLibCheck": true,
-        "noFallthroughCasesInSwitch": true,
-        "noUncheckedIndexedAccess": true,
-
-        // Some stricter flags (disabled by default)
-        "noUnusedLocals": false,
-        "noUnusedParameters": false,
-        "noPropertyAccessFromIndexSignature": false
-    }
-}

package/tsconfig.types.json

@@ -1,13 +0,0 @@
-{
-    "extends": "./tsconfig.json",
-    "compilerOptions": {
-        "noEmit": false,
-        "emitDeclarationOnly": true,
-        "declaration": true,
-        "outDir": "./dist",
-        "rootDir": "./src",
-        "skipLibCheck": true
-    },
-    "include": ["src/**/*.ts"],
-    "exclude": ["node_modules", "**/*.test.ts"]
-}