[chore] refactor typescript directory #2087

sxlijin · 2025-06-30T22:57:39Z

Major TypeScript Directory Refactor

Overview

This PR introduces a major refactor of the TypeScript codebase. The primary goal is to modernize, modularize, and clarify the structure of our TypeScript projects, making it easier to maintain, extend, and onboard new contributors. This is a breaking, high-impact change that affects nearly every TypeScript-related file and package.

What Changed

1. Monorepo Structure: All TypeScript Packages Moved to `/packages`

Before: Many packages and apps (e.g., fiddle-frontend, vscode-ext, playground-common, common, etc.) were scattered directly under typescript/ or in ad-hoc subfolders.
After: All reusable packages and libraries now live under typescript/packages/. This includes:
- baml-schema-wasm-node
- baml-schema-wasm-web
- codemirror-lang-baml
- common
- fiddle-proxy
- language-server
- nextjs-plugin
- playground-common
- ui (new, see below)

2. Apps Consolidated Under `/apps`

Before: Apps like the playground and VSCode extension were in their own folders (fiddle-frontend, vscode-ext/packages/vscode, etc.).
After: All TypeScript-based apps now live under typescript/apps/:
- fiddle-web-app (formerly fiddle-frontend)
- vscode-ext (formerly vscode-ext/packages/vscode and web-panel)

3. New `ui` Package

All shared UI components (buttons, dialogs, forms, etc.) are now in typescript/packages/ui/.
This package is intended to be the single source of truth for UI primitives across all apps.

4. Shared Code and Utilities

The common and playground-common packages have been moved and refactored for clarity.
Shared logic, types, and utilities are now easier to find and import.

5. Configuration and Tooling

All build, lint, and workspace configuration files have been updated to reflect the new structure.
New workspace tools and base configs are in typescript/workspace-tools/.

6. Removed/Deleted Files

Legacy, duplicate, or now-unnecessary files and configs have been deleted.
Old package.jsons, tsconfigs, and other configs from the previous structure are gone.

Why This Matters

Consistency: All TypeScript code now follows a clear, industry-standard monorepo structure.
Maintainability: Easier to update dependencies, share code, and onboard new contributors.
Scalability: Adding new packages or apps is now straightforward.
Clarity: No more confusion about where a package, component, or utility lives.

Impact for Contributors

Imports: You may need to update import paths in your branches or local changes.
Docs: Please refer to the new folder structure when writing documentation or onboarding guides.
Build/Test: All scripts and CI should now reference the new locations. If you have custom scripts, update their paths.
VSCode/IDE: You may need to reload your workspace or update your project settings.

Migration Guide

Apps: Look in typescript/apps/ for all runnable applications.
Packages: Look in typescript/packages/ for all libraries, shared code, and utilities.
UI Components: Use @boundaryml/ui for all shared UI needs.
Workspace Tools: See typescript/workspace-tools/ for base configs and scripts.

Summary Table

Old Location	New Location
`typescript/fiddle-frontend/`	`typescript/apps/fiddle-web-app/`
`typescript/vscode-ext/packages/vscode/`	`typescript/apps/vscode-ext/`
`typescript/vscode-ext/packages/web-panel/`	`typescript/apps/vscode-ext/src/web-panel/`
`typescript/playground-common/`	`typescript/packages/playground-common/`
`typescript/common/`	`typescript/packages/common/`
`typescript/fiddle-proxy/`	`typescript/packages/fiddle-proxy/`
`typescript/nextjs-plugin/`	`typescript/packages/nextjs-plugin/`
`typescript/codemirror-lang-baml/`	`typescript/packages/codemirror-lang-baml/`
`typescript/baml-schema-wasm-node/`	`typescript/packages/baml-schema-wasm-node/`
`typescript/baml-schema-wasm-web/`	`typescript/packages/baml-schema-wasm-web/`
`typescript/language-server/`	`typescript/packages/language-server/`

Final Notes

This is a breaking change for anyone with open PRs or local branches. Please rebase and update paths as needed.
If you find any missing or misplaced files, please open a follow-up PR or issue.

