xpcomcore-rubygem 0.3.1 → 0.3.2

data/Rakefile

@@ -13,7 +13,7 @@ begin
     gem.email = "gabriel.gironda@gmail.com"
     gem.homepage = "http://github.com/gabrielg/xpcomcore-rubygem"
     gem.authors = ["ggironda"]
-    
+    gem.files = (gem.files + FileList["xpcomcore/**/*"]).uniq
     gem.post_install_message = <<-EOF;
 
 #{"".ljust(80).red_on_blue.bold}

data/VERSION

@@ -1 +1 @@
-0.3.1
+0.3.2

data/xpcomcore-rubygem.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{xpcomcore-rubygem}
-  s.version = "0.3.1"
+  s.version = "0.3.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["ggironda"]
@@ -33,7 +33,149 @@ Gem::Specification.new do |s|
      "lib/xpcomcore-rubygem.rb",
      "test/test_helper.rb",
      "test/xpcomcore-rubygem_test.rb",
-     "xpcomcore-rubygem.gemspec"
+     "xpcomcore-rubygem.gemspec",
+     "xpcomcore/LICENSE",
+     "xpcomcore/README",
+     "xpcomcore/Rakefile",
+     "xpcomcore/VERSION.yml",
+     "xpcomcore/bin/popen_helper.sh",
+     "xpcomcore/bootstrapper.js",
+     "xpcomcore/components/XPCOMCore.js",
+     "xpcomcore/doc/files.html",
+     "xpcomcore/doc/index.html",
+     "xpcomcore/doc/symbols/Error.html",
+     "xpcomcore/doc/symbols/File.NoSuchFileError.html",
+     "xpcomcore/doc/symbols/File.html",
+     "xpcomcore/doc/symbols/Kernel.html",
+     "xpcomcore/doc/symbols/LoadError.html",
+     "xpcomcore/doc/symbols/SelfConceptError.html",
+     "xpcomcore/doc/symbols/Sys.html",
+     "xpcomcore/doc/symbols/XPCBuiltins.html",
+     "xpcomcore/doc/symbols/_global_.html",
+     "xpcomcore/doc/symbols/src/lib_file.js.html",
+     "xpcomcore/doc/symbols/src/lib_kernel.js.html",
+     "xpcomcore/doc/symbols/src/lib_sys.js.html",
+     "xpcomcore/doc/symbols/src/lib_xpc_builtins.js.html",
+     "xpcomcore/etc/jsdoc-toolkit/README.txt",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Chain.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Dumper.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Hash.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Link.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Namespace.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Opt.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Reflection.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/String.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/frame/Testrun.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/handlers/FOODOC.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/handlers/XMLDOC.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/handlers/XMLDOC/DomReader.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/handlers/XMLDOC/XMLDoc.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/handlers/XMLDOC/XMLParse.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/DocComment.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/DocTag.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/JsDoc.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/JsPlate.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Lang.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Parser.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/PluginManager.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Symbol.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/SymbolSet.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/TextStream.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Token.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/TokenReader.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/TokenStream.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Util.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/lib/JSDOC/Walker.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/main.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/commentSrcJson.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/frameworkPrototype.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/functionCall.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/publishSrcHilite.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/symbolLink.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/tagParamConfig.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/plugins/tagSynonyms.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/run.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/t/TestDoc.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/t/runner.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/addon.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/anon_inner.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/augments.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/augments2.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/borrows.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/borrows2.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/config.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/constructs.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/encoding.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/encoding_other.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/event.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/exports.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/functions_anon.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/functions_nested.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/global.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/globals.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/ignore.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/inner.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/jsdoc_test.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/lend.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/memberof.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/memberof_constructor.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/module.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/name.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/namespace_nested.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/nocode.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/oblit_anon.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/overview.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/param_inline.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/params_optional.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/prototype.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/prototype_nested.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/prototype_oblit.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/prototype_oblit_constructor.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/public.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/scripts/code.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/scripts/notcode.txt",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/shared.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/shared2.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/shortcuts.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/static_this.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/synonyms.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/tosource.js",
+     "xpcomcore/etc/jsdoc-toolkit/app/test/variable_redefine.js",
+     "xpcomcore/etc/jsdoc-toolkit/changes.txt",
+     "xpcomcore/etc/jsdoc-toolkit/conf/sample.conf",
+     "xpcomcore/etc/jsdoc-toolkit/java/build.xml",
+     "xpcomcore/etc/jsdoc-toolkit/java/build_1.4.xml",
+     "xpcomcore/etc/jsdoc-toolkit/java/classes/js.jar",
+     "xpcomcore/etc/jsdoc-toolkit/java/src/JsDebugRun.java",
+     "xpcomcore/etc/jsdoc-toolkit/java/src/JsRun.java",
+     "xpcomcore/etc/jsdoc-toolkit/jsdebug.jar",
+     "xpcomcore/etc/jsdoc-toolkit/jsrun.jar",
+     "xpcomcore/etc/jsdoc-toolkit/jsrun.sh",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/allclasses.tmpl",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/allfiles.tmpl",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/class.tmpl",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/index.tmpl",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/publish.js",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/static/default.css",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/static/header.html",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/static/index.html",
+     "xpcomcore/etc/jsdoc-toolkit/templates/jsdoc/symbol.tmpl",
+     "xpcomcore/lib/file.js",
+     "xpcomcore/lib/kernel.js",
+     "xpcomcore/lib/sys.js",
+     "xpcomcore/lib/xpc_builtins.js",
+     "xpcomcore/test/file_test.js",
+     "xpcomcore/test/fixtures/empty",
+     "xpcomcore/test/fixtures/love.js",
+     "xpcomcore/test/fixtures/mad_love.js",
+     "xpcomcore/test/fixtures/mad_world.js",
+     "xpcomcore/test/fixtures/syntax_error.js",
+     "xpcomcore/test/kernel_test.js",
+     "xpcomcore/test/sys_test.js",
+     "xpcomcore/test/xpc_builtins_test.js"
   ]
   s.homepage = %q{http://github.com/gabrielg/xpcomcore-rubygem}
   s.post_install_message = %q{

data/xpcomcore/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) <2009> <Gabriel Gironda>
+
+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.

data/xpcomcore/README

@@ -0,0 +1,27 @@
+XPCOMCore
+=========
+
+A standard library like Ruby's, only for JavaScript (with XPCOM access).
+
+Installation
+============
+
+Check out / submodule in / whatever the code to a place of your choosing. Then load it from an XPCOM component like so:
+
+    Components.utils.import("resource://app/chrome/content/vendor/xpcomcore/bootstrapper.js");
+
+Then, to pull XPCOMCore into your scope, do this lovely little trick:
+    
+    XPCOMCore({scope: this});
+    
+If you wish to not automatically mix in the `Kernel` module, pass another argument like so:
+
+    XPCOMCore({scope: this, importKernel: false});
+    
+Then, whenever you want to make use of XPCOMCore (say, from a XUL window), do the same deal. For example:
+
+    <script type="text/javascript">XPCOMCore({scope: this});</script>
+    
+Then you'll have access to methods such as load() and require() and whatever else is defined in Kernel.
+
+- Gabriel Gironda

data/xpcomcore/Rakefile

@@ -0,0 +1,83 @@
+require 'pathname'
+require 'yaml'
+here = (Pathname(__FILE__).parent.expand_path)
+
+task :test do
+  ENV['XPCOMCORE'] = Pathname(__FILE__).parent.expand_path.to_s
+  exec(ENV['XULTEST'] || "xultest", "-testDir", (Pathname(__FILE__).parent + "test/").expand_path.to_s)
+end
+
+task :default => :test
+
+namespace :docs do
+  doc_dir = here + "doc"
+  jsdoc_loc = here + "etc/jsdoc-toolkit"
+  
+  desc "Builds the documentation"
+  task :build do
+    raise "java does not seem to be in your PATH." if `which java`.chomp.empty?
+    system(%Q[java -jar "#{jsdoc_loc}/jsrun.jar" "#{jsdoc_loc}/app/run.js" -r -a -t="#{jsdoc_loc}/templates/jsdoc" -d="#{doc_dir}" lib])
+  end
+  
+  task :clean do
+    system(%Q[cd "#{here}" && git rm -rf "doc/*"])    
+    FileUtils.rm_rf(doc_dir)
+    FileUtils.mkdir(doc_dir)
+  end
+  
+  task :commit do
+    system(%Q[cd "#{here}" && git add "doc" && git commit -m "Updating docs"])    
+  end
+  
+  task :update_gh_pages do
+    current_branch = `cd "#{here}" && git branch 2> /dev/null | grep -e '\\* ' | sed 's/^..\\(.*\\)/\\1/'`.chomp
+    system(%Q[cd "#{here}" && git checkout gh-pages && git rm -rf doc && git checkout master doc && git add doc && git commit -m "Updating docs for GH pages" && git checkout -f #{current_branch}])
+  end
+
+end
+
+task :build => ['version:update_files', 'docs:clean', 'docs:build', 'docs:commit', 'docs:update_gh_pages']
+
+
+task :release => :build do
+  system(%Q[cd #{here} && git push])
+end
+
+namespace :version do
+  version_file = here + "VERSION.yml"
+  
+  task :update_files do
+    component_file = (Pathname(__FILE__).parent + "components/XPCOMCore.js").expand_path
+    current = YAML.load_file(version_file.to_s)
+    version_string = "#{current['version']['major']}.#{current['version']['minor']}.#{current['version']['patch']}"
+    js_marker_comment = "// DO NOT REMOVE THIS COMMENT OR MOVE THIS LINE. THIS LINE IS AUTO-GENERATED FROM A RAKE TASK. @XPCOMCORE_VERSION@"
+    js_version_string = "var XPCOMCoreVersion = '#{version_string}'; #{js_marker_comment}\n"
+    new_file = component_file.readlines.collect do |line|
+      next line unless line =~ /@XPCOMCORE_VERSION@/
+      js_version_string
+    end
+    
+    component_file.open('w') { |f| f << new_file.join }
+    puts "Updated '#{component_file}' to reflect VERSION.yml"
+    system(%Q[cd "#{here}" && git add "#{component_file}" && git commit -m "Updating version to '#{version_string}'" "#{component_file}"])
+  end
+  
+  namespace :bump do
+    bumper = lambda do |version_part|
+      current = YAML.load_file(version_file.to_s)
+      puts "Current version is: #{current['version']['major']}.#{current['version']['minor']}.#{current['version']['patch']}"
+      current['version'][version_part] += 1
+      version_file.open('w') { |f| f << YAML.dump(current) }
+      puts "Current version is now: #{current['version']['major']}.#{current['version']['minor']}.#{current['version']['patch']}"
+    end
+    
+    desc "Bumps the major version"
+    task(:major) { bumper.call('major') }
+    
+    desc "Bumps the minor version"
+    task(:minor) { bumper.call('minor') }
+    
+    desc "Bumps the patch version"
+    task(:patch) { bumper.call('patch') }
+  end
+end

data/xpcomcore/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+version: 
+  major: 0
+  minor: 4
+  patch: 1

data/xpcomcore/bin/popen_helper.sh

@@ -0,0 +1,47 @@
+#!/bin/sh
+IFS=
+pid=$$
+tmpdir=$1
+streams=$2
+cmd=$3
+
+if [[ !( "$cmd" ) || !( "$streams" ) ]]; then
+  echo "A valid command or set of streams were not provided."
+  exit 1
+fi
+  
+if [[ ( $tmpdir ) && ( -d "$tmpdir" ) && ( -w "$tmpdir" ) ]]; then
+  stdin="&0"
+  stdout="&1"
+  stderr="&2"
+  
+  IFS=","
+  
+  for streamname in $streams; do
+    export "$streamname"="$tmpdir/$pid.$streamname.pipe"
+    mkfifo -m 600 "$tmpdir/$pid.$streamname.pipe"
+    exit=$?
+    test $exit -gt 0 && exit $exit
+  done
+  
+  IFS=
+  shift && shift && shift
+
+  eval "exec 2>$stderr"
+  eval "exec 3<$stdin"
+  eval "exec 1>$stdout"
+    
+  $cmd $* <&3
+  
+  status=$?
+  IFS=","  
+  for streamname in $streams; do
+    rm "$tmpdir/$pid.$streamname.pipe"
+  done
+  
+  IFS=
+  exit $status
+else
+  echo "Temporary directory \"$tmpdir\" doesn't exist or is not writable."
+  exit 1
+fi

data/xpcomcore/bootstrapper.js

@@ -0,0 +1,32 @@
+const requiredMinGeckoVersion = '1.9.0';
+var EXPORTED_SYMBOLS = ["XPCOMCore", "XPCOMCoreConfig"];
+
+const $Cc = Components.classes;
+const $Ci = Components.interfaces;
+
+var checkGeckoVersion = function() {
+  var versionComparator = $Cc["@mozilla.org/xpcom/version-comparator;1"].getService($Ci.nsIVersionComparator);
+  var appInfo = $Cc["@mozilla.org/xre/app-info;1"].getService($Ci.nsIXULAppInfo);
+  if (versionComparator.compare(appInfo.platformVersion, requiredMinGeckoVersion) < 0) {
+    throw("Gecko version '" + appInfo.platformVersion + "' is unable to use XPCOMCore.");
+  }
+};
+
+// Check we're even compatible with this version of Gecko before doing anything else.
+checkGeckoVersion();
+
+// Set up a resource substitution for our current directory location
+var ioService = $Cc["@mozilla.org/network/io-service;1"].getService($Ci.nsIIOService);
+var resProt = ioService.getProtocolHandler("resource").QueryInterface($Ci.nsIResProtocolHandler);
+var currentDir = ioService.newURI(Components.stack.filename, null, null).QueryInterface($Ci.nsIFileURL).file.parent;
+resProt.setSubstitution("xpcomcore", ioService.newFileURI(currentDir));
+
+// Register our XPCOM Components
+var componentsDir = ioService.newURI("resource://xpcomcore/components", null, null).QueryInterface($Ci.nsIFileURL).file;
+Components.manager.QueryInterface($Ci.nsIComponentRegistrar).autoRegister(componentsDir);
+
+// Now we're registered, export a reference to the service for the component that's bootstrapping us,
+// since "Javascript global property"/"Javascript global constructor" don't get exported into the
+// BackstagePass environment.
+const XPCOMCore = $Cc["@conflagrationjs.org/xpcomcore/core-constructor;1"].createInstance();
+const XPCOMCoreConfig = $Cc["@conflagrationjs.org/xpcomcore/core;1"].createInstance();

data/xpcomcore/components/XPCOMCore.js

@@ -0,0 +1,122 @@
+var XPCOMCoreVersion = '0.4.1'; // DO NOT REMOVE THIS COMMENT OR MOVE THIS LINE. THIS LINE IS AUTO-GENERATED FROM A RAKE TASK. @XPCOMCORE_VERSION@
+Components.utils.import("resource://gre/modules/XPCOMUtils.jsm");
+
+const $Cc = Components.classes;
+const $Ci = Components.interfaces;
+
+var ioService = $Cc["@mozilla.org/network/io-service;1"].getService($Ci.nsIIOService);
+var libRoot = ioService.newURI("resource://xpcomcore/lib", null, null).QueryInterface($Ci.nsIFileURL).file.path;
+var binRoot = ioService.newURI("resource://xpcomcore/bin", null, null).QueryInterface($Ci.nsIFileURL).file.path;
+
+// NOTE - XPCOMCore is a singleton
+var XPCOMCore = function() { 
+  if (arguments.callee.__singletonInstance__) { return arguments.callee.__singletonInstance__; };
+
+  // Private method that does the work of loading the XPCOMCore kernel
+  // into the given scope.
+  var loadKernel = function(importScope) {
+    var loader = $Cc["@mozilla.org/moz/jssubscript-loader;1"].getService($Ci.mozIJSSubScriptLoader);
+    loader.loadSubScript("resource://xpcomcore/lib/kernel.js", importScope);
+  };
+  
+  // Private method to actually kick off the importing of kernel into the given
+  // import scope.
+  var import = function(importScope, importKernel) {
+    if (importScope.__XPCOMCoreLoaded__) {
+      return false;
+    } else {
+      loadKernel(importScope);
+      // FIXME - defineGetter explodes when it's a 'Window' object for some reason. Fine for
+      // ChromeWindow and fine for BackstagePass though. Weird.
+      // importScope.__defineGetter__('__XPCOMCoreLoaded__', function() { return true; });
+      importScope.__XPCOMCoreLoaded__ = true;
+      // Automatically mix Kernel into the scope if importKernel is true
+      if (importKernel) { importScope.Kernel(importScope); };
+      return true;
+    }
+  };
+  
+  // FIXME - hack. hijacking the nsIWritableVariant interface so we can have a constructor that works
+  // FIXME - and to boot, for reasons i dont understand, we wrap the scope in another object, hence the options
+  // hash. which might be useful anyway.
+  this.setFromVariant = function(options) {
+    if (!options.scope) { return false; }
+    return import(options.scope, !(options.importKernel === false));
+  };
+
+  arguments.callee.__singletonInstance__ = this;
+  // HACK HACK HACK - this is so we can get a reference to the real constructor
+  // from the bootstrapper.
+  this.__specialConstructor__ = arguments.callee;  
+};
+
+// FIXME - maybe? might not really be a 'bug'
+// Bahaha - we rely on http://mxr.mozilla.org/mozilla1.8/source/js/src/xpconnect/src/xpcwrappedjsclass.cpp#528
+// (as written about in http://weblogs.mozillazine.org/weirdal/archives/019778.html) to expose a getProperty
+// method on this object to allow for getting arbitrary properties.
+var XPCOMCoreInterfaces = [$Ci.nsIClassInfo, $Ci.nsIPropertyBag, $Ci.nsIWritableVariant];
+
+XPCOMCore.prototype = {
+  classDescription: "XPCOMCore Core Object",
+  contractID: "@conflagrationjs.org/xpcomcore/core;1",
+  classID: Components.ID("{f562f600-9c25-11de-8a39-0800200c9a66}"),
+  QueryInterface: XPCOMUtils.generateQI(XPCOMCoreInterfaces),
+  _xpcom_categories: [{category: "JavaScript global property", entry: "XPCOMCoreConfig"}],
+  
+  // implemented for nsIClassInfo
+  getInterfaces: function(aCountRef) {
+    aCountRef.value = XPCOMCoreInterfaces.length;
+    return XPCOMCoreInterfaces;
+  },
+  
+  // implemented for nsIClassInfo  
+  getHelperForLanguage: function(aLanguage) { return null; },
+  
+  // implemented for nsIClassInfo
+  implementationLanguage: $Ci.nsIProgrammingLanguage.JAVASCRIPT,
+  
+  // implemented for nsIClassInfo
+  flags: $Ci.nsIClassInfo.SINGLETON,
+  
+  get version() { return new String(XPCOMCoreVersion); },
+  get libRoot() { return new String(libRoot); },
+  get binRoot() { return new String(binRoot); }
+  
+};
+
+var XPCOMCoreConstructorInterfaces = [$Ci.nsIClassInfo, $Ci.nsIXPCConstructor, $Ci.nsIXPCScriptable];
+
+// Singleton
+var XPCOMCoreConstructor = function() {
+  if (arguments.callee.__singletonInstance__) { return arguments.callee.__singletonInstance__; };
+  var ctor = Components.Constructor("@conflagrationjs.org/xpcomcore/core;1", Components.interfaces.nsIWritableVariant, "setFromVariant");
+  arguments.callee.__singletonInstance__ = ctor;
+  return ctor;
+};
+
+XPCOMCoreConstructor.prototype = {
+  classDescription: "XPCOMCore Core Object Constructor Hack",
+  contractID: "@conflagrationjs.org/xpcomcore/core-constructor;1",
+  classID: Components.ID("{b5762b40-a0ec-11de-8a39-0800200c9a66}"),
+  QueryInterface: XPCOMUtils.generateQI(XPCOMCoreConstructorInterfaces),
+  _xpcom_categories: [{category: "JavaScript global property", entry: "XPCOMCore"}],
+  
+  // implemented for nsIClassInfo
+  getInterfaces: function(aCountRef) {
+    aCountRef.value = XPCOMCoreConstructorInterfaces.length;
+    return XPCOMCoreConstructorInterfaces;
+  },
+  
+  // implemented for nsIClassInfo  
+  getHelperForLanguage: function(aLanguage) { return null; },
+  
+  // implemented for nsIClassInfo
+  implementationLanguage: $Ci.nsIProgrammingLanguage.JAVASCRIPT,
+  
+  // implemented for nsIClassInfo
+  flags: $Ci.nsIClassInfo.SINGLETON
+}
+
+NSGetModule = function(compMgr, fileSpec) {
+  return XPCOMUtils.generateModule([XPCOMCore, XPCOMCoreConstructor]);
+};