@bytespell/shella 0.1.18 → 0.2.0

package/dist/src/registry.js

@@ -0,0 +1,176 @@
+import * as fs from 'node:fs/promises';
+import { logger } from './logger.js';
+import { PLUGINS_DIR, REGISTRY_FILE, STATE_DIR } from './paths.js';
+import { DAEMON_PORT } from './types.js';
+export class Registry {
+    data = {
+        daemonPid: process.pid,
+        daemonPort: DAEMON_PORT,
+        plugins: {},
+    };
+    async ensureDirectories() {
+        try {
+            await Promise.all([
+                fs.mkdir(PLUGINS_DIR, { recursive: true }),
+                fs.mkdir(STATE_DIR, { recursive: true }),
+            ]);
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to create directories');
+            throw err;
+        }
+    }
+    async ensurePluginsDir() {
+        try {
+            await fs.mkdir(PLUGINS_DIR, { recursive: true });
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to create plugins directory');
+            throw err;
+        }
+    }
+    getPluginsDir() {
+        return PLUGINS_DIR;
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(REGISTRY_FILE, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (this.isValidRegistryData(parsed)) {
+                this.data = parsed;
+                this.data.daemonPid = process.pid;
+            }
+        }
+        catch {
+            // File doesn't exist or is invalid, start fresh
+            this.data = {
+                daemonPid: process.pid,
+                daemonPort: DAEMON_PORT,
+                plugins: {},
+            };
+        }
+    }
+    isValidPanelNode(value) {
+        if (typeof value !== 'object' || value === null) {
+            return false;
+        }
+        const node = value;
+        if (typeof node.id !== 'string') {
+            return false;
+        }
+        if (node.type === 'leaf') {
+            // Optional pluginName and instanceId must be strings if present
+            if (node.pluginName !== undefined && typeof node.pluginName !== 'string') {
+                return false;
+            }
+            if (node.instanceId !== undefined && typeof node.instanceId !== 'string') {
+                return false;
+            }
+            return true;
+        }
+        if (node.type === 'split') {
+            if (node.direction !== 'horizontal' && node.direction !== 'vertical') {
+                return false;
+            }
+            if (!Array.isArray(node.children) || node.children.length !== 2) {
+                return false;
+            }
+            if (!Array.isArray(node.sizes) || node.sizes.length !== 2) {
+                return false;
+            }
+            if (typeof node.sizes[0] !== 'number' ||
+                typeof node.sizes[1] !== 'number' ||
+                !Number.isFinite(node.sizes[0]) ||
+                !Number.isFinite(node.sizes[1])) {
+                return false;
+            }
+            // Recursively validate children
+            return this.isValidPanelNode(node.children[0]) && this.isValidPanelNode(node.children[1]);
+        }
+        return false;
+    }
+    isValidLayout(value) {
+        if (typeof value !== 'object' || value === null) {
+            return false;
+        }
+        const layout = value;
+        if (layout.version !== 1) {
+            return false;
+        }
+        if (layout.root === null) {
+            return true;
+        }
+        return this.isValidPanelNode(layout.root);
+    }
+    isValidRegistryData(data) {
+        if (typeof data !== 'object' || data === null) {
+            return false;
+        }
+        const obj = data;
+        if (typeof obj.daemonPid !== 'number' ||
+            typeof obj.daemonPort !== 'number' ||
+            typeof obj.plugins !== 'object' ||
+            obj.plugins === null) {
+            return false;
+        }
+        // Validate each plugin has the new instances array structure
+        const plugins = obj.plugins;
+        for (const plugin of Object.values(plugins)) {
+            if (typeof plugin !== 'object' || plugin === null) {
+                return false;
+            }
+            const p = plugin;
+            if (!Array.isArray(p.instances)) {
+                return false;
+            }
+        }
+        // Layout is optional, but if present must be valid - if invalid, drop it
+        if (obj.layout !== undefined && !this.isValidLayout(obj.layout)) {
+            delete obj.layout;
+        }
+        return true;
+    }
+    async save() {
+        try {
+            await fs.mkdir(STATE_DIR, { recursive: true });
+            await fs.writeFile(REGISTRY_FILE, JSON.stringify(this.data, null, 2), 'utf-8');
+            logger.debug('Registry saved');
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to save registry');
+        }
+    }
+    async cleanup() {
+        try {
+            await fs.unlink(REGISTRY_FILE);
+            logger.debug('Registry file cleaned up');
+        }
+        catch {
+            // File might not exist, ignore
+        }
+    }
+    updatePlugin(plugin) {
+        this.data.plugins[plugin.name] = plugin;
+    }
+    removePlugin(name) {
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete this.data.plugins[name];
+    }
+    getPlugin(name) {
+        return this.data.plugins[name];
+    }
+    getAllPlugins() {
+        return Object.values(this.data.plugins);
+    }
+    getLayout() {
+        return this.data.layout ?? { version: 1, root: null };
+    }
+    setLayout(layout) {
+        this.data.layout = layout;
+    }
+    getData() {
+        return { ...this.data };
+    }
+}
+export const registry = new Registry();
+//# sourceMappingURL=registry.js.map

