Move virtual file explorer backend package into this repo

[k0d13]

Summary by CodeRabbit

• New Features

  • Added virtual file explorer backend package with hierarchical file and folder node management, including event-driven state tracking for selections, expansions, and content changes.

• Chores

  • Updated website package to reference the new backend as a workspace dependency.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
evaluate	Ready	Preview, Comment	Apr 3, 2026 8:35am

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

Walkthrough

A new virtual-file-explorer-backend package has been created containing File and Folder classes that model a hierarchical tree structure with event propagation and state management. The website application dependency is updated to reference this package via workspace linking.

Changes

Cohort / File(s)	Summary
Package Setup packages/virtual-file-explorer-backend/package.json, packages/virtual-file-explorer-backend/tsconfig.json	Created new package manifest at version 0.0.5 with ESM support, build scripts, and EventEmitter2 runtime dependency. Added TypeScript configuration extending shared base.
Tree Node Classes packages/virtual-file-explorer-backend/src/file.ts, packages/virtual-file-explorer-backend/src/folder.ts	Implemented File and Folder classes representing tree nodes with parent-child relationships, selection/expansion state management, and hierarchical event propagation using EventEmitter2 with wildcard subscriptions.
Collection Utility packages/virtual-file-explorer-backend/src/children.ts	Introduced Children array subclass with predicate-based removal, filtered mapping via where(), and automatic sorting that prioritises folders before files.
Module Exports packages/virtual-file-explorer-backend/src/index.ts	Added re-exports of File and Folder classes to establish package public API surface.
Workspace Dependency apps/website/package.json	Updated virtual-file-explorer-backend dependency from published version (^0.0.4) to workspace link (workspace:^).

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Poem

🐰 A warren of files I've crafted with care,
Folders arranged in tree-like layers fair,
Events that hop through the ancestral line,
Selection and focus in perfect design,
From workspace to workspace, the links intertwine! 🌳✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and accurately describes the primary change: migrating the virtual file explorer backend package from an external dependency into the monorepo.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch virtual-file-explorer-backend

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}