Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chronoDave/tic-bundle
Multi-file development in TIC-80
https://github.com/chronoDave/tic-bundle
babel fantasy-console javascript tic-80 tic80
Last synced: 2 months ago
JSON representation
Multi-file development in TIC-80
- Host: GitHub
- URL: https://github.com/chronoDave/tic-bundle
- Owner: chronoDave
- License: gpl-3.0
- Created: 2020-05-15T12:14:54.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-10-21T21:20:42.000Z (2 months ago)
- Last Synced: 2024-10-22T05:59:12.468Z (2 months ago)
- Topics: babel, fantasy-console, javascript, tic-80, tic80
- Language: JavaScript
- Size: 423 KB
- Stars: 20
- Watchers: 4
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://www.npmjs.com/package/tic-bundle)
[](https://github.com/chronoDave/tic-bundle/actions/workflows/ci.yml)
# tic-bundle
Simple CLI tool for bundling [TIC-80](https://tic80.com/) cartridge code. Supports any language!
## Content
- [Installation](#installation)
- [Example](#example)
- [CLI](#cli)
- [Configuration](#configuration)
- [Options](#options)
- [Babel](#babel)
- [License](./LICENSE)
- [Donating](#donating)
## Installation
```
// Yarn
yarn add tic-bundle --dev
// Npm
npm i tic-bundle --save-dev
```
## Example
Config
```JSON
{
"files": ["ui.js", "main.js"],
"assets": ["assets.js"]
}
```
Input
`src/main.js`
```JS
function TIC() {
};
//
// 000:0100000010100000010000000000000000000000000000000000000000000000
//
```
`src/ui.js`
```JS
function ui() {
return 'ui';
};
```
`src/assets.js`
```JS
// script: js
//
// 000:0100000010100000010000000000000000000000000000000000000000000000
//
```
Output
`build.js`
```JS
// script: js
function ui() {
return 'ui';
};
function TIC() {
};
//
// 000:0100000010100000010000000000000000000000000000000000000000000000
//
```
## CLI
`package.json`
```JSON
{
"scripts": {
"watch": "tic-bundle"
}
}
```
CLI options
- `-r / --root` - Root folder
- `-w / --wait` - Wait interval
- `-c / --config` - Path to config file
- `-o / --output` - Bundled file output path
- `-n / --name` - Bundle file name
- `-f / --file` - Bundle file extension
- `-s / --script` - Language
- `-b / --build` - Build
## Configuration
`tic-bundle` supports config files. By default, `tic-bundle` looks for a `.ticbundle.js` file in the current directory, but an alternative location can be specified using `-c ` or `--config `.
The specificity is as folows:
- `.ticbundle.js`
- `.ticbundle.json`
- CLI
- Default config
Default config
```JS
{
root: 'src',
wait: 200,
metadata: {
title: null,
author: null,
desc: null,
script: 'js',
input: null,
saveid: null
},
output: {
path: './',
extension: 'js',
name: 'build'
},
files: [],
assets: [],
after: null
}
```
### Options
- `root` (default `src`) - Folder to watch.
- `wait` (default `200`) - [Chokidar awaitWriteFinish.stabilityThreshold](https://github.com/paulmillr/chokidar#performance)
- `metadata` - [Cartridge metadata](https://github.com/nesbox/TIC-80/wiki#cartridge-metadata)
- `metadata.title` - The name of the cart.
- `metadata.author` - The name of the developer.
- `metadata.description` - Optional description of the game.
- `metadata.script` (default `js`) - Used scripting language.
- `metadata.input` - Selects gamepad, mouse or keyboard input source.
- `metadata.saveid` - Allows save data to be shared within multiple games on a copy of TIC.
- `output.path` (default `./`) - Bundled file output path.
- `output.extension` (default `js`) - Bundle file output extension
- `output.name` (default `build`) - Bundled file name.
- `files` - Files to bundle. Asset data will be stripped (graphics data, sprite data, etc.) Files will be ordered by index (top first, bottom last).
- `assets` - Assets to bundle. Code data will be stripped. Assets will be ordered by index (top first, bottom last) and are always places below `files`.
- `after` - Run after generating the bundle, this can be used to further modify the bundle.
### Babel
`after` can be used to transform the bundled code. A common use-case for `js` is transforming `ES6` syntax to `ES5`.
Example
`.ticbundle.js`
```JS
module.exports = {
after: bundle => {
const { code } = require('@babel/standalone').transform(bundle, {
plugins: [require('@babel/plugin-transform-arrow-functions')]
});
return code;
}
};
```
## Donating
[](https://ko-fi.com/Y8Y41E23T)