package/dist/src/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,62 @@
+import type { ChildProcess } from 'node:child_process';
+export type PluginStatus = 'stopped' | 'starting' | 'running' | 'crashed' | 'installing';
+export interface PluginMetadata {
+    displayName?: string;
+    devCommand?: string;
+}
+export interface PluginInstance {
+    id: string;
+    status: PluginStatus;
+    port: number | null;
+    pid: number | null;
+    url: string | null;
+    error?: string;
+    devMode?: boolean;
+}
+export interface PluginInfo {
+    name: string;
+    displayName: string;
+    path: string;
+    main: string;
+    devCommand?: string;
+    instances: PluginInstance[];
+}
+export interface PluginProcess {
+    info: PluginInfo;
+    processes: Map<string, ChildProcess>;
+    nextInstanceId: number;
+}
+export interface RegistryData {
+    daemonPid: number;
+    daemonPort: number;
+    plugins: Record<string, PluginInfo>;
+    layout?: LayoutState;
+}
+export interface PackageJson {
+    name?: string;
+    main?: string;
+    shella?: PluginMetadata;
+}
+export declare const DAEMON_PORT = 47100;
+export declare const PLUGIN_PORT_MIN = 47101;
+export declare const PLUGIN_PORT_MAX = 47199;
+export type SplitDirection = 'horizontal' | 'vertical';
+export interface LeafPanel {
+    type: 'leaf';
+    id: string;
+    pluginName?: string;
+    instanceId?: string;
+}
+export interface SplitPanel {
+    type: 'split';
+    id: string;
+    direction: SplitDirection;
+    children: [PanelNode, PanelNode];
+    sizes: [number, number];
+}
+export type PanelNode = LeafPanel | SplitPanel;
+export interface LayoutState {
+    version: 1;
+    root: PanelNode | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AAEzF,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzB;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB"}

package/dist/src/types.js

@@ -0,0 +1,4 @@
+export const DAEMON_PORT = 47100;
+export const PLUGIN_PORT_MIN = 47101;
+export const PLUGIN_PORT_MAX = 47199;
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AA+CA,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC"}

package/dist/src/watcher.d.ts

@@ -0,0 +1,11 @@
+export declare class PluginWatcher {
+    private watcher;
+    private knownPlugins;
+    private debounceTimers;
+    start(): Promise<void>;
+    private handleChange;
+    private processChange;
+    stop(): void;
+}
+export declare const pluginWatcher: PluginWatcher;
+//# sourceMappingURL=watcher.d.ts.map

package/dist/src/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/watcher.ts"],"names":[],"mappings":"AAMA,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,YAAY,CAA0B;IAC9C,OAAO,CAAC,cAAc,CAA0C;IAE1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B5B,OAAO,CAAC,YAAY;YAoBN,aAAa;IAkD3B,IAAI,IAAI,IAAI;CAab;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/src/watcher.js

@@ -0,0 +1,111 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { logger } from './logger.js';
+import { pluginManager } from './plugin-manager.js';
+import { registry } from './registry.js';
+export class PluginWatcher {
+    watcher = null;
+    knownPlugins = new Set();
+    debounceTimers = new Map();
+    async start() {
+        const pluginsDir = registry.getPluginsDir();
+        // Initialize known plugins
+        const plugins = await pluginManager.discoverPlugins();
+        for (const name of plugins) {
+            this.knownPlugins.add(name);
+        }
+        try {
+            this.watcher = fs.watch(pluginsDir, { persistent: true }, (eventType, filename) => {
+                if (filename !== null) {
+                    this.handleChange(eventType, filename);
+                }
+            });
+            this.watcher.on('error', (err) => {
+                logger.error({ err }, 'Watcher error');
+            });
+            logger.info({ pluginsDir }, 'Started watching plugins directory');
+        }
+        catch (err) {
+            logger.error({ err, pluginsDir }, 'Failed to start watcher');
+            throw err;
+        }
+    }
+    handleChange(eventType, filename) {
+        // Ignore hidden files and .registry.json
+        if (filename.startsWith('.')) {
+            return;
+        }
+        // Debounce rapid changes
+        const existingTimer = this.debounceTimers.get(filename);
+        if (existingTimer !== undefined) {
+            clearTimeout(existingTimer);
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(filename);
+            void this.processChange(eventType, filename);
+        }, 500);
+        this.debounceTimers.set(filename, timer);
+    }
+    async processChange(_eventType, filename) {
+        const pluginsDir = registry.getPluginsDir();
+        const pluginPath = path.join(pluginsDir, filename);
+        try {
+            const stats = await fs.promises.stat(pluginPath);
+            if (!stats.isDirectory()) {
+                return;
+            }
+            // Check if it has a package.json
+            try {
+                await fs.promises.access(path.join(pluginPath, 'package.json'));
+            }
+            catch {
+                // No package.json, not a valid plugin
+                if (this.knownPlugins.has(filename)) {
+                    // Plugin was removed or became invalid
+                    this.knownPlugins.delete(filename);
+                    await pluginManager.handleRemovedPlugin(filename);
+                }
+                return;
+            }
+            if (!this.knownPlugins.has(filename)) {
+                // Check for initialization marker - if present, plugin is still being set up
+                const markerPath = path.join(pluginPath, '.shella-initializing');
+                try {
+                    await fs.promises.access(markerPath);
+                    logger.debug({ plugin: filename }, 'Plugin still initializing, skipping');
+                    return;
+                }
+                catch {
+                    // No marker - plugin is ready
+                }
+                this.knownPlugins.add(filename);
+                await pluginManager.handleNewPlugin(filename);
+            }
+            else {
+                // Existing plugin was modified - refresh metadata in case package.json changed
+                await pluginManager.refreshPluginMetadata(filename);
+            }
+        }
+        catch {
+            // Directory was removed
+            if (this.knownPlugins.has(filename)) {
+                this.knownPlugins.delete(filename);
+                await pluginManager.handleRemovedPlugin(filename);
+            }
+        }
+    }
+    stop() {
+        if (this.watcher !== null) {
+            this.watcher.close();
+            this.watcher = null;
+            logger.info('Stopped watching plugins directory');
+        }
+        // Clear any pending debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+    }
+}
+export const pluginWatcher = new PluginWatcher();
+//# sourceMappingURL=watcher.js.map

package/dist/src/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,89 +1,61 @@
 {
   "name": "@bytespell/shella",
-  "version": "0.1.18",
-  "description": "run inference on your own machine over http",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/bytespell-oss/shella"
-  },
+  "version": "0.2.0",
   "type": "module",
-  "exports": {
-    ".": "./dist/index.js",
-    "./client": "./client/main.tsx"
-  },
+  "description": "Hot-reloadable plugin-based UI platform",
+  "main": "dist/index.js",
   "bin": {
-    "shella": "./dist/bin/cli.js"
+    "shella": "./dist/bin/shella-daemon.js",
+    "shella-init": "./dist/bin/shella-init.js"
   },
   "files": [
-    "dist/",
-    "public/"
+    "dist",
+    "templates"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "dev": "concurrently \"tsx watch src/server.ts\" \"vite\"",
-    "build": "npm run build:vendor && npm run build:client && npm run build:server && cp -r public dist/",
-    "build:vendor": "tsx scripts/build-vendor.ts",
-    "build:client": "vite build",
-    "build:server": "tsup",
-    "preview": "vite preview",
-    "db:generate": "drizzle-kit generate",
-    "db:migrate": "drizzle-kit migrate",
-    "db:push": "drizzle-kit push",
-    "db:studio": "drizzle-kit studio"
+    "build": "tsc",
+    "start": "node dist/bin/shella-daemon.js",
+    "dev": "tsx bin/shella-daemon.ts",
+    "lint": "eslint src bin --ext .ts",
+    "lint:fix": "eslint src bin --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\" \"bin/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"bin/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
+  "keywords": [
+    "shella",
+    "plugin",
+    "ui",
+    "hot-reload",
+    "daemon"
+  ],
+  "author": "bytespell",
+  "license": "MIT",
   "dependencies": {
-    "@base-ui/react": "^1.0.0",
     "@clack/prompts": "^0.11.0",
-    "@fontsource/inter": "^5.2.8",
-    "@formkit/auto-animate": "^0.9.0",
-    "@pierre/diffs": "^1.0.4",
-    "@tanstack/react-query": "^5.90.16",
-    "@trpc/client": "^11.8.1",
-    "@trpc/react-query": "^11.8.1",
-    "@trpc/server": "^11.8.1",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-web-links": "^0.12.0",
-    "@xterm/addon-webgl": "^0.19.0",
-    "@xterm/xterm": "^6.0.0",
-    "ai": "^6.0.6",
-    "bonjour-service": "^1.3.0",
-    "chokidar": "^5.0.0",
-    "class-variance-authority": "^0.7.1",
-    "clsx": "^2.1.1",
-    "cmdk": "^1.1.1",
-    "commander": "^12.0.0",
-    "diff": "^5.2.0",
-    "drizzle-orm": "^0.45.1",
-    "embla-carousel-react": "^8.6.0",
-    "esbuild": "^0.27.2",
-    "express": "^5.2.1",
-    "glob": "^13.0.0",
-    "lucide-react": "^0.562.0",
-    "nanoid": "^5.1.6",
-    "radix-ui": "^1.4.3",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "shadcn": "^3.6.2",
-    "shiki": "^3.20.0",
-    "streamdown": "^1.6.10",
-    "tailwind-merge": "^3.4.0",
-    "tailwindcss": "^4.1.17",
-    "tw-animate-css": "^1.4.0",
-    "use-stick-to-bottom": "^1.1.1",
-    "ws": "^8.19.0",
-    "zod": "^3.25.49",
-    "zustand": "^5.0.9"
+    "express": "^4.21.0",
+    "pino": "^9.4.0",
+    "pino-pretty": "^11.2.0",
+    "tsx": "^4.19.0"
   },
   "devDependencies": {
-    "@tailwindcss/vite": "^4.1.17",
-    "@types/diff": "^7.0.2",
-    "@types/express": "^5.0.6",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
-    "@types/react-dom": "^19.2.3",
-    "@types/ws": "^8.18.1",
-    "@vitejs/plugin-react": "^5.1.1",
-    "@welldone-software/why-did-you-render": "^10.0.1",
-    "drizzle-kit": "^0.31.4",
-    "vite": "^7.2.4"
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
   }
 }

package/templates/express/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "shella-plugin",
+  "version": "1.0.0",
+  "main": "server.js",
+  "shella": {
+    "displayName": "My Plugin"
+  },
+  "dependencies": {
+    "express": "^4.18.0"
+  }
+}

