How nolane-x/nolane-opencontainer works
OpenContainer is a browser-native Node/web development runtime. The main workflow is to boot the runtime, mount a workspace, resolve and install packages, then execute commands or modules in a bounded process; users can also publish previews and snapshot or export workspace state. The graph includes documented package, toolchain, browser-worker, and OPFS capabilities. Several package internals are unsampled, so their documented responsibilities are shown without guessing at call wiring.
Main entry points: src/index.js OpenContainer SDK · src/index.js Package Graph · browser-guest-worker.js Browser Guest Worker · src/index.js Virtual Filesystem
Components 24
Runtime Core
- OpenContainer SDK
packages/sdk/src/index.js - Lifecycle Kernel
packages/kernel/src/index.js - Errors and Protocol
packages/protocol/src/index.js
Workspace and Packages
- Virtual Filesystem
packages/vfs/src/index.js - OPFS Checkpoints
packages/vfs/src/opfs-authority.js - Package Graph
packages/package-env/src/index.js - Artifact Authority
packages/package-env/src/artifact-authority.js - Module Resolver
packages/package-env/src/resolver.js - Virtual Node Modules
packages/package-env/src/virtual-node-modules.js - CommonJS Loader
packages/package-env/src/commonjs-loader.js - Native ESM Publication
packages/package-env/src/native-esm-publication.js
Execution and Toolchain
- Process Supervisor
packages/process/src/index.js - Worker RPC Authority
packages/process/src/worker-authority.js - Toolchain Profiles
packages/toolchain/src/index.js - WASM Artifact Manager
packages/toolchain/src/wasm-artifact-manager.js
Runtime Services
- Network Authority
packages/network/src/index.js - Preview Authority
packages/preview/src/index.js - Snapshots and Export
packages/persistence/src/index.js - Resource Governor
packages/resources/src/index.js - Diagnostic Journal
packages/diagnostics/src/index.js
Browser Integration
- Browser Guest Worker
packages/process/src/browser-guest-worker.js - Guest Worker Entry
apps/playground/public/opencontainer-guest-worker.mjs - Synchronous RPC
packages/process/src/sync-rpc.js
Other components
- Developer
Connections 31
- Developer → OpenContainer SDK: boots runtime
- OpenContainer SDK → Lifecycle Kernel: boots
- OpenContainer SDK → Virtual Filesystem: mounts files
- OpenContainer SDK → Process Supervisor: spawns commands
- OpenContainer SDK → Package Graph: binds package commands
- OpenContainer SDK → Preview Authority: publishes preview
- OpenContainer SDK → Network Authority
- OpenContainer SDK → Snapshots and Export
- OpenContainer SDK → Resource Governor
- OpenContainer SDK → Diagnostic Journal
- OpenContainer SDK → Lifecycle Kernel: checks readiness
- Package Graph → Virtual Filesystem: reads and writes
- Package Graph → Artifact Authority: ingests artifacts
- Artifact Authority → Network Authority: authorizes fetches
- Package Graph → Module Resolver: resolves modules
- Package Graph → Virtual Node Modules: projects packages
- Module Resolver → CommonJS Loader: supports loading
- Module Resolver → Native ESM Publication: publishes modules
- Process Supervisor → Resource Governor: governs processes
- Process Supervisor → Browser Guest Worker: executes in browser
- Browser Guest Worker → Worker RPC Authority: dispatches RPC
- Browser Guest Worker → Native ESM Publication: resolves dynamic imports
- Browser Guest Worker → Synchronous RPC: settles sync RPC
- Guest Worker Entry → Synchronous RPC: creates mailbox
- Guest Worker Entry → Native ESM Publication: resolves dynamic imports
- Toolchain Profiles → WASM Artifact Manager: verifies artifacts
- Snapshots and Export → Virtual Filesystem: snapshots and restores
- OPFS Checkpoints → Virtual Filesystem: checkpoints and restores
- Lifecycle Kernel → Diagnostic Journal: records lifecycle
- Worker RPC Authority → Diagnostic Journal: records RPC
- Browser Guest Worker → Diagnostic Journal: records worker events