add require.moduleId to allow a module to know its ID

README.md

@@ -31,6 +31,27 @@ require('foo') // => 'hi';
 require('foo') === require('foo/bar/baz');
 ```
 
+### `require('require')`
+
+When within a module, one can require `require`. This provides a `require` scoped to the current module. Enabling dynamic, relatively path requires.
+
+```js
+
+define('foo/apple', ['require'], function() { return 'apple'; });
+define('foo/bar', ['require'], function(require){ return require('./apple'););
+
+require('foo/bar'); // 'apple';
+```
+
+This scoped `require` also enables a module some reflection, in this case the ability for a module to see its own `moduleId`;
+
+```js
+
+define('my/name/is', ['require'], function(require) {
+  require.moduleId // => 'my/name/is';
+});
+```
+
 ### `define.exports('foo', {})`
 
 `define.exports` enables a fastpath for non-lazy dependency-less modules, for example:

lib/loader/loader.js

@@ -202,6 +202,7 @@ var loader, define, requireModule, require, requirejs;
       return require(resolve(dep, name));
     };
     r['default'] = r;
+    r.moduleId = name;
     r.has = function(dep) {
       return has(resolve(dep, name));
     };

tests/all.js

@@ -141,7 +141,6 @@ test('simple define/require', function() {
   deepEqual(Object.keys(requirejs.entries), ['foo']);
 });
 
-
 test('define without deps', function() {
   var fooCalled = 0;
 
@@ -170,7 +169,6 @@ test('define without deps', function() {
   deepEqual(Object.keys(requirejs.entries), ['foo']);
 });
 
-
 test('multiple define/require', function() {
   define('foo', [], function() {
 
@@ -1669,3 +1667,13 @@ test('define.exports', function(assert) {
   define.exports('foo/bar', defaultExport);
   assert.equal(require('foo/bar'), defaultExport);
 });
+
+test('require.moduleId', function(assert) {
+  define('foo', ['require'], function(require) {
+    assert.equal(require.moduleId, 'foo');
+    return require.moduleId;
+  });
+
+  define.alias('foo', 'foo/bar');
+  assert.equal(require('foo/bar'), 'foo');
+});