QuokkaScript Compiler

3.0.1 verified Fri May 01 auth: no javascript maintenance

The QuokkaScript compiler (v3.0.1) is a build tool for a custom scripting language, enabling compilation of QuokkaScript source into executable forms. It requires a Type Table path for namespace resolution and supports configuration via JSON. The project appears to be in maintenance mode with no recent updates, and the documentation is sparse, making it primarily suitable for existing users of the custom language. Key differentiators are limited due to the niche, custom-language focus.

Common errors

error TypeError: Cannot read property 'resolve' of undefined ↓

cause Missing or incorrect Type Table path in config.

fix

Set a valid 'typeTable' path in config.json.

error Error: Could not locate QComponent4 in test/lib ↓

cause QComponent4 is not cloned to the expected location.

fix

Clone QComponent4 repository to the required directory (e.g., test/lib).

Warnings

gotcha The package requires a Type Table path to resolve namespaces; omitting it will cause compilation failures. ↓

fix Ensure your config.json includes a valid 'typeTable' property pointing to the type definitions file.

gotcha The compiler expects QComponent4 to be cloned into a specific directory (e.g., test/lib). ↓

fix Clone QComponent4 to the required directory as per your setup.

break Properties of implicit values are not resolved; this can lead to undefined behavior. ↓

fix Explicitly define all properties before use, or check the compiler documentation for implicit value handling.

Install

npm install quokka-script

yarn add quokka-script

pnpm add quokka-script

Quickstart

Shows how to configure and run the QuokkaScript compiler using a JSON config and the compile function.

// Build configuration (config.json)
{
  "typeTable": "./path/to/type-table.json",
  "sourceDir": "./src",
  "outputDir": "./dist"
}

// Build command
const { compile } = require('quokka-script');
const config = require('./config.json');
compile(config);