flashts 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZMDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+<div align="center">
+<img src="./client/public/favicon.svg" alt="FlashTS" />
+<h1>FlashTS</h1>
+</div>
+
+FlashTS is an ultra-fast, modern **JavaScript & TypeScript Playground** powered by [Bun](https://bun.sh/). It provides a professional IDE-like experience in the browser with instant execution, multi-file support, and automatic IntelliSense.
+
+## Features
+
+- **Instant Execution**: Powered by Bun's high-performance runtime.
+- **Multi-file Workspace**: Create complex projects with imports and modules.
+- **Smart IntelliSense**: Automatic type injection for NPM packages via Monaco Editor.
+- **Live NPM Manager**: Install and manage dependencies in real-time.
+- **Safe Environment**: Session-based execution for isolated code running.
+
+## Tech Stack
+
+### Frontend (`/client`)
+
+- **React 19 + Vite**: Modern, high-performance UI framework.
+- **Monaco Editor**: The powerful editor behind VS Code, customized for FlashTS.
+- **Tailwind CSS**: For a sleek, responsive, and maintainable design.
+- **Lucide Icons**: Beautiful, consistent iconography.
+- **React Resizable Panels**: Professional workspace layouts.
+
+### Backend (`/server`)
+
+- **Bun**: The fast all-in-one JavaScript runtime (Bundler, Runner, Package Manager).
+- **Hono**: Ultrafast web framework for the API layer.
+- **TypeScript VFS**: In-memory type resolution for project files.
+
+## Getting Started
+
+### Prerequisites
+
+- [Bun](https://bun.sh/) installed on your system.
+
+### Installation
+
+1. **Setup Server**:
+
+   ```bash
+   cd server
+   bun install
+   bun run index.ts
+   ```
+
+2. **Setup Client**:
+
+   ```bash
+   cd client
+   bun install
+   bun run dev
+   ```
+
+3. **Open FlashTS**:
+   Navigate to `http://localhost:5173` in your browser.
+
+## Technical Architecture
+
+### Execution Engine
+
+When you click **Run**, the frontend bundles all your project files and sends them to the server. The server:
+
+1. Creates a unique, isolated session directory in `/tmp`.
+2. Writes all your files to disk.
+3. Spawns a Bun process to execute the active entry point.
+4. Streams the output (stdout/stderr) back to the client console.
+
+### Type Injection
+
+FlashTS automatically fetches type definitions for any NPM package you install. The server parses the package's type tree and serves the `.d.ts` files to the frontend, which Monaco injects into its virtual filesystem. This ensures you always have perfect autocomplete.
+
+### Multi-file VFS
+
+The editor maintains a **Double-Sync** strategy:
+
+- Every file is a **Monaco Model** for active editing.
+- Every file is also registered as an **Ambient ExtraLib**, allowing the TypeScript engine to resolve relative imports (e.g., `./utils.ts`) instantly across tabs.
+
+## License
+
+Distributed under the **MIT License**.
+
+---
+
+Built by ZMDev because all online options are payed, not open source or does not support npm modules correctly.

package/bin/cli.ts

@@ -0,0 +1,63 @@
+#!/usr/bin/env bun
+import { Command } from "commander";
+import { join } from "path";
+import pc from "picocolors";
+import localtunnel from "localtunnel";
+import open from "open";
+
+const program = new Command();
+
+program
+  .name("flashts")
+  .description("FlashTS: High-performance TypeScript Playground CLI")
+  .version("1.0.0")
+  .option("-p, --port <number>", "Port to run the server on", "3000")
+  .option("-s, --share", "Generate a shareable public link")
+  .option("--no-open", "Do not open the browser automatically")
+  .action(async (options: { port: string; share: any; open: any; }) => {
+    const port = parseInt(options.port);
+    const rootDir = process.cwd();
+    
+    console.log(`\n⚡ ${pc.bold(pc.cyan("FlashTS"))} ${pc.dim("v1.0.0")}`);
+    console.log(`${pc.green("➜")}  Local:   ${pc.cyan(`http://localhost:${port}`)}`);
+
+    // Start the server process
+    const serverPath = join(rootDir, "server", "index.ts");
+    const serverProc = Bun.spawn(["bun", "run", serverPath], {
+      env: { ...process.env, PORT: port.toString() },
+      stdout: "inherit",
+      stderr: "inherit",
+    });
+
+    if (options.share) {
+      try {
+        const tunnel = await localtunnel({ port });
+        const publicIp = await (await fetch("https://api.ipify.org")).text();
+        
+        console.log(`${pc.green("➜")}  Public:  ${pc.magenta(tunnel.url)}`);
+        console.log(`${pc.yellow("➜")}  Tunnel Password (IP): ${pc.bold(pc.white(publicIp))}`);
+        console.log(`${pc.dim("   (Use this IP if prompted by the tunnel landing page)")}\n`);
+        
+        tunnel.on("close", () => {
+          console.log(pc.yellow("\nTunnel closed."));
+        });
+      } catch (err) {
+        console.error(pc.red("Failed to create shareable link:"), err);
+      }
+    }
+
+    if (options.open) {
+      setTimeout(() => {
+        open(`http://localhost:${port}`);
+      }, 1000);
+    }
+
+    // Keep process alive
+    process.on("SIGINT", () => {
+      console.log(pc.yellow("\nStopping FlashTS..."));
+      serverProc.kill();
+      process.exit(0);
+    });
+  });
+
+program.parse();

package/client/README.md

@@ -0,0 +1,73 @@
+# React + TypeScript + Vite
+
+This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+
+Currently, two official plugins are available:
+
+- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
+- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+
+## React Compiler
+
+The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+
+## Expanding the ESLint configuration
+
+If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+
+```js
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+
+      // Remove tseslint.configs.recommended and replace with this
+      tseslint.configs.recommendedTypeChecked,
+      // Alternatively, use this for stricter rules
+      tseslint.configs.strictTypeChecked,
+      // Optionally, add this for stylistic rules
+      tseslint.configs.stylisticTypeChecked,
+
+      // Other configs...
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```
+
+You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
+
+```js
+// eslint.config.js
+import reactX from 'eslint-plugin-react-x'
+import reactDom from 'eslint-plugin-react-dom'
+
+export default defineConfig([
+  globalIgnores(['dist']),
+  {
+    files: ['**/*.{ts,tsx}'],
+    extends: [
+      // Other configs...
+      // Enable lint rules for React
+      reactX.configs['recommended-typescript'],
+      // Enable lint rules for React DOM
+      reactDom.configs.recommended,
+    ],
+    languageOptions: {
+      parserOptions: {
+        project: ['./tsconfig.node.json', './tsconfig.app.json'],
+        tsconfigRootDir: import.meta.dirname,
+      },
+      // other options...
+    },
+  },
+])
+```