vercel · 2025-06-30T22:57:43Z

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
baml	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 14, 2025 11:20am

typescript/apps/fiddle-web-app/app/embed/page.tsx

typescript/apps/fiddle-web-app/lib/loadProject.ts

typescript/apps/playground/src/main.tsx

typescript/packages/playground-common/src/baml_wasm_web/EventListener.tsx

+  useEffect(() => {
+    console.log('adding event listener');
+    const fn = (
+      event: MessageEvent<


To fix the issue, we need to verify the origin of the incoming MessageEvent before processing the message. This involves:

Defining a list of trusted origins (e.g., https://www.example.com) that are allowed to send messages.

Adding a conditional check to ensure the event.origin matches one of the trusted origins.

If the origin is not trusted, the handler should ignore the message or log a warning.

The fix will be applied to the fn function defined on line 189. The trusted origins can be defined as a constant array or a configuration variable.

typescript/packages/playground-common/src/shared/baml-project-panel/vscode.ts

ellipsis-dev · 2025-07-01T05:06:31Z

⚠️ This PR is too big for Ellipsis, but support for larger PRs is coming soon. If you want us to prioritize this feature, let us know at [email protected]

Generated with ❤️ by ellipsis.dev

.github/workflows/release-cli.yaml

.github/workflows/primary.yml

fix: issue with manturin codegen fix: release fix: wasm build fix genreate fix python final

github-advanced-security bot found potential problems Jun 30, 2025

View reviewed changes

seawatts force-pushed the seawatts/update-playground2 branch from e372c19 to 58a06e7 Compare June 30, 2025 23:22

vercel bot had a problem deploying to Preview June 30, 2025 23:22 Failure

vercel bot had a problem deploying to Preview July 1, 2025 04:34 Failure

vercel bot had a problem deploying to Preview July 1, 2025 04:50 Failure

seawatts marked this pull request as ready for review July 1, 2025 05:03

vercel bot had a problem deploying to Preview July 1, 2025 05:03 Failure

seawatts changed the title ~~squash everything~~ [chore] refactor typescript directory Jul 1, 2025

seawatts self-assigned this Jul 1, 2025

vercel bot had a problem deploying to Preview July 1, 2025 05:06 Failure

vercel bot had a problem deploying to Preview July 1, 2025 05:15 Failure

vercel bot had a problem deploying to Preview July 1, 2025 05:19 Failure

vercel bot had a problem deploying to Preview July 1, 2025 05:31 Failure

github-advanced-security bot found potential problems Jul 1, 2025

View reviewed changes

.github/workflows/release-cli.yaml Fixed Show fixed Hide fixed

vercel bot had a problem deploying to Preview July 1, 2025 07:42 Failure

vercel bot had a problem deploying to Preview July 1, 2025 08:07 Failure

vercel bot had a problem deploying to Preview July 1, 2025 08:18 Failure

vercel bot had a problem deploying to Preview July 1, 2025 08:27 Failure

seawatts force-pushed the seawatts/update-playground2 branch from 70ecadf to 0b7b2a1 Compare July 1, 2025 08:48

vercel bot had a problem deploying to Preview July 1, 2025 08:50 Failure

seawatts force-pushed the seawatts/update-playground2 branch from 0b7b2a1 to 032ba5c Compare July 1, 2025 08:57

vercel bot had a problem deploying to Preview July 1, 2025 08:58 Failure

vercel bot had a problem deploying to Preview July 1, 2025 09:01 Failure

vercel bot had a problem deploying to Preview July 1, 2025 09:05 Failure

vercel bot had a problem deploying to Preview July 1, 2025 18:02 Failure

github-advanced-security bot found potential problems Jul 1, 2025

View reviewed changes

.github/workflows/primary.yml Fixed Show fixed Hide fixed

.github/workflows/primary.yml Fixed Show fixed Hide fixed

.github/workflows/primary.yml Fixed Show fixed Hide fixed

.github/workflows/primary.yml Fixed Show fixed Hide fixed

vercel bot had a problem deploying to Preview July 1, 2025 18:04 Failure

vercel bot had a problem deploying to Preview July 1, 2025 18:10 Failure

vercel bot had a problem deploying to Preview July 11, 2025 22:45 Failure

vercel bot had a problem deploying to Preview July 11, 2025 23:01 Failure

vercel bot had a problem deploying to Preview July 12, 2025 00:20 Failure

vercel bot had a problem deploying to Preview July 12, 2025 00:29 Failure

vercel bot had a problem deploying to Preview July 12, 2025 00:33 Failure

vercel bot had a problem deploying to Preview July 14, 2025 05:28 Failure

vercel bot had a problem deploying to Preview July 14, 2025 05:36 Failure

vercel bot had a problem deploying to Preview July 14, 2025 05:45 Failure

vercel bot had a problem deploying to Preview July 14, 2025 06:02 Failure

vercel bot had a problem deploying to Preview July 14, 2025 06:12 Failure

vercel bot had a problem deploying to Preview July 14, 2025 06:35 Failure

vercel bot deployed to Preview July 14, 2025 07:20 View deployment

vercel bot deployed to Preview July 14, 2025 07:34 View deployment

vercel bot deployed to Preview July 14, 2025 07:49 View deployment

seawatts force-pushed the seawatts/update-playground2 branch from 905911a to 066f36f Compare July 14, 2025 08:06

squash everything

afc8a5d

seawatts force-pushed the seawatts/update-playground2 branch from 066f36f to ca8ec19 Compare July 14, 2025 08:11

vercel bot deployed to Preview July 14, 2025 08:42 View deployment

vercel bot deployed to Preview July 14, 2025 09:20 View deployment

vercel bot deployed to Preview July 14, 2025 09:56 View deployment

feat: refactor typescript directory

1e9d8e7

fix: issue with manturin codegen fix: release fix: wasm build fix genreate fix python final

seawatts force-pushed the seawatts/update-playground2 branch from 08c6398 to 1e9d8e7 Compare July 14, 2025 10:16

vercel bot deployed to Preview July 14, 2025 10:28 View deployment

remove cache

ca67b4f

seawatts enabled auto-merge July 14, 2025 11:09

vercel bot deployed to Preview July 14, 2025 11:20 View deployment

seawatts added this pull request to the merge queue Jul 14, 2025

Merged via the queue into canary with commit 6b7c178 Jul 14, 2025
19 checks passed

seawatts deleted the seawatts/update-playground2 branch July 14, 2025 12:04

@@ -188,2 +188,3 @@
                 console.log('adding event listener');
+                const trustedOrigins = ['https://www.example.com', 'https://trusted-origin.com'];
                 const fn = (
@@ -253,2 +254,6 @@
                 ) => {
+                  if (!trustedOrigins.includes(event.origin)) {
+                    console.warn(`Untrusted origin: ${event.origin}`);
+                    return;
+                  }
                   const { command, content } = event.data;

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[chore] refactor typescript directory #2087

[chore] refactor typescript directory #2087

Uh oh!

sxlijin commented Jun 30, 2025 •

edited by seawatts

Loading

Uh oh!

vercel bot commented Jun 30, 2025 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Check warning

Copilot Autofix

Uh oh!

ellipsis-dev bot commented Jul 1, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

[chore] refactor typescript directory #2087

[chore] refactor typescript directory #2087

Uh oh!

Conversation

sxlijin commented Jun 30, 2025 • edited by seawatts Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Major TypeScript Directory Refactor

Overview

What Changed

1. Monorepo Structure: All TypeScript Packages Moved to /packages

2. Apps Consolidated Under /apps

3. New ui Package

4. Shared Code and Utilities

5. Configuration and Tooling

6. Removed/Deleted Files

Why This Matters

Impact for Contributors

Migration Guide

Summary Table

Final Notes

Uh oh!

vercel bot commented Jun 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Check warning

Copilot Autofix

Uh oh!

ellipsis-dev bot commented Jul 1, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

sxlijin commented Jun 30, 2025 •

edited by seawatts

Loading

1. Monorepo Structure: All TypeScript Packages Moved to `/packages`

2. Apps Consolidated Under `/apps`

3. New `ui` Package

vercel bot commented Jun 30, 2025 •

edited

Loading