package/templates/express/public/index.html

@@ -0,0 +1,64 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Shella Plugin</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: system-ui, -apple-system, sans-serif;
+      background: #0a0a0a;
+      color: #fafafa;
+      min-height: 100vh;
+      padding: 2rem;
+    }
+    .container { max-width: 600px; margin: 0 auto; }
+    h1 { margin-bottom: 1rem; }
+    .card {
+      background: #1a1a1a;
+      border: 1px solid #333;
+      border-radius: 8px;
+      padding: 1.5rem;
+      margin-bottom: 1rem;
+    }
+    button {
+      background: #fff;
+      color: #000;
+      border: none;
+      padding: 0.5rem 1rem;
+      border-radius: 4px;
+      cursor: pointer;
+      font-size: 1rem;
+    }
+    button:hover { background: #ddd; }
+    #result {
+      margin-top: 1rem;
+      padding: 1rem;
+      background: #262626;
+      border-radius: 4px;
+      display: none;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <h1>Shella Plugin</h1>
+    <div class="card">
+      <p>This is your plugin scaffold. Edit this file and server.js to build your UI.</p>
+      <br>
+      <button onclick="testApi()">Test API</button>
+      <div id="result"></div>
+    </div>
+  </div>
+  <script>
+    async function testApi() {
+      const res = await fetch('/api/hello');
+      const data = await res.json();
+      const result = document.getElementById('result');
+      result.style.display = 'block';
+      result.textContent = JSON.stringify(data, null, 2);
+    }
+  </script>
+</body>
+</html>

package/templates/express/server.js

@@ -0,0 +1,37 @@
+const express = require('express');
+const path = require('path');
+
+const app = express();
+const PORT = process.env.PORT;
+
+// Allow embedding in iframes (for shella-web)
+app.use((req, res, next) => {
+  res.setHeader('Content-Security-Policy', "frame-ancestors *");
+  next();
+});
+
+// Middleware
+app.use(express.json());
+app.use(express.static(path.join(__dirname, 'public')));
+
+// API routes
+app.get('/api/hello', (req, res) => {
+  res.json({ message: 'Hello from the plugin!' });
+});
+
+// Add your API endpoints here
+// Example: Import from parent project
+// const { someFunction } = require('../src/mymodule.js');
+// app.post('/api/analyze', async (req, res) => {
+//   const result = await someFunction(req.body);
+//   res.json(result);
+// });
+
+const server = app.listen(PORT, () => {
+  console.log(`Plugin running on port ${PORT}`);
+});
+
+// Graceful shutdown
+process.on('SIGTERM', () => {
+  server.close(() => process.exit(0));
+});

package/templates/shadcn/README.md

@@ -0,0 +1,3 @@
+# React + TypeScript + Vite + shadcn/ui
+
+This is a template for a new Vite project with React, TypeScript, and shadcn/ui.