https://github.com/dbashford/mimosa-iced-coffeescript

A Mimosa 2.0 module for Iced CoffeeScript compiling
https://github.com/dbashford/mimosa-iced-coffeescript

Last synced: 20 days ago
JSON representation

A Mimosa 2.0 module for Iced CoffeeScript compiling

• Host: GitHub
• URL: https://github.com/dbashford/mimosa-iced-coffeescript
• Owner: dbashford
• Created: 2014-01-01T22:37:44.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2015-01-14T02:03:18.000Z (almost 10 years ago)
• Last Synced: 2024-10-04T22:14:11.014Z (about 1 month ago)
• Language: JavaScript
• Size: 188 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
mimosa-iced-coffeescript

===========

## Overview

This is a Iced CoffeeScript compiler for the Mimosa build tool. This module is for use with Mimosa `2.0+`.  This replicates the functionality of the Iced CoffeeScript compiler that was built into Mimosa before `2.0`.

For more information regarding Mimosa, see http://mimosa.io

## Usage

Add `'iced-coffeescript'` to your list of modules.  That's all!  Mimosa will install the module for you when you start `mimosa watch` or `mimosa build`.

## Functionality

This module will compile Iced CoffeeScript files during `mimosa watch` and `mimosa build`.

By default, during `mimosa watch` this module will also generate source maps. Source maps map lines of compiled JavaScript back to lines of the original Iced CoffeeScript source. So when something breaks in the compiled JavaScript, tools like the Chrome Dev Tools will show you the responsible line of Iced CoffeeScript. Source maps are turned off by default for `mimosa build`. [Dynamic source maps](http://fitzgeraldnick.com/weblog/46/) are used by default, unless minifying code, in which case source maps are generated as separate files.

Iced CoffeeScript, by default, wraps compiled JavaScript in a safety wrapper to protect scope. This module turns this wrapping off by compiling `bare` by default. It does this because it assumes code is already being wrapped in AMD or CommonJS/AMD functions `define` or `require`.

All Iced CoffeeScript configuration options can be provided in the `options` object, `sourceMap` and `bare` are the only ones provided values by this module.

## Default Config

```coffeescript

iced:

  lib: undefined

  extensions: ["iced"]

  sourceMapDynamic: true

  sourceMapExclude: [/\/specs?\//, /_spec.js$/]

  sourceMapConditional: false

  options:

    sourceMap:true

    bare:true

    runtime:"none"

```

* `lib`: You may want to use this module but may not be ready to use the latest version of Iced CoffeeScript. Using the `lib` property you can provide a specific version of Iced CoffeeScript if the one being used by this module isn't to your liking. To provide a specific version, you must have it `npm install`ed into your project and then provide it to `lib`. For instance: `lib: require('iced-coffee-script')`.

* `extensions`: an array of strings, the extensions of your Iced CoffeeScript files.

* `sourceMapDynamic`: a boolean, whether or not to use [Dynamic source maps](http://fitzgeraldnick.com/weblog/46/). Dynamic source maps require no extra network hops to retrieve the original source or the map files.  They are also a necessity for tools like browserify.

* `sourceMapExclude`: an array of strings and regexes. A list of files or patterns matching files to exclude from source map generation. Strings are paths and can be either absolute or relative to `config.watch.javascriptDir`.

* `sourceMapConditional`: a boolean, whether or not to use conditional source maps. See [this thread](https://groups.google.com/d/topic/mozilla.dev.js-sourcemap/4uo7Z5nTfUY/discussion) for details.

* `options`: an object, the Iced CoffeeScript compiler configuration. This object is passed straight to the Iced CoffeeScript compiler. New properties can be added here to tweak Iced CoffeeScript compilation.

* `options.sourceMap`: an Iced CoffeeScript compiler option to turn on/off source maps.

* `options.bare`: an Iced CoffeeScript compiler option to turn on/off the safety wrapper.

* `options.runtime`: no Iced CoffeeScript runtime boilerplate is included in the compiled output by default.