#fbr - Brotli for MoonBit

• Decode only: import hustcer/fbr/decode
• Encode only: import hustcer/fbr/encode
• Full convenience API: import hustcer/fbr

#Small Artifacts By Design

#Installation

moon add hustcer/fbr

{
  "deps": {
    "hustcer/fbr": "0.8.2"
  }
}

#Decode Only

let plain = @decode.unbrotli_sync(compressed)

import {
  "hustcer/fbr/decode"
}

#Encode Only

let compressed = @encode.brotli_sync(
  data,
  opts={
    ..@encode.BrotliOptions::default(),
    quality: 9,
    window_bits: 22,
  },
)

import {
  "hustcer/fbr/encode"
}

#Full API

let compressed = @fbr.brotli_sync(data)
let plain = @fbr.unbrotli_sync(compressed)

import {
  "hustcer/fbr"
}

#Streams

• Memory is not window-bounded. The stream keeps the entire decompressed output for its lifetime, so memory grows with total output size rather than with the window. For very large payloads, prefer one-shot unbrotli_sync.
• Re-decode is per-push. Each meta-block is decoded speculatively and rolled back when the input is incomplete, so a single large meta-block fed in many tiny chunks is re-decoded on every push (quadratic in the worst case). Prefer reasonably sized chunks over byte-at-a-time input.
• UnbrotliOptions.out is ignored. Streaming output is delivered only through ondata; unlike one-shot unbrotli_sync, the stream does not write into a caller-provided buffer.

let stream = @encode.BrotliStream::new()
stream.set_ondata((chunk, is_final) => {
  // handle compressed chunk
})
stream.push(chunk1)
stream.push(chunk2, final_=true)

#Status

• brotli_sync supports quality levels 0..=11.
• unbrotli_sync decodes RFC 7932 Brotli streams, including static dictionary references and transforms.
• BrotliOptions exposes quality, window_bits, and max_input_size.
• UnbrotliOptions exposes an optional caller-provided output buffer (used by unbrotli_sync; ignored by UnbrotliStream), max_output_size, and max_input_size.
• In production builds, decode imports only common.
• In production builds, encode imports only common. Its moon.pkg imports decode only for white-box tests.
• The root package imports common, decode, and encode, and contains only facade wrappers, type aliases, and shared error/default aliases.
• BrotliStream is a buffering convenience wrapper, not a true incremental Brotli encoder.
• The static dictionary is built from byte chunks instead of one byte-per-entry FixedArray[Byte] literal.
• tools/ includes fixture, conformance, fuzz, size, and benchmark scripts.
• q0 and q1 currently emit valid stored streams and are not intended to match Google's low-quality compression ratio. q10 and q11 are valid but may still be larger than Google Brotli output; see the release report for measured data.

#Size Verification

just size

just size js,wasm-gc

• decode-only, importing hustcer/fbr/decode
• encode-only, importing hustcer/fbr/encode
• full, importing hustcer/fbr