# Fumanchu

Handlebars + Helpers Together

Source Index: https://fumanchu.org/llms.txt

## Documentation

### Getting Started
URL: https://fumanchu.org/docs/
Description: Fumanchu Getting Started Guide

# fumanchu
Handlebars + Helpers Together

[![tests](https://github.com/jaredwray/fumanchu/actions/workflows/tests.yaml/badge.svg)](https://github.com/jaredwray/fumanchu/actions/workflows/tests.yaml)
[![codecov](https://codecov.io/gh/jaredwray/fumanchu/graph/badge.svg?token=gtYw78huva)](https://codecov.io/gh/jaredwray/fumanchu)
[![npm version](https://img.shields.io/npm/v/@jaredwray/fumanchu.svg)](https://npmjs.com/package/@jaredwray/fumanchu)
[![NPM License](https://img.shields.io/npm/l/%40jaredwray%2Ffumanchu)
](https://github.com/jaredwray/fumanchu/blob/main/LICENSE)
[![npm](https://img.shields.io/npm/dm/@jaredwray/fumanchu)](https://npmjs.com/package/@jaredwray/fumanchu)
[![](https://data.jsdelivr.com/v1/package/npm/@jaredwray/fumanchu/badge)](https://www.jsdelivr.com/package/npm/@jaredwray/fumanchu)

[Handlebars](https://github.com/handlebars-lang/handlebars.js) + [Handlebars-helpers](https://github.com/helpers/handlebars-helpers) (helpers are now maintained in this project) combined into a single package. In addition this project has **drastically** reduced the number of dependencies. 

Easily use it as a drop in replacement when using handlebars directly. More than 160 Handlebars helpers in ~20 categories. Helpers can be used with Assemble, Generate, Verb, Ghost, gulp-handlebars, grunt-handlebars, consolidate, or any node.js/Handlebars project. Currently **189 helpers** in **20 categories**! 🎉

# Table of Contents
* [Using in Nodejs](#usage-nodejs)
* [Using in the Browser](#usage-in-the-browser)
* [Just using Handlebar Helpers](#using-handlebars-helpers)
* [Migrating from v2 to v3](https://fumanchu.org/docs/migration/v2-to-v3/)
* [Migrating from v3 to v4](https://fumanchu.org/docs/migration/v3-to-v4/)
* [Helpers](https://fumanchu.org/docs/helpers/)
  * [array](https://fumanchu.org/docs/helpers/array/)
  * [code](https://fumanchu.org/docs/helpers/code/)
  * [comparison](https://fumanchu.org/docs/helpers/comparison/)
  * [collection](https://fumanchu.org/docs/helpers/collection/)
  * [date](https://fumanchu.org/docs/helpers/date/)
  * [fs](https://fumanchu.org/docs/helpers/fs/)
  * [html](https://fumanchu.org/docs/helpers/html/)
  * [i18n](https://fumanchu.org/docs/helpers/i18n/)
  * [inflection](https://fumanchu.org/docs/helpers/inflection/)
  * [logging](https://fumanchu.org/docs/helpers/logging/)
  * [markdown](https://fumanchu.org/docs/helpers/markdown/)
  * [match](https://fumanchu.org/docs/helpers/match/)
  * [math](https://fumanchu.org/docs/helpers/math/)
  * [misc](https://fumanchu.org/docs/helpers/misc/)
  * [number](https://fumanchu.org/docs/helpers/number/)
  * [object](https://fumanchu.org/docs/helpers/object/)
  * [path](https://fumanchu.org/docs/helpers/path/)
  * [regex](https://fumanchu.org/docs/helpers/regex/)
  * [string](https://fumanchu.org/docs/helpers/string/)
  * [url](https://fumanchu.org/docs/helpers/url/)
  * [utils](https://fumanchu.org/docs/helpers/utils/)
* [Caching](#caching)

# Usage Nodejs

```bash
npm install @jaredwray/fumanchu --save
```

To use Handlebars with all the helpers:

```javascript
import {fumanchu} from '@jaredwray/fumanchu';
const handlebars = fumanchu(); // this will return handlebars with all the helpers
const template = handlebars.compile('{{#if (eq foo "bar")}}<p>Foo is bar</p>{{/if}}');
const html = template({foo: 'bar'});
console.log(html); // <p>Foo is bar</p>
```

It's just that easy! No need to add Handlebars to your project, it's already included.

# Usage in the Browser

Fumanchu ships a browser-safe build that excludes Node-only helpers (`fs`, `path`, `logging`, `embed`, `css`, `js`, `escape`, `urlResolve`, `urlParse`, `stripProtocol`). Import it directly via the `/browser` subpath:

```javascript
import { fumanchu } from '@jaredwray/fumanchu/browser';
const handlebars = fumanchu();
const template = handlebars.compile('{{uppercase name}}');
console.log(template({ name: 'hello' })); // HELLO
```

The package also sets the `browser` export condition on the main entry, so webpack, Vite, esbuild, Rollup, and other browser-aware bundlers automatically pick up the browser build when you `import '@jaredwray/fumanchu'` from a browser target — no code change required. The public API (`fumanchu`, `helpers`, `HelperRegistry`) is identical to Node; only the set of registered helpers differs.

You can also load the browser build directly from a CDN such as [jsDelivr](https://www.jsdelivr.com/package/npm/@jaredwray/fumanchu) — no bundler required:

```html
<script type="module">
  import { fumanchu } from 'https://cdn.jsdelivr.net/npm/@jaredwray/fumanchu/dist/index.browser.mjs';
  const handlebars = fumanchu();
  document.body.textContent = handlebars.compile('{{uppercase name}}')({ name: 'hello' });
</script>
```

# Using Handlebars Helpers

If you only want to use handlebar helpers you can easily do that by doing the following:

```javascript
import {helpers} from '@jaredwray/fumanchu';
import handlebars from 'handlebars';
const helpersFunction = await helpers();
helpersFunction({ handlebars: handlebars });
const template = handlebars.compile('{{#if (eq foo "bar")}}<p>Foo is bar</p>{{/if}}');
const html = template({foo: 'bar'});
console.log(html); // <p>Foo is bar</p>
```

If using it with es6 you can access `handlebars` and `helpers`:

```javascript
import {handlebars, helpers} from '@jaredwray/fumanchu';
helpers({ handlebars: handlebars });
const template = handlebars.compile('{{#if (eq foo "bar")}}<p>Foo is bar</p>{{/if}}');
const html = template({foo: 'bar'});
console.log(html);
```

# Using the Helper Registry

The helper registry allows you to manage and use Handlebars helpers more easily. You can register new helpers, filter existing ones, and access them in your templates.

```js
import { HelperRegistry, handlebars } from '@jaredwray/fumanchu';

const registry = new HelperRegistry();
registry.register('eq', (a, b) => a === b);
registry.register('if', (condition, template) => condition ? template() : '');
const hbs = handlebars;
registry.load(hbs); // Load all helpers into Handlebars
```

If you want to do filtering you can use the `HelperFilter` on `load`:

```js
import { HelperRegistry, handlebars } from '@jaredwray/fumanchu';

const registry = new HelperRegistry();
registry.register('eq', (a, b) => a === b);
registry.register('if', (condition, template) => condition ? template() : '');
const hbs = handlebars;
registry.load(hbs, { names: ['if']}); // Load the helpers into Handlebars
```

In addition, we have made the helper functions have a compatibility such as `HelperRegistryCompatibility.NODEJS` or `HelperRegistryCompatibility.BROWSER`. This will allow you to filter out based on your environment!

# Caching

When caching is enabled, Fumanchu wraps the Handlebars `compile()` method to cache compiled template functions using [@cacheable/memory](https://github.com/jaredwray/cacheable/tree/main/packages/memory). If you compile the same template string multiple times, the cached version is returned instead of recompiling. The returned Handlebars instance is fully compatible -- caching is transparent to your existing code.

The `caching` option accepts three types:
- `boolean` -- `true` enables caching with defaults, `false` disables it
- `CacheableMemory` -- a pre-configured instance from `@cacheable/memory`
- `CacheableMemoryOptions` -- an options object passed to `CacheableMemory` (supports `ttl`, `lruSize`, `checkInterval`, etc.)

Here is an quick benchmark showing the performance advantage:

|                name                |  summary  |  ops/sec  |  time/op  |  margin  |  samples  |
|------------------------------------|:---------:|----------:|----------:|:--------:|----------:|
|  compile+render cached (v4.6.0)    |    🥇     |      45K  |     39µs  |  ±0.32%  |      25K  |
|  compile+render no-cache (v4.6.0)  |   -83%    |       8K  |    166µs  |  ±0.62%  |      10K  |

## Enable caching with default settings

```javascript
import { fumanchu } from '@jaredwray/fumanchu';
const handlebars = fumanchu({ caching: true });

const template = handlebars.compile('Hello {{name}}!');
template({ name: 'World' }); // compiles and caches

const template2 = handlebars.compile('Hello {{name}}!');
// returns the cached compiled function -- no recompilation
```

## Pass caching options

```javascript
import { fumanchu } from '@jaredwray/fumanchu';
const handlebars = fumanchu({
  caching: {
    ttl: '1h',         // Time-to-live in ms or human-readable string like '1h'
    lruSize: 500,      // LRU cache size limit (0 = unlimited)
    checkInterval: 0,  // Interval to check for expired items in ms (0 = disabled)
  },
});
```

## Pass a pre-configured `CacheableMemory` instance

This is useful if you want to share a cache across multiple Fumanchu instances or manage the cache lifecycle yourself:

```javascript
import { fumanchu, CacheableMemory } from '@jaredwray/fumanchu';
const cache = new CacheableMemory({ ttl: '1h', lruSize: 1000, useClone: false });

const hbs1 = fumanchu({ caching: cache });
const hbs2 = fumanchu({ caching: cache }); // shares the same cache as hbs1
```

### Array Helpers
URL: https://fumanchu.org/docs/helpers/array/
Description: Fumanchu provides a set of built-in helpers for working with arrays. These helpers allow you to iterate over arrays, check their length, and perform other common operations.


> **Availability:** Registered in both the Node and browser builds.

### {{after}}

Returns all of the items in an array after the specified index. Opposite of [before](#before).

**Params**

* `array` **{Array}**: Collection
* `n` **{Number}**: Starting index (number of items to exclude)
* `returns` **{Array}**: Array exluding `n` items.

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{after array 1}}
<!-- results in: '["c"]' -->
```

### {{arrayify}}

Cast the given `value` to an array.

**Params**

* `value` **{any}**
* `returns` **{Array}**

**Example**

```html
{{arrayify "foo"}}
<!-- results in: [ "foo" ] -->
```

### {{before}}

Return all of the items in the collection before the specified count. Opposite of [after](#after).

**Params**

* `array` **{Array}**
* `n` **{Number}**
* `returns` **{Array}**: Array excluding items after the given number.

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{before array 2}}
<!-- results in: '["a", "b"]' -->
```

### {{eachIndex}}

**Params**

* `array` **{Array}**
* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'] -->
{{#eachIndex array}}
  {{item}} is {{index}}
{{/eachIndex}}
```

### {{filter}}

Block helper that filters the given array and renders the block for values that evaluate to `true`, otherwise the inverse block is returned.

**Params**

* `array` **{Array}**
* `value` **{any}**
* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{#filter array "foo"}}AAA{{else}}BBB{{/filter}}
<!-- results in: 'BBB' -->
```

### {{first}}

Returns the first item, or first `n` items of an array.

**Params**

* `array` **{Array}**
* `n` **{Number}**: Number of items to return, starting at `0`.
* `returns` **{Array}**

**Example**

```html
{{first "['a', 'b', 'c', 'd', 'e']" 2}}
<!-- results in: '["a", "b"]' -->
```

### {{forEach}}

Iterates over each item in an array and exposes the current item in the array as context to the inner block. In addition to the current array item, the helper exposes the following variables to the inner block:

* `index`
* `total`
* `isFirst`
* `isLast`
Also, `@index` is exposed as a private variable, and additional
private variables may be defined as hash arguments.

**Params**

* `array` **{Array}**
* `returns` **{String}**

**Example**

```html
<!-- accounts = [
{'name': 'John', 'email': 'john@example.com'},
{'name': 'Malcolm', 'email': 'malcolm@example.com'},
{'name': 'David', 'email': 'david@example.com'}
] -->

{{#forEach accounts}}
  <a href="mailto:{{ email }}" title="Send an email to {{ name }}">
	{{ name }}
  </a>{{#unless isLast}}, {{/unless}}
{{/forEach}}
```

### {{inArray}}

Block helper that renders the block if an array has the given `value`. Optionally specify an inverse block to render when the array does not have the given value.

**Params**

* `array` **{Array}**
* `value` **{any}**
* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{#inArray array "d"}}
  foo
{{else}}
  bar
{{/inArray}}
<!-- results in: 'bar' -->
```

### {{isArray}}

Returns true if `value` is an es5 array.

**Params**

* `value` **{any}**: The value to test.
* `returns` **{Boolean}**

**Example**

```html
{{isArray "abc"}}
<!-- results in: false -->

<!-- array: [1, 2, 3] -->
{{isArray array}}
<!-- results in: true -->
```

### {{itemAt}}

Returns the item from `array` at index `idx`.

**Params**

* `array` **{Array}**
* `idx` **{Number}**
* `returns` **{any}** `value`

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{itemAt array 1}}
<!-- results in: 'b' -->
```

### {{join}}

Join all elements of array into a string, optionally using a given separator.

**Params**

* `array` **{Array}**
* `separator` **{String}**: The separator to use. Defaults to `,`.
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{join array}}
<!-- results in: 'a, b, c' -->

{{join array '-'}}
<!-- results in: 'a-b-c' -->
```
### {{equalsLength}}

Returns true if the the length of the given `value` is equal
to the given `length`. Can be used as a block or inline helper.

**Params**

* `value` **{Array|String}**
* `length` **{Number}**
* `options` **{Object}**
* `returns` **{String}**

### {{last}}

Returns the last item, or last `n` items of an array or string. Opposite of [first](#first).

**Params**

* `value` **{Array|String}**: Array or string.
* `n` **{Number}**: Number of items to return from the end of the array.
* `returns` **{Array}**

**Example**

```html
<!-- var value = ['a', 'b', 'c', 'd', 'e'] -->

{{last value}}
<!-- results in: ['e'] -->

{{last value 2}}
<!-- results in: ['d', 'e'] -->

{{last value 3}}
<!-- results in: ['c', 'd', 'e'] -->
```

### {{length}}

Returns the length of the given string or array.

**Params**

* `value` **{Array|Object|String}**
* `returns` **{Number}**: The length of the value.

**Example**

```html
{{length '["a", "b", "c"]'}}
<!-- results in: 3 -->

<!-- results in: myArray = ['a', 'b', 'c', 'd', 'e']; -->
{{length myArray}}
<!-- results in: 5 -->

<!-- results in: myObject = {'a': 'a', 'b': 'b'}; -->
{{length myObject}}
<!-- results in: 2 -->
```

### {{lengthEqual}}

Alias for [equalsLength](#equalsLength)

### {{map}}

Returns a new array, created by calling `function` on each element of the given `array`. For example,

**Params**

* `array` **{Array}**
* `fn` **{Function}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'], and "double" is a
fictitious function that duplicates letters -->
{{map array double}}
<!-- results in: '["aa", "bb", "cc"]' -->
```

### {{pluck}}

Map over the given object or array or objects and create an array of values from the given `prop`. Dot-notation may be used (as a string) to get nested properties.

**Params**

* `collection` **{Array|Object}**
* `prop` **{Function}**
* `returns` **{String}**

**Example**

```html
// {{pluck items "data.title"}}
<!-- results in: '["aa", "bb", "cc"]' -->
```

### {{reverse}}

Reverse the elements in an array, or the characters in a string.

**Params**

* `value` **{Array|String}**
* `returns` **{Array|String}**: Returns the reversed string or array.

**Example**

```html
<!-- value: 'abcd' -->
{{reverse value}}
<!-- results in: 'dcba' -->
<!-- value: ['a', 'b', 'c', 'd'] -->
{{reverse value}}
<!-- results in: ['d', 'c', 'b', 'a'] -->
```

### {{some}}

Block helper that returns the block if the callback returns true for some value in the given array.

**Params**

* `array` **{Array}**
* `iter` **{Function}**: Iteratee
* **{Options}**: Handlebars provided options object
* `returns` **{String}**

**Example**

```html
<!-- array: [1, 'b', 3] -->
{{#some array isString}}
  Render me if the array has a string.
{{else}}
  Render me if it doesn't.
{{/some}}
<!-- results in: 'Render me if the array has a string.' -->
```

### {{sort}}

Sort the given `array`. If an array of objects is passed, you may optionally pass a `key` to sort on as the second argument. You may alternatively pass a sorting function as the second argument.

**Params**

* `array` **{Array}**: the array to sort.
* `key` **{String|Function}**: The object key to sort by, or sorting function.

**Example**

```html
<!-- array: ['b', 'a', 'c'] -->
{{sort array}}
<!-- results in: '["a", "b", "c"]' -->
```

### {{sortBy}}

Sort an `array`. If an array of objects is passed, you may optionally pass a `key` to sort on as the second argument. You may alternatively pass a sorting function as the second argument.

**Params**

* `array` **{Array}**: the array to sort.
* `props` **{String|Function}**: One or more properties to sort by, or sorting functions to use.

**Example**

```html
<!-- array: [{a: 'zzz'}, {a: 'aaa'}] -->
{{sortBy array "a"}}
<!-- results in: '[{"a":"aaa"}, {"a":"zzz"}]' -->
```

### {{withAfter}}

Use the items in the array _after_ the specified index as context inside a block. Opposite of [withBefore](#withBefore).

**Params**

* `array` **{Array}**
* `idx` **{Number}**
* `options` **{Object}**
* `returns` **{Array}**

**Example**

```html
<!-- array: ['a', 'b', 'c', 'd', 'e'] -->
{{#withAfter array 3}}
  {{this}}
{{/withAfter}}
<!-- results in: "de" -->
```

### {{withBefore}}

Use the items in the array _before_ the specified index as context inside a block. Opposite of [withAfter](#withAfter).

**Params**

* `array` **{Array}**
* `idx` **{Number}**
* `options` **{Object}**
* `returns` **{Array}**

**Example**

```html
<!-- array: ['a', 'b', 'c', 'd', 'e'] -->
{{#withBefore array 3}}
  {{this}}
{{/withBefore}}
<!-- results in: 'ab' -->
```

### {{withFirst}}

Use the first item in a collection inside a handlebars block expression. Opposite of [withLast](#withLast).

**Params**

* `array` **{Array}**
* `idx` **{Number}**
* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{#withFirst array}}
  {{this}}
{{/withFirst}}
<!-- results in: 'a' -->
```

### {{withGroup}}

Block helper that groups array elements by given group `size`.

**Params**

* `array` **{Array}**: The array to iterate over
* `size` **{Number}**: The desired length of each array "group"
* `options` **{Object}**: Handlebars options
* `returns` **{String}**

**Example**

```html
<!-- array: ['a','b','c','d','e','f','g','h'] -->
{{#withGroup array 4}}
  {{#each this}}
	{{.}}
  {{each}}
  <br>
{{/withGroup}}
<!-- results in: -->
<!-- 'a','b','c','d'<br> -->
<!-- 'e','f','g','h'<br> -->
```

### {{withLast}}

Use the last item or `n` items in an array as context inside a block. Opposite of [withFirst](#withFirst).

**Params**

* `array` **{Array}**
* `idx` **{Number}**: The starting index.
* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
<!-- array: ['a', 'b', 'c'] -->
{{#withLast array}}
  {{this}}
{{/withLast}}
<!-- results in: 'c' -->
```

### {{withSort}}

Block helper that sorts a collection and exposes the sorted collection as context inside the block.

**Params**

* `array` **{Array}**
* `prop` **{String}**
* `options` **{Object}**: Specify `reverse="true"` to reverse the array.
* `returns` **{String}**

**Example**

```html
<!-- array: ['b', 'a', 'c'] -->
{{#withSort array}}{{this}}{{/withSort}}
<!-- results in: 'abc' -->
```

### {{unique}}

Block helper that return an array with all duplicate values removed. Best used along with a [each](#each) helper.

**Params**

* `array` **{Array}**
* `options` **{Object}**
* `returns` **{Array}**

**Example**

```html
<!-- array: ['a', 'a', 'c', 'b', 'e', 'e'] -->
{{#each (unique array)}}{{.}}{{/each}}
<!-- results in: 'acbe' -->
```

### Logging Helpers
URL: https://fumanchu.org/docs/helpers/logging/
Description: Handlebars provides a set of built-in helpers for logging and debugging. These helpers output messages to the terminal with various formatting and color options, making it easier to debug templates and display status information. Node.js only.


> **Availability:** Registered in the Node build only. Not available in the browser build.

## logging

> **Note:** These helpers are only available in Node.js environments. They are not compatible with browser-based Handlebars usage.

These helpers output messages to the terminal with ANSI color formatting. All logging helpers return an empty string to avoid affecting template output.

### {{log}}

Logs an unstyled message to the terminal via `console.log`.

**Params**

* `...args` **{any}**: Values to log
* `returns` **{String}**: Empty string

**Example**

```html
{{log "Processing item:" itemName}}
<!-- outputs to console: Processing item: Widget -->
```

### {{ok}}

Logs a green colored message preceded by a checkmark to the terminal. Useful for indicating successful operations.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{ok "Build completed successfully"}}
<!-- outputs to console: ✓ Build completed successfully (in green) -->
```

### {{success}}

Logs a green colored message to the terminal. Similar to `ok` but without the checkmark.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{success "All tests passed"}}
<!-- outputs to console: All tests passed (in green) -->
```

### {{info}}

Logs a cyan colored informational message to the terminal.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{info "Processing" totalCount "items"}}
<!-- outputs to console: Processing 42 items (in cyan) -->
```

### {{warning}}

Logs a yellow colored warning message to stderr.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{warning "Deprecated feature detected"}}
<!-- outputs to stderr: Deprecated feature detected (in yellow) -->
```

### {{warn}}

Alias for `{{warning}}`. Logs a yellow colored warning message to stderr.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{warn "This method will be removed in v5"}}
<!-- outputs to stderr: This method will be removed in v5 (in yellow) -->
```

### {{error}}

Logs a red colored error message to stderr.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{error "Failed to process item:" itemId}}
<!-- outputs to stderr: Failed to process item: 123 (in red) -->
```

### {{danger}}

Alias for `{{error}}`. Logs a red colored error message to stderr.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{danger "Critical failure in module"}}
<!-- outputs to stderr: Critical failure in module (in red) -->
```

### {{bold}}

Logs a bold formatted message to stderr.

**Params**

* `...args` **{any}**: Values to log (will be joined with spaces)
* `returns` **{String}**: Empty string

**Example**

```html
{{bold "Important Notice"}}
<!-- outputs to stderr: Important Notice (in bold) -->
```

### {{_debug}}

Outputs debug information including the provided value and the current Handlebars context. Useful for inspecting template data during development.

**Params**

* `...args` **{any}**: Optional values to inspect
* `returns` **{String}**: Empty string

**Example**

```html
{{_debug user}}
<!-- outputs to stderr:
──────────────────────────────────────────────────
VALUE: { name: "John", role: "admin" }
CONTEXT: { users: [...], settings: {...} }
──────────────────────────────────────────────────
-->
```

### {{_inspect}}

Formats a value as JSON and returns it for display in the template. Supports different output formats.

**Params**

* `context` **{any}**: The value to inspect
* `options.hash.type` **{String}**: Output format: `"html"` (default), `"md"`, or any other value for raw JSON
* `returns` **{String}**: Formatted JSON string

**Example**

```html
{{_inspect user}}
<!-- returns HTML formatted JSON:
<div class="highlight highlight-json">
<pre><code>
{
  "name": "John",
  "role": "admin"
}</code></pre></div>
-->

{{_inspect user type="md"}}
<!-- returns Markdown formatted JSON:
```json
{
  "name": "John",
  "role": "admin"
}
```
-->

{{_inspect user type="raw"}}
<!-- returns raw JSON:
{
  "name": "John",
  "role": "admin"
}
-->
```

### Code Helpers
URL: https://fumanchu.org/docs/helpers/code/
Description: Handlebars provides a set of built-in helpers for working with code. These helpers are used to format and manipulate code snippets, making it easier to display code in a readable format.


> **Availability**
>
> | Helper | Node | Browser |
> | --- | :---: | :---: |
> | `embed` | ✅ | — |
> | `gist` | ✅ | ✅ |
> | `jsfiddle` | ✅ | ✅ |

# Code Helpers

### {{embed}}

Embed code from an external file as preformatted text.

**Params**

* `filepath` **{String}**: filepath to the file to embed.
* `language` **{String}**: Optionally specify the language to use for syntax highlighting.
* `returns` **{String}**

**Example**

```html
{{embed 'path/to/file.js'}}
<!-- optionally specify the language to use -->
{{embed 'path/to/file.hbs' 'html'}}
```

### {{gist}}

Embed a GitHub Gist using only the id of the Gist

**Params**

* `id` **{String}**
* `returns` **{String}**

**Example**

```html
{{gist "12345"}}
```

### {{jsfiddle}}

Generate the HTML for a jsFiddle iframe with the given options.

**Params**

* `id` **{String}**: The jsFiddle id (required)
* `width` **{String}**: Width of the iframe (default: "100%")
* `height` **{String}**: Height of the iframe (default: "300")
* `skin` **{String}**: Skin path (default: "/presentation/")
* `tabs` **{String}**: Tabs to display (default: "result,js,html,css")
* `allowfullscreen` **{String}**: Allowfullscreen attribute (default: "allowfullscreen")
* `frameborder` **{String}**: Frameborder attribute (default: "0")
* `returns` **{String}**

**Example**

```html
{{jsfiddle id="0dfk10ks"}}
<!-- with custom options -->
{{jsfiddle id="0dfk10ks" height="500" tabs="js,result"}}
```

### Comparison Helpers
URL: https://fumanchu.org/docs/helpers/comparison/
Description: Handlebars provides a set of built-in helpers for performing comparisons. These helpers are used to compare values, making it easier to implement conditional logic in your templates.


> **Availability:** Registered in both the Node and browser builds.

## comparison

### {{and}}

Helper that renders the block if **all** of the given values are truthy. If an inverse block is specified it will be rendered when falsy. Works as a block helper, inline helper or subexpression.

**Params**

* `values` **{any}**: Variable number of values to check
* `returns` **{Boolean}**

**Example**

```handlebars
<!-- {great: true, magnificent: true} -->
{{#if (and great magnificent)}}A{{else}}B{{/if}}
<!-- results in: 'A' -->

<!-- {great: true, magnificent: false} -->
{{#if (and great magnificent)}}A{{else}}B{{/if}}
<!-- results in: 'B' -->
```

### {{compare}}

Render a block when a comparison of the first and third arguments returns true. The second argument is the operator to use.

**Supported Operators**

* `==` - loose equality
* `===` - strict equality
* `!=` - loose inequality
* `!==` - strict inequality
* `<` - less than
* `>` - greater than
* `<=` - less than or equal
* `>=` - greater than or equal
* `typeof` - checks if typeof first argument equals second argument

**Params**

* `a` **{any}**: The first value to compare
* `operator` **{String}**: The operator to use for comparison
* `b` **{any}**: The second value to compare
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (compare 10 ">" 5)}}A{{else}}B{{/if}}
<!-- results in: 'A' -->

{{#if (compare "hello" "typeof" "string")}}A{{else}}B{{/if}}
<!-- results in: 'A' -->
```

### {{contains}}

Block helper that renders the block if `collection` has the given `value`, otherwise the inverse block is rendered (if specified). If a `startIndex` is specified, the search begins at that index.

**Params**

* `collection` **{Array|Object|String}**: The collection to search.
* `value` **{any}**: The value to check for.
* `[startIndex=0]` **{Number}**: Optionally define the starting index.
* `returns` **{Boolean}**

**Example**

```handlebars
<!-- array = ['a', 'b', 'c'] -->
{{#if (contains array "b")}}
  This will be rendered.
{{else}}
  This will not be rendered.
{{/if}}

<!-- Works with strings too -->
{{#if (contains "hello world" "world")}}
  Found it!
{{/if}}

<!-- Works with objects (checks for key) -->
{{#if (contains object "keyName")}}
  Key exists!
{{/if}}
```

### {{default}}

Returns the first value that is not null or undefined, otherwise returns an empty string.

**Params**

* `values` **{any}**: Variable number of values to check
* `returns` **{any}**: The first non-null/undefined value, or empty string

**Example**

```handlebars
{{default title "Untitled"}}
<!-- If title is undefined, returns "Untitled" -->

{{default a b c "fallback"}}
<!-- Returns first non-null value, or "fallback" -->
```

### {{eq}}

Block helper that renders a block if `a` is **strictly equal to** `b` (using `===`).
If an inverse block is specified it will be rendered when falsy.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (eq name "John")}}
  Hello John!
{{else}}
  Hello stranger!
{{/if}}
```

### {{gt}}

Block helper that renders a block if `a` is **greater than** `b`.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (gt count 10)}}
  More than 10 items
{{else}}
  10 or fewer items
{{/if}}
```

### {{gte}}

Block helper that renders a block if `a` is **greater than or equal to** `b`.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (gte age 18)}}
  Adult
{{else}}
  Minor
{{/if}}
```

### {{has}}

Block helper that renders a block if `value` has `pattern`.
If an inverse block is specified it will be rendered when falsy.

**Params**

* `value` **{any}**: The value to check (array, string, or object).
* `pattern` **{any}**: The pattern to check for.
* `returns` **{Boolean}**

**Example**

```handlebars
<!-- array = ['a', 'b', 'c'] -->
{{#if (has array "b")}}
  Found it!
{{/if}}

<!-- string -->
{{#if (has "hello world" "world")}}
  Found it!
{{/if}}

<!-- object (checks for key) -->
{{#if (has user "email")}}
  User has email
{{/if}}
```

### {{isFalsey}}

Returns true if the given `value` is falsey. Recognizes common falsey keywords like "false", "no", "none", "null", "0", "nope", etc.

**Params**

* `val` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (isFalsey value)}}
  Value is falsey
{{/if}}

<!-- Recognizes falsey keywords -->
{{#if (isFalsey "no")}}
  This renders because "no" is falsey
{{/if}}
```

### {{isTruthy}}

Returns true if the given `value` is truthy (not falsey).

**Params**

* `val` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (isTruthy value)}}
  Value is truthy
{{/if}}
```

### {{ifEven}}

Returns true if the given value is an even number.

**Params**

* `number` **{Number}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (ifEven value)}}
  Value is even
{{else}}
  Value is odd
{{/if}}
```

### {{ifNth}}

Returns true if `b` is divisible by `a` (remainder is zero when `b` is divided by `a`).

**Params**

* `a` **{Number}**: The divisor
* `b` **{Number}**: The number to check
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (ifNth 3 index)}}
  Index is divisible by 3
{{/if}}
```

### {{ifOdd}}

Block helper that renders a block if `value` is **an odd number**.

**Params**

* `value` **{Number}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (ifOdd value)}}
  Value is odd
{{else}}
  Value is even
{{/if}}
```

### {{is}}

Block helper that renders a block if `a` is **equal to** `b` using loose equality (`==`).
Similar to [eq](#eq) but does not use strict equality.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (is 1 "1")}}
  This renders because 1 == "1" is true
{{/if}}
```

### {{isnt}}

Block helper that renders a block if `a` is **not equal to** `b` using loose inequality (`!=`).
Similar to [unlessEq](#unlesseq) but does not use strict equality.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (isnt name "admin")}}
  Not admin
{{/if}}
```

### {{lt}}

Block helper that renders a block if `a` is **less than** `b`.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (lt age 18)}}
  Minor
{{else}}
  Adult
{{/if}}
```

### {{lte}}

Block helper that renders a block if `a` is **less than or equal to** `b`.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (lte count 10)}}
  10 or fewer items
{{else}}
  More than 10 items
{{/if}}
```

### {{neither}}

Block helper that renders a block if **neither of** the given values are truthy.

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (neither isAdmin isModerator)}}
  Regular user
{{else}}
  Has elevated privileges
{{/if}}
```

### {{not}}

Returns true if `val` is falsey. Works as a block or inline helper.

**Params**

* `val` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (not isLoggedIn)}}
  Please log in
{{/if}}
```

### {{or}}

Block helper that renders a block if **any of** the given values is truthy.

**Params**

* `values` **{any}**: Variable number of values to check
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (or isAdmin isModerator isOwner)}}
  Has access
{{else}}
  Access denied
{{/if}}
```

### {{unlessEq}}

Block helper that returns true **unless `a` is strictly equal to `b`** (using `!==`).

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (unlessEq status "active")}}
  Status is not active
{{/if}}
```

### {{unlessGt}}

Block helper that returns true **unless `a` is greater than `b`** (equivalent to `a <= b`).

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (unlessGt count 100)}}
  Count is 100 or less
{{/if}}
```

### {{unlessLt}}

Block helper that returns true **unless `a` is less than `b`** (equivalent to `a >= b`).

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (unlessLt age 18)}}
  18 or older
{{/if}}
```

### {{unlessGteq}}

Block helper that returns true **unless `a` is greater than or equal to `b`** (equivalent to `a < b`).

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (unlessGteq age 21)}}
  Under 21
{{/if}}
```

### {{unlessLteq}}

Block helper that returns true **unless `a` is less than or equal to `b`** (equivalent to `a > b`).

**Params**

* `a` **{any}**
* `b` **{any}**
* `returns` **{Boolean}**

**Example**

```handlebars
{{#if (unlessLteq count 0)}}
  Count is greater than 0
{{/if}}
```

### Collection Helpers
URL: https://fumanchu.org/docs/helpers/collection/
Description: Handlebars provides a set of built-in helpers for working with collections. These helpers are used to manipulate and format collections, making it easier to work with data in templates.


> **Availability:** Registered in both the Node and browser builds.

## collection

### {{isEmpty}}

Inline, subexpression, or block helper that returns true (or the block) if the given collection is empty, or false (or the inverse block, if supplied) if the collection is not empty.

A collection is considered empty if:
- It is `null` or `undefined`
- It is an array with length 0
- It is an object with no keys

**Params**

* `collection` **{Array|Object}**: The collection to check
* `returns` **{Boolean}**

**Example**

```handlebars
<!-- array: [] -->
{{#if (isEmpty array)}}
  Array is empty
{{else}}
  Array has items
{{/if}}
<!-- results in: 'Array is empty' -->

<!-- object: {} -->
{{#if (isEmpty object)}}
  Object is empty
{{/if}}

<!-- array: ['a', 'b'] -->
{{#if (isEmpty array)}}
  Empty
{{else}}
  Has {{array.length}} items
{{/if}}
<!-- results in: 'Has 2 items' -->
```

### {{iterate}}

Block helper that iterates over an array or object. If an array is given, it iterates over each element with its index. If an object is given, it iterates over each key-value pair. If the collection is null/undefined or not iterable, the inverse block is returned.

**Params**

* `collection` **{Object|Array}**: The collection to iterate over
* `fn` **{Function}**: The block function called for each item, receives `(value, key/index)`
* `inverse` **{Function}**: Optional inverse block if collection is empty or invalid
* `returns` **{String}**

**Example**

```handlebars
<!-- array: ['a', 'b', 'c'] -->
{{#iterate array}}
  Index {{@index}}: {{this}}
{{/iterate}}
<!-- results in:
  Index 0: a
  Index 1: b
  Index 2: c
-->

<!-- object: {name: 'John', age: 30} -->
{{#iterate object}}
  {{@key}}: {{this}}
{{/iterate}}
<!-- results in:
  name: John
  age: 30
-->

<!-- With inverse block for empty/invalid collections -->
{{#iterate emptyArray}}
  {{this}}
{{else}}
  No items found
{{/iterate}}
<!-- results in: 'No items found' -->
```

### Date Helpers
URL: https://fumanchu.org/docs/helpers/date/
Description: Handlebars provides a comprehensive set of built-in helpers for working with dates. These helpers are used to format, manipulate, and compare dates, making it easier to display and work with date information.


> **Availability:** Registered in both the Node and browser builds.

## Date Helpers

Fumanchu provides powerful date manipulation capabilities using dayjs and chrono-node for natural language date parsing.

### {{year}}

Get the current year as a string.

**Example**

```handlebars
{{year}}
<!-- 2025 -->
```

### {{date}}

Format a date with support for human-readable date strings, Date objects, timestamps, or defaults to current date.

**Parameters:**
- `dateInput` (optional): Date string, Date object, timestamp, or undefined (defaults to now)
- `format` (optional): Format string (defaults to "YYYY-MM-DD")

**Supported format tokens:**
- `YYYY` or `yyyy`: 4-digit year
- `YY` or `yy`: 2-digit year
- `MM` or `mm`: Month (01-12)
- `DD` or `dd`: Day of month (01-31)
- `HH` or `hh`: Hour (00-23)
- `mm`: Minute (00-59)
- `ss`: Second (00-59)

**Examples**

```handlebars
{{date "January 15, 2023" "YYYY-MM-DD"}}
<!-- 2023-01-15 -->

{{date "5 years ago" "YYYY"}}
<!-- 2020 -->

{{date "next Friday" "MM/DD/YYYY"}}
<!-- 11/21/2025 -->

{{date}}
<!-- 2025-11-17 (current date) -->

{{date "2023-01-15" "dd/mm/yyyy"}}
<!-- 15/01/2023 -->
```

### {{moment}}

Legacy alias for `{{date}}`. Works exactly the same as the date helper.

**Example**

```handlebars
{{moment "December 25, 2023" "YYYY-MM-DD"}}
<!-- 2023-12-25 -->
```

---

## Current Time Helpers

### {{timestamp}}

Returns the current Unix timestamp in milliseconds.

**Example**

```handlebars
{{timestamp}}
<!-- 1700236800000 -->
```

### {{now}}

Returns the current date/time with optional formatting.

**Parameters:**
- `format` (optional): Format string (defaults to "YYYY-MM-DD HH:mm:ss")

**Examples**

```handlebars
{{now}}
<!-- 2025-11-17 14:30:45 -->

{{now "YYYY-MM-DD"}}
<!-- 2025-11-17 -->

{{now "HH:mm:ss"}}
<!-- 14:30:45 -->
```

---

## Relative Time Helpers

### {{fromNow}}

Display relative time from now (e.g., "5 minutes ago", "in 2 hours").

**Parameters:**
- `dateInput`: Date string, Date object, or timestamp

**Examples**

```handlebars
{{fromNow "2 days ago"}}
<!-- 2 days ago -->

{{fromNow "tomorrow"}}
<!-- in a day -->

{{fromNow "January 1, 2025"}}
<!-- 10 months ago -->
```

### {{ago}}

Alias for `{{fromNow}}`. Shows how long ago a date was.

**Example**

```handlebars
{{ago "5 minutes ago"}}
<!-- 5 minutes ago -->
```

### {{toNow}}

Opposite of `fromNow`. Shows relative time to now (less commonly used).

**Example**

```handlebars
{{toNow "2 hours ago"}}
<!-- in 2 hours -->
```

---

## Date Arithmetic Helpers

### {{dateAdd}}

Add time to a date.

**Parameters:**
- `dateInput` (optional): Date to add to (defaults to now)
- `amount`: Number to add
- `unit`: Unit of time ("year", "month", "week", "day", "hour", "minute", "second")

**Examples**

```handlebars
{{dateAdd "2023-01-15" 5 "days"}}
<!-- 2023-01-20 00:00:00 -->

{{dateAdd "2023-01-15" 2 "months"}}
<!-- 2023-03-15 00:00:00 -->

{{dateAdd undefined 1 "year"}}
<!-- 2026-11-17 14:30:45 (current date + 1 year) -->
```

### {{dateSubtract}}

Subtract time from a date.

**Parameters:**
- `dateInput` (optional): Date to subtract from (defaults to now)
- `amount`: Number to subtract
- `unit`: Unit of time

**Examples**

```handlebars
{{dateSubtract "2023-01-15" 5 "days"}}
<!-- 2023-01-10 00:00:00 -->

{{dateSubtract "2023-01-15" 2 "weeks"}}
<!-- 2023-01-01 00:00:00 -->
```

---

## Date Period Helpers

### {{startOf}}

Get the start of a time period.

**Parameters:**
- `dateInput` (optional): Date (defaults to now)
- `unit`: Unit of time ("year", "month", "week", "day", "hour", "minute", "second")

**Examples**

```handlebars
{{startOf "2023-01-15" "month"}}
<!-- 2023-01-01 00:00:00 -->

{{startOf "2023-06-15" "year"}}
<!-- 2023-01-01 00:00:00 -->

{{startOf "2023-01-15 14:30:45" "day"}}
<!-- 2023-01-15 00:00:00 -->
```

### {{endOf}}

Get the end of a time period.

**Parameters:**
- `dateInput` (optional): Date (defaults to now)
- `unit`: Unit of time

**Examples**

```handlebars
{{endOf "2023-01-15" "month"}}
<!-- 2023-01-31 23:59:59 -->

{{endOf "2023-06-15" "year"}}
<!-- 2023-12-31 23:59:59 -->
```

---

## Date Comparison Helpers

### {{isBefore}}

Check if the first date is before the second date.

**Parameters:**
- `date1`: First date
- `date2`: Second date

**Returns:** `true` or `false`

**Example**

```handlebars
{{#if (isBefore "2023-01-10" "2023-01-15")}}
  Date 1 is before Date 2
{{/if}}
```

### {{isAfter}}

Check if the first date is after the second date.

**Parameters:**
- `date1`: First date
- `date2`: Second date

**Returns:** `true` or `false`

**Example**

```handlebars
{{#if (isAfter "2023-01-20" "2023-01-15")}}
  Date 1 is after Date 2
{{/if}}
```

### {{isSame}}

Check if two dates are the same, with optional unit precision.

**Parameters:**
- `date1`: First date
- `date2`: Second date
- `unit` (optional): Unit for comparison ("year", "month", "day", etc.)

**Returns:** `true` or `false`

**Examples**

```handlebars
{{#if (isSame "2023-01-15" "2023-01-15")}}
  Dates are the same
{{/if}}

{{#if (isSame "2023-01-15" "2023-12-31" "year")}}
  Same year
{{/if}}
```

### {{isBetween}}

Check if a date is between two other dates (inclusive).

**Parameters:**
- `dateInput`: Date to check
- `startDate`: Start of range
- `endDate`: End of range

**Returns:** `true` or `false`

**Example**

```handlebars
{{#if (isBetween "2023-01-15" "2023-01-10" "2023-01-20")}}
  Date is in range
{{/if}}
```

---

## Date Utilities

### {{diff}}

Calculate the difference between two dates.

**Parameters:**
- `date1`: First date
- `date2`: Second date
- `unit` (optional): Unit for result ("year", "month", "day", "hour", etc.). Defaults to milliseconds.

**Returns:** Number

**Examples**

```handlebars
{{diff "2023-01-20" "2023-01-15" "days"}}
<!-- 5 -->

{{diff "2023-03-15" "2023-01-15" "months"}}
<!-- 2 -->

{{diff "2025-01-15" "2023-01-15" "years"}}
<!-- 2 -->
```

### {{toISOString}}

Convert a date to ISO 8601 format.

**Parameters:**
- `dateInput`: Date to convert

**Examples**

```handlebars
{{toISOString "2023-01-15"}}
<!-- 2023-01-15T00:00:00.000Z -->

{{toISOString "January 15, 2023"}}
<!-- 2023-01-15T00:00:00.000Z -->
```

---

## Internationalization Helpers

### {{dateTimezone}}

Format a date in a specific timezone.

**Parameters:**
- `dateInput`: Date to format
- `timezone`: IANA timezone string (e.g., "America/New_York", "UTC", "Europe/London")
- `format` (optional): Format string (defaults to "YYYY-MM-DD HH:mm:ss")

**Examples**

```handlebars
{{dateTimezone "2023-01-15 12:00:00" "America/New_York" "YYYY-MM-DD HH:mm:ss"}}
<!-- 2023-01-15 07:00:00 -->

{{dateTimezone "2023-01-15" "UTC"}}
<!-- 2023-01-15 00:00:00 -->
```

### {{dateLocale}}

Format a date with a specific locale.

**Parameters:**
- `dateInput`: Date to format
- `locale`: Locale code (e.g., "en", "fr", "de")
- `format` (optional): Format string (defaults to "YYYY-MM-DD HH:mm:ss")

**Example**

```handlebars
{{dateLocale "2023-01-15" "en" "YYYY-MM-DD"}}
<!-- 2023-01-15 -->
```

---

## Natural Language Date Parsing

All date helpers support natural language date parsing powered by chrono-node:

- "today", "tomorrow", "yesterday"
- "next Friday", "last Monday"
- "5 days ago", "in 2 weeks"
- "January 15, 2023"
- "2023-01-15"
- Date objects
- Unix timestamps

**Examples**

```handlebars
{{date "tomorrow" "YYYY-MM-DD"}}
{{date "next Friday" "MM/DD/YYYY"}}
{{date "5 years ago" "YYYY"}}
{{fromNow "2 hours ago"}}
{{dateAdd "next week" 3 "days"}}
```

### File System Helpers
URL: https://fumanchu.org/docs/helpers/fs/
Description: Handlebars provides a set of built-in helpers for working with the file system. These helpers are used to read and manipulate files, making it easier to work with file data in templates.


> **Availability:** Registered in the Node build only. Not available in the browser build.

## fs

### {{fileSize}}

Formats a number of bytes into a human-readable file size string with appropriate units.

**Params**

* `value` **{Number|Object}**: The number of bytes, or an object with a `length` property
* `precision` **{Number}**: Optional decimal precision (default: 2)
* `returns` **{String}**: Formatted file size string

**Supported Units**

B, kB, MB, GB, TB, PB, EB, ZB, YB

**Example**

```handlebars
{{fileSize 1024}}
<!-- results in: '1 kB' -->

{{fileSize 1536}}
<!-- results in: '1.5 kB' -->

{{fileSize 1048576}}
<!-- results in: '1 MB' -->

{{fileSize 1073741824}}
<!-- results in: '1 GB' -->

<!-- With custom precision -->
{{fileSize 1536 0}}
<!-- results in: '2 kB' -->

{{fileSize 1536 3}}
<!-- results in: '1.5 kB' -->

<!-- Returns '0 B' for null/undefined -->
{{fileSize null}}
<!-- results in: '0 B' -->
```

### {{read}}

Read a file from the file system. This is useful in composing "include"-style helpers using sub-expressions.

**Params**

* `filepath` **{String}**: The path to the file to read
* `returns` **{String}**: The file contents as a UTF-8 string

**Example**

```handlebars
<!-- Read and output file contents -->
{{read "path/to/file.txt"}}

<!-- Use with other helpers -->
{{markdown (read "README.md")}}

<!-- Include a partial file -->
<script>
{{read "src/scripts/analytics.js"}}
</script>
```

### {{readdir}}

Return an array of files from the given directory. Supports optional filtering by function, RegExp, glob pattern, or type.

**Params**

* `directory` **{String}**: The directory path to read
* `filter` **{Function|RegExp|String}**: Optional filter to apply to the file list
* `returns` **{Array}**: Array of file paths

**Filter Options**

* **Function**: Custom filter function that receives the files array and returns filtered array
* **RegExp**: Regular expression to test against file paths
* **Glob string**: Glob pattern to match files (e.g., `"*.js"`, `"**/*.md"`)
* **"isFile"**: Return only files (not directories)
* **"isDirectory"**: Return only directories (not files)

**Example**

```handlebars
<!-- List all files in a directory -->
{{#each (readdir "src")}}
  {{this}}
{{/each}}

<!-- Filter by glob pattern -->
{{#each (readdir "src" "*.js")}}
  {{this}}
{{/each}}

<!-- Filter to only files -->
{{#each (readdir "src" "isFile")}}
  {{this}}
{{/each}}

<!-- Filter to only directories -->
{{#each (readdir "src" "isDirectory")}}
  {{this}}
{{/each}}

<!-- Use with other helpers -->
{{#each (readdir "posts" "*.md")}}
  <article>
    {{markdown (read this)}}
  </article>
{{/each}}
```

### Html Helpers
URL: https://fumanchu.org/docs/helpers/html/
Description: Helpers for generating and manipulating HTML elements in templates.


> **Availability**
>
> | Helper | Node | Browser |
> | --- | :---: | :---: |
> | `attr` | ✅ | ✅ |
> | `css` | ✅ | — |
> | `js` | ✅ | — |
> | `ol` | ✅ | ✅ |
> | `sanitize` | ✅ | ✅ |
> | `thumbnailImage` | ✅ | ✅ |
> | `ul` | ✅ | ✅ |

### {{attr}}

Stringify attributes from the options hash into an HTML attribute string.

**Params**

* `options` **{Object}**: Options object with a `hash` property containing key-value pairs
* `returns` **{String}**: Space-prefixed attribute string, or empty string if no attributes

**Example**

```handlebars
<div{{attr class="container" id="main"}}></div>
```

**Output**

```html
<div class="container" id="main"></div>
```

You can also use variables:

```handlebars
<!-- With context: { btnClass: "btn-primary" } -->
<button{{attr class=btnClass type="submit"}}>Click</button>
```

**Output**

```html
<button class="btn-primary" type="submit">Click</button>
```

### {{css}}

Generate `<link>` tags for stylesheets. Supports both CSS and LESS files.

**Params**

* `list` **{String|Array}**: One or more stylesheet paths/URLs
* `returns` **{String}**: One or more `<link>` tags

**Example**

Single stylesheet:

```handlebars
{{css "styles/main.css"}}
```

**Output**

```html
<link type="text/css" rel="stylesheet" href="styles/main.css">
```

Multiple stylesheets:

```handlebars
<!-- With context: { stylesheets: ["reset.css", "theme.css", "app.css"] } -->
{{css stylesheets}}
```

**Output**

```html
<link type="text/css" rel="stylesheet" href="reset.css">
<link type="text/css" rel="stylesheet" href="theme.css">
<link type="text/css" rel="stylesheet" href="app.css">
```

LESS files are automatically detected:

```handlebars
{{css "styles/theme.less"}}
```

**Output**

```html
<link type="text/css" rel="stylesheet/less" href="styles/theme.less">
```

### {{js}}

Generate `<script>` tags for JavaScript files.

**Params**

* `context` **{String|Array|Object}**: Script path(s) or options object with `src` attribute
* `returns` **{String}**: One or more `<script>` tags

**Example**

Single script:

```handlebars
{{js "app.js"}}
```

**Output**

```html
<script src="app.js"></script>
```

Multiple scripts:

```handlebars
<!-- With context: { scripts: ["vendor.js", "utils.js", "app.js"] } -->
{{js scripts}}
```

**Output**

```html
<script src="vendor.js"></script>
<script src="utils.js"></script>
<script src="app.js"></script>
```

Using the `src` attribute:

```handlebars
{{js src="bundle.js"}}
```

**Output**

```html
<script src="bundle.js"></script>
```

### {{sanitize}}

Strip all HTML tags from a string, preserving only the text content.

**Params**

* `str` **{String}**: The string containing HTML to sanitize
* `returns` **{String}**: Plain text with all HTML tags removed

**Example**

```handlebars
{{sanitize "<p>Hello <strong>World</strong>!</p>"}}
```

**Output**

```
Hello World!
```

Extracting text from HTML markup:

```handlebars
<!-- With context: { richText: "<div class='note'><em>Important:</em> Check the <a href='/docs'>docs</a></div>" } -->
<p>{{sanitize richText}}</p>
```

**Output**

```html
<p>Important: Check the docs</p>
```

**Note:** This helper removes HTML tags but preserves all text content, including text inside `<script>` or `<style>` tags. It is not a security sanitizer for untrusted input.

### {{ul}}

Block helper for creating unordered lists.

**Params**

* `context` **{Array}**: Array of items to render as list items
* `options` **{Object}**: Options object; supports HTML attributes via hash
* `returns` **{String}**: Complete `<ul>` element with `<li>` children

**Example**

With an array of strings:

```handlebars
<!-- With context: { fruits: ["Apple", "Banana", "Cherry"] } -->
{{#ul fruits}}{{this}}{{/ul}}
```

**Output**

```html
<ul><li>Apple</li>
<li>Banana</li>
<li>Cherry</li></ul>
```

With objects and custom attributes:

```handlebars
<!-- With context: { users: [{name: "Alice"}, {name: "Bob"}] } -->
{{#ul users class="user-list"}}{{name}}{{/ul}}
```

**Output**

```html
<ul class="user-list"><li>Alice</li>
<li>Bob</li></ul>
```

### {{ol}}

Block helper for creating ordered lists.

**Params**

* `context` **{Array}**: Array of items to render as list items
* `options` **{Object}**: Options object; supports HTML attributes via hash
* `returns` **{String}**: Complete `<ol>` element with `<li>` children

**Example**

```handlebars
<!-- With context: { steps: ["Mix ingredients", "Bake at 350°F", "Let cool"] } -->
{{#ol steps class="recipe-steps"}}{{this}}{{/ol}}
```

**Output**

```html
<ol class="recipe-steps"><li>Mix ingredients</li>
<li>Bake at 350°F</li>
<li>Let cool</li></ol>
```

### {{thumbnailImage}}

Generate a `<figure>` element with a thumbnail image, optional link to full-size image, and optional caption.

**Params**

* `context` **{Object}**: Configuration object with the following properties:
  * `id` **{String}**: Unique identifier for the figure element
  * `alt` **{String}**: Alt text for the image
  * `thumbnail` **{String}**: URL of the thumbnail image
  * `size` **{Object}**: Object with `width` and `height` properties
  * `full` **{String}** *(optional)*: URL of the full-size image (creates a link if provided)
  * `caption` **{String}** *(optional)*: Caption text for the image
  * `classes` **{Object}** *(optional)*: CSS classes for `figure`, `image`, and `link` elements
* `returns` **{String}**: Complete `<figure>` element

**Example**

Basic thumbnail with link and caption:

```handlebars
{{thumbnailImage image}}
```

With context:

```json
{
  "image": {
    "id": "hero",
    "alt": "Mountain landscape",
    "thumbnail": "/images/mountain-thumb.jpg",
    "size": { "width": 200, "height": 150 },
    "full": "/images/mountain-full.jpg",
    "caption": "View from the summit"
  }
}
```

**Output**

```html
<figure id="image-hero">
<a href="/images/mountain-full.jpg" rel="thumbnail">
<img alt="Mountain landscape" src="/images/mountain-thumb.jpg" width="200" height="150">
</a>
<figcaption>View from the summit</figcaption>
</figure>
```

With custom CSS classes:

```json
{
  "image": {
    "id": "profile",
    "alt": "User avatar",
    "thumbnail": "/avatars/user.jpg",
    "size": { "width": 100, "height": 100 },
    "full": "/avatars/user-large.jpg",
    "classes": {
      "figure": ["avatar-container", "rounded"],
      "image": ["avatar-img"],
      "link": ["avatar-link"]
    }
  }
}
```

**Output**

```html
<figure id="image-profile" class="avatar-container rounded">
<a href="/avatars/user-large.jpg" rel="thumbnail" class="avatar-link">
<img alt="User avatar" src="/avatars/user.jpg" width="100" height="100" class="avatar-img">
</a>
</figure>
```

### i18n Helpers
URL: https://fumanchu.org/docs/helpers/i18n/
Description: Handlebars helpers for working with internationalization (i18n). These helpers are used to look up and display localized content in templates.


> **Availability:** Registered in both the Node and browser builds.

## i18n

### {{i18n}}

Looks up a translation key for the current language. The helper expects a `language` (or `lang`) property in the context, along with an object containing translations for that language.

**Params**

* `key` **{String}**: The translation key to look up (supports dot notation for nested keys)
* `returns` **{String}**: The translated string

**Example**

Given the following context:

```js
{
  language: 'en',
  en: {
    greeting: 'Hello',
    messages: {
      welcome: 'Welcome to our site'
    }
  },
  es: {
    greeting: 'Hola',
    messages: {
      welcome: 'Bienvenido a nuestro sitio'
    }
  }
}
```

```handlebars
{{i18n "greeting"}}
<!-- Output: Hello -->

{{i18n "messages.welcome"}}
<!-- Output: Welcome to our site -->
```

To switch languages, change the `language` property in the context:

```js
{
  language: 'es',
  // ... translations
}
```

```handlebars
{{i18n "greeting"}}
<!-- Output: Hola -->
```

**Notes**

- The helper throws an error if the `key` parameter is not a string
- The helper throws an error if `language` or `lang` is not set or is not a string
- The helper throws an error if the language object is not found in the context
- The helper throws an error if the translation key is not found

### Inflection Helpers
URL: https://fumanchu.org/docs/helpers/inflection/
Description: Handlebars provides a set of built-in helpers for working with inflection. These helpers are used to format and manipulate words, making it easier to display text in a readable format.


> **Availability:** Registered in both the Node and browser builds.

## inflection

### {{inflect}}

Returns either the `singular` or `plural` inflection of a word based on the given `count`.

**Params**

* `count` **{Number}**
* `singular` **{String}**: The singular form
* `plural` **{String}**: The plural form
* `includeCount` **{Boolean}**
* `returns` **{String}**

**Example**

```html
{{inflect 0 "string" "strings"}}
<!-- "strings" -->
{{inflect 1 "string" "strings"}}
<!-- "string" -->
{{inflect 1 "string" "strings" true}}
<!-- "1 string" -->
{{inflect 2 "string" "strings"}}
<!-- "strings" -->
{{inflect 2 "string" "strings" true}}
<!-- "2 strings" -->
```

### {{ordinalize}}

Returns an ordinalized number as a string.

**Params**

* `value` **{Number|String}**: The value to ordinalize.
* `returns` **{String}**: The ordinalized number

**Example**

```html
{{ordinalize 1}}
<!-- '1st' -->
{{ordinalize 21}}
<!-- '21st' -->
{{ordinalize 29}}
<!-- '29th' -->
{{ordinalize 22}}
<!-- '22nd' -->
```

### Markdown Helpers
URL: https://fumanchu.org/docs/helpers/markdown/
Description: Helpers for converting markdown to HTML

> **Availability:** Registered in both the Node and browser builds. The browser build renders inline markdown only — the Node build also accepts a file path and will read its contents before rendering.

## markdown

### {{markdown}}

Block helper that converts a string of inline markdown to HTML.

**Params**

* `string` **{String}**: Markdown string to convert
* `returns` **{String}**: HTML string

**Example**

```handlebars
{{#markdown}}
# Foo
{{/markdown}}
<!-- results in: <h1>Foo</h1> -->
```

### {{md}}

Converts a markdown string to HTML, or reads a markdown file from the file system and converts its contents to HTML.

**Params**

* `filepath` **{String}**: Markdown string or path to a markdown file
* `returns` **{String}**: HTML string

**Example**

```handlebars
{{md "# Hello World"}}
<!-- results in: <h1>Hello World</h1> -->

{{md "foo/bar.md"}}
<!-- reads file and converts to HTML -->
```

### Match Helpers
URL: https://fumanchu.org/docs/helpers/match/
Description: Handlebars helpers for working with glob patterns and file matching. These helpers use micromatch to filter and test file paths against glob patterns.


> **Availability:** Registered in both the Node and browser builds.

## match

### {{match}}

Returns an array of strings that match the given glob pattern(s).

**Params**

* `files` **{Array|String}**: Array of file paths or a single file path string.
* `patterns` **{Array|String}**: One or more glob patterns. Comma-separated strings are also supported.
* `options` **{Object}**: Options to pass to micromatch.
* `returns` **{Array}**: Array of matches

**Example**

```html
{{match (readdir "foo") "*.js"}}
{{match (readdir "foo") (toRegex "\\.js$")}}
```

### {{isMatch}}

Returns true if a filepath matches the given pattern.

**Params**

* `filepath` **{String}**: The file path to test.
* `pattern` **{String|Array}**: The glob pattern(s) to match against.
* `options` **{Object}**: Options to pass to micromatch.
* `returns` **{Boolean}**

**Example**

```html
{{isMatch "foo.md" "*.md"}}
<!-- results in: true -->
```

### Math Helpers
URL: https://fumanchu.org/docs/helpers/math/
Description: Handlebars provides a set of built-in helpers for working with math. These helpers are used to perform mathematical operations, making it easier to manipulate numbers in templates.


> **Availability:** Registered in both the Node and browser builds.

## math

### {{abs}}

Return the magnitude of `a`.

**Params**

* `a` **{Number}**
* `returns` **{Number}**

### {{add}}

Return the sum of `a` plus `b`.

**Params**

* `a` **{Number}**
* `b` **{Number}**
* `returns` **{Number}**

### {{avg}}

Returns the average of all numbers in the given array.

**Params**

* `array` **{Array}**: Array of numbers to add up.
* `returns` **{Number}**

**Example**

```html
{{avg "[1, 2, 3, 4, 5]"}}
<!-- results in: '3' -->
```

### {{ceil}}

Get the `Math.ceil()` of the given value.

**Params**

* `value` **{Number}**
* `returns` **{Number}**

### {{divide}}

Divide `a` by `b`

**Params**

* `a` **{Number}**: numerator
* `b` **{Number}**: denominator

### {{floor}}

Get the `Math.floor()` of the given value.

**Params**

* `value` **{Number}**
* `returns` **{Number}**

### {{minus}}

Return the difference of `a` minus `b`.

**Params**

* `a` **{Number}**
* `b` **{Number}**

### {{modulo}}

Get the remainder of a division operation.

**Params**

* `a` **{Number}**
* `b` **{Number}**
* `returns` **{Number}**

### {{multiply}}

Return the product of `a` times `b`.

**Params**

* `a` **{Number}**: factor
* `b` **{Number}**: multiplier
* `returns` **{Number}**

### {{plus}}

Add `a` by `b`.

**Params**

* `a` **{Number}**: factor
* `b` **{Number}**: multiplier

### {{random}}

Generate a random number between two values

**Params**

* `min` **{Number}**
* `max` **{Number}**
* `returns` **{String}**

### {{remainder}}

Get the remainder when `a` is divided by `b`.

**Params**

* `a` **{Number}**: a
* `b` **{Number}**: b

### {{round}}

Round the given number.

**Params**

* `number` **{Number}**
* `returns` **{Number}**

### {{subtract}}

Return the product of `a` minus `b`.

**Params**

* `a` **{Number}**
* `b` **{Number}**
* `returns` **{Number}**

### {{sum}}

Returns the sum of all numbers in the given array.

**Params**

* `array` **{Array}**: Array of numbers to add up.
* `returns` **{Number}**

**Example**

```html
{{sum "[1, 2, 3, 4, 5]"}}
<!-- results in: '15' -->
```

### {{times}}

Multiply number `a` by number `b`.

**Params**

* `a` **{Number}**: factor
* `b` **{Number}**: multiplier
* `returns` **{Number}**

### Misc Helpers
URL: https://fumanchu.org/docs/helpers/misc/
Description: Handlebars provides a set of built-in helpers for working with miscellaneous tasks. These helpers are used to perform various operations, making it easier to manipulate data in templates.


> **Availability:** Registered in both the Node and browser builds.

## misc

### {{frame}}

Block helper for exposing private `@` variables on the context. Creates a new data frame and extends it with hash arguments.

**Params**

* `context` **{Object}**: Optional context data to include in the frame
* `options` **{Object}**: Handlebars provided options object
* `returns` **{String}**: Block content with the new frame context

**Example**

```html
{{#frame site="mysite" value=42}}
  {{@site}} - {{@value}}
{{/frame}}
<!-- results in: 'mysite - 42' -->
```

### {{option}}

Return the given value of `prop` from `this.options`.

**Params**

* `prop` **{String}**
* `returns` **{any}**

**Example**

```html
<!-- context = {options: {a: {b: {c: 'ddd'}}}} -->
{{option "a.b.c"}}
<!-- results in: 'ddd' -->
```

### {{noop}}

Block helper that renders the block without taking any arguments.

**Params**

* `options` **{Object}**
* `returns` **{String}**

### {{typeOf}}

Get the native type of the given `value`.

**Params**

* `value` **{any}**
* `returns` **{String}**: Returns the type of value.

**Example**

```html
{{typeOf 1}}
<!-- results in: 'number' -->
{{typeOf "1"}}
<!-- results in: 'string' -->
{{typeOf "foo"}}
<!-- results in: 'string' -->
```

### {{withHash}}

Block helper that builds the context for the block from the options hash.

**Params**

* `options` **{Object}**: Handlebars provided options object.

**Example**

```html
{{#withHash a=1 b="hello"}}
  {{a}} - {{b}}
{{/withHash}}
<!-- results in: '1 - hello' -->
```

### Number Helpers
URL: https://fumanchu.org/docs/helpers/number/
Description: Handlebars provides a set of built-in helpers for working with numbers. These helpers are used to format and manipulate numbers, making it easier to display numerical information in a readable format.


> **Availability:** Registered in both the Node and browser builds.

## number

### {{bytes}}

Format a number to it's equivalent in bytes. If a string is passed, it's length will be formatted and returned.

**Examples:**

* `'foo' => 3 B`
* `13661855 => 13.66 MB`
* `825399 => 825.39 kB`
* `1396 => 1.4 kB`

**Params**

* `number` **{Number|String}**
* `returns` **{String}**

### {{addCommas}}

Add commas to numbers

**Params**

* `num` **{Number}**
* `returns` **{Number}**

### {{phoneNumber}}

Convert a string or number to a formatted phone number.

**Params**

* `num` **{Number|String}**: The phone number to format, e.g. `8005551212`
* `returns` **{Number}**: Formatted phone number: `(800) 555-1212`

### {{toAbbr}}

Abbreviate numbers to the given number of `precision`. This is for
general numbers, not size in bytes.

**Params**

* `number` **{Number}**
* `precision` **{Number}**
* `returns` **{String}**

### {{toExponential}}

Returns a string representing the given number in exponential notation.

**Params**

* `number` **{Number}**
* `fractionDigits` **{Number}**: Optional. An integer specifying the number of digits to use after the decimal point. Defaults to as many digits as necessary to specify the number.
* `returns` **{Number}**

**Example**

```html
{{toExponential number digits}};
```

### {{toFixed}}

Formats the given number using fixed-point notation.

**Params**

* `number` **{Number}**
* `digits` **{Number}**: (Optional) The number of digits to appear after the decimal point; this may be a value between 0 and 20. If this argument is omitted, it is treated as 0.
* `returns` **{String}**: A string representing the given number using fixed-point notation.

**Example**

```html
{{toFixed "1.1234" 2}}
//=> '1.12'
```

### {{toFloat}}

**Params**

* `number` **{Number}**
* `returns` **{Number}**

### {{toInt}}

**Params**

* `number` **{Number}**
* `returns` **{Number}**

### {{toPrecision}}

Returns a string representing the `Number` object to the specified precision.

**Params**

* `number` **{Number}**
* `precision` **{Number}**: (Optional) An integer specifying the number of significant digits. If precison is not between 1 and 100 (inclusive), it will be coerced to `0`.
* `returns` **{String}**: A string representing a Number object in fixed-point or exponential notation rounded to precision significant digits.

**Example**

```html
{{toPrecision "1.1234" 2}}
//=> '1.1'
```

### Object Helpers
URL: https://fumanchu.org/docs/helpers/object/
Description: Handlebars provides a set of built-in helpers for working with objects. These helpers are used to manipulate and format objects, making it easier to work with complex data structures in templates.


> **Availability:** Registered in both the Node and browser builds.

## object

### {{extend}}

Extend the context with the properties of other objects.
A shallow merge is performed to avoid mutating the context.

**Params**

* `objects` **{Object}**: One or more objects to extend.
* `returns` **{Object}**

### {{forIn}}

Block helper that iterates over the properties of
an object, exposing each key and value on the context.

**Params**

* `context` **{Object}**
* `options` **{Object}**
* `returns` **{String}**

### {{forOwn}}

Block helper that iterates over the **own** properties of
an object, exposing each key and value on the context.

**Params**

* `obj` **{Object}**: The object to iterate over.
* `options` **{Object}**
* `returns` **{String}**

### {{toPath}}

Take arguments and, if they are string or number, convert them to a dot-delineated object property path.

**Params**

* `prop` **{String|Number}**: The property segments to assemble (can be multiple).
* `returns` **{String}**

### {{get}}

Use property paths (`a.b.c`) to get a value or nested value from
the context. Works as a regular helper or block helper.

**Params**

* `prop` **{String}**: The property to get, optionally using dot notation for nested properties.
* `context` **{Object}**: The context object
* `options` **{Object}**: The handlebars options object, if used as a block helper.
* `returns` **{String}**

### {{getObject}}

Use property paths (`a.b.c`) to get an object from
the context. Differs from the `get` helper in that this
helper will return the actual object, including the
given property key. Also, this helper does not work as a
block helper.

**Params**

* `prop` **{String}**: The property to get, optionally using dot notation for nested properties.
* `context` **{Object}**: The context object
* `returns` **{String}**

### {{hasOwn}}

Return true if `key` is an own, enumerable property of the given `context` object.

**Params**

* `key` **{String}**
* `context` **{Object}**: The context object.
* `returns` **{Boolean}**

**Example**

```html
{{hasOwn context key}}
```

### {{isObject}}

Return true if `value` is an object.

**Params**

* `value` **{String}**
* `returns` **{Boolean}**

**Example**

```html
{{isObject "foo"}}
//=> false
```

### {{JSONparse}}

Parses the given string using `JSON.parse`.

**Params**

* `string` **{String}**: The string to parse

**Example**

```html
<!-- string: '{"foo": "bar"}' -->
{{JSONparse string}}
<!-- results in: { foo: 'bar' } -->
```

### {{parseJSON}}

Alias for `JSONparse`. Parses the given string using `JSON.parse`.

**Params**

* `string` **{String}**: The string to parse

**Example**

```html
<!-- string: '{"foo": "bar"}' -->
{{parseJSON string}}
<!-- results in: { foo: 'bar' } -->
```

### {{JSONstringify}}

Stringify an object using `JSON.stringify`.

**Params**

* `obj` **{Object}**: Object to stringify
* `indent` **{Number}**: Optional number of spaces for indentation
* `returns` **{String}**

**Example**

```html
<!-- object: { foo: 'bar' } -->
{{JSONstringify object}}
<!-- results in: '{"foo": "bar"}' -->
```

### {{stringify}}

Alias for `JSONstringify`. Stringify an object using `JSON.stringify`.

**Params**

* `obj` **{Object}**: Object to stringify
* `indent` **{Number}**: Optional number of spaces for indentation
* `returns` **{String}**

**Example**

```html
<!-- object: { foo: 'bar' } -->
{{stringify object}}
<!-- results in: '{"foo":"bar"}' -->
```

### {{merge}}

Deeply merge the properties of the given `objects` with the
context object.

**Params**

* `object` **{Object}**: The target object. Pass an empty object to shallow clone.
* `objects` **{Object}**
* `returns` **{Object}**

### {{pick}}

Pick properties from the context object.

**Params**

* `properties` **{Array|String}**: One or more properties to pick.
* `context` **{Object}**
* `options` **{Object}**: Handlebars options object.
* `returns` **{Object}**: Returns an object with the picked values. If used as a block helper, the values are passed as context to the inner block. If no values are found, the context is passed to the inverse block.

### Path Helpers
URL: https://fumanchu.org/docs/helpers/path/
Description: Handlebars provides a set of built-in helpers for working with file paths. These helpers are used to manipulate and format file paths, making it easier to work with files in templates.


> **Availability:** Registered in the Node build only. Not available in the browser build.

## path

### {{absolute}}

Resolve an absolute path from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{absolute "docs/toc.md"}}
<!-- results in: '/User/dev/docs/toc.md' -->
```

### {{dirname}}

Get the directory path segment from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{dirname "docs/toc.md"}}
<!-- results in: 'docs' -->
```

### {{relative}}

Get the relative filepath from `a` to `b`.

**Params**

* `a` **{String}**
* `b` **{String}**
* `returns` **{String}**

**Example**

```html
{{relative a b}}
```

### {{basename}}

Get the filename from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{basename "docs/toc.md"}}
<!-- results in: 'toc.md' -->
```

### {{stem}}

Get the "stem" (filename without extension) from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{stem "docs/toc.md"}}
<!-- results in: 'toc' -->
```

### {{extname}}

Get the file extension from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{extname "docs/toc.md"}}
<!-- results in: '.md' -->
```

### {{resolve}}

Resolve an absolute path from the given `filepath`.

**Params**

* `filepath` **{String}**
* `returns` **{String}**

**Example**

```html
{{resolve "docs/toc.md"}}
<!-- results in: '/User/dev/docs/toc.md' -->
```

### {{segments}}

Get specific (joined) segments of a file path by passing a range of array indices.

**Params**

* `filepath` **{String}**: The file path to split into segments.
* `returns` **{String}**: Returns a single, joined file path.

**Example**

```html
{{segments "a/b/c/d" "2" "3"}}
<!-- results in: 'c/d' -->

{{segments "a/b/c/d" "1" "3"}}
<!-- results in: 'b/c/d' -->

{{segments "a/b/c/d" "1" "2"}}
<!-- results in: 'b/c' -->
```

### Regex Helpers
URL: https://fumanchu.org/docs/helpers/regex/
Description: Handlebars provides a set of built-in helpers for working with regular expressions. These helpers are used to manipulate and format strings using regex patterns, making it easier to work with complex string matching in templates.


> **Availability:** Registered in both the Node and browser builds.

## regex

### {{toRegex}}

Convert the given string to a regular expression.

**Params**

* `str` **{String}**
* `returns` **{RegExp}**

**Example**

```html
{{toRegex "foo"}}
<!-- results in: /foo/ -->
```

### {{test}}

Returns true if the given `str` matches the given regex. A regex can be passed on the context, or using the toRegex helper as a subexpression.

**Params**

* `str` **{String}**
* `returns` **{RegExp}**

**Example**

```html
{{test "bar" (toRegex "foo")}}
<!-- results in: false -->
{{test "foobar" (toRegex "foo")}}
<!-- results in: true -->
{{test "foobar" (toRegex "^foo$")}}
<!-- results in: false -->
```

### String Helpers
URL: https://fumanchu.org/docs/helpers/string/
Description: Handlebars provides a set of built-in helpers for working with strings. These helpers are used to manipulate and format strings, making it easier to work with text in templates.


> **Availability:** Registered in both the Node and browser builds.

## string

Visit the: [code](https://github.com/jaredwray/fumanchu/tree/main/src/helpers/string.ts) | [unit tests](https://github.com/jaredwray/fumanchu/tree/main/test/helpers/string.test.ts)

### {{append}}

Append the specified `suffix` to the given string.

**Params**

* `str` **{String}**
* `suffix` **{String}**
* `returns` **{String}**

**Example**

```html
<!-- given that "item.stem" is "foo" -->
{{append item.stem ".html"}}
<!-- results in:  'foo.html' -->
```

### {{camelcase}}

camelCase the characters in the given `string`.

**Params**

* `string` **{String}**: The string to camelcase.
* `returns` **{String}**

**Example**

```html
{{camelcase "foo bar baz"}};
<!-- results in:  'fooBarBaz' -->
```

### {{capitalize}}

Capitalize the first word in a sentence.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{capitalize "foo bar baz"}}
<!-- results in:  "Foo bar baz" -->
```

### {{capitalizeAll}}

Capitalize all words in a string.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{capitalizeAll "foo bar baz"}}
<!-- results in:  "Foo Bar Baz" -->
```

### {{center}}

Center a string using non-breaking spaces

**Params**

* `str` **{String}**
* `spaces` **{Number}**
* `returns` **{String}**

**Example**

```html
{{center "foo" 2}}
<!-- results in:  '&nbsp;&nbsp;foo&nbsp;&nbsp;' -->
```

### {{chop}}

Like trim, but removes both extraneous whitespace **and non-word characters** from the beginning and end of a string.

**Params**

* `string` **{String}**: The string to chop.
* `returns` **{String}**

**Example**

```html
{{chop "_ABC_"}}
<!-- results in:  'ABC' -->

{{chop "-ABC-"}}
<!-- results in:  'ABC' -->

{{chop " ABC "}}
<!-- results in:  'ABC' -->
```

### {{dashcase}}

dash-case the characters in `string`. Replaces non-word characters and periods with hyphens.

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{dashcase "a-b-c d_e"}}
<!-- results in:  'a-b-c-d-e' -->
```

### {{dotcase}}

dot.case the characters in `string`.

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{dotcase "a-b-c d_e"}}
<!-- results in:  'a.b.c.d.e' -->
```

### {{downcase}}

Lowercase all of the characters in the given string. Alias for [lowercase](#lowercase).

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{downcase "aBcDeF"}}
<!-- results in:  'abcdef' -->
```

### {{ellipsis}}

Truncates a string to the specified `length`, and appends it with an elipsis, `…`.

**Params**

* `str` **{String}**
* `length` **{Number}**: The desired length of the returned string.
* `returns` **{String}**: The truncated string.

**Example**

```html
{{ellipsis (sanitize "<span>foo bar baz</span>"), 7}}
<!-- results in:  'foo bar…' -->
{{ellipsis "foo bar baz", 7}}
<!-- results in:  'foo bar…' -->
```

### {{hyphenate}}

Replace spaces in a string with hyphens.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{hyphenate "foo bar baz qux"}}
<!-- results in:  "foo-bar-baz-qux" -->
```

### {{isString}}

Return true if `value` is a string.

**Params**

* `value` **{Any}**
* `returns` **{Boolean}**

**Example**

```html
{{isString "foo"}}
<!-- results in:  'true' -->
```

### {{lowercase}}

Lowercase all characters in the given string.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{lowercase "Foo BAR baZ"}}
<!-- results in:  'foo bar baz' -->
```

### {{occurrences}}

Return the number of occurrences of `substring` within the given `string`.

**Params**

* `str` **{String}**
* `substring` **{String}**
* `returns` **{Number}**: Number of occurrences

**Example**

```html
{{occurrences "foo bar foo bar baz" "foo"}}
<!-- results in:  2 -->
```

### {{pascalcase}}

PascalCase the characters in `string`.

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{pascalcase "foo bar baz"}}
<!-- results in:  'FooBarBaz' -->
```

### {{pathcase}}

path/case the characters in `string`.

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{pathcase "a-b-c d_e"}}
<!-- results in:  'a/b/c/d/e' -->
```

### {{plusify}}

Replace spaces in the given string with pluses.

**Params**

* `str` **{String}**: The input string
* `ch` **{String}**: Optional character to replace (defaults to space)
* `returns` **{String}**: Input string with spaces replaced by plus signs

**Example**

```html
{{plusify "foo bar baz"}}
<!-- results in:  'foo+bar+baz' -->
```

### {{prepend}}

Prepends the given `string` with the specified `prefix`.

**Params**

* `str` **{String}**
* `prefix` **{String}**
* `returns` **{String}**

**Example**

```html
<!-- given that "val" is "bar" -->
{{prepend val "foo-"}}
<!-- results in:  'foo-bar' -->
```

### {{raw}}

Render a block without processing mustache templates inside the block.

**Params**

* `options` **{Object}**
* `returns` **{String}**

**Example**

```html
{{{{#raw}}}}
{{foo}}
{{{{/raw}}}}
<!-- results in:  '{{foo}}' -->
```

### {{remove}}

Remove all occurrences of `substring` from the given `str`.

**Params**

* `str` **{String}**
* `substring` **{String}**
* `returns` **{String}**

**Example**

```html
{{remove "a b a b a b" "a "}}
<!-- results in:  'b b b' -->
```

### {{removeFirst}}

Remove the first occurrence of `substring` from the given `str`.

**Params**

* `str` **{String}**
* `substring` **{String}**
* `returns` **{String}**

**Example**

```html
{{removeFirst "a b a b a b" "a"}}
<!-- results in:  ' b a b a b' -->
```

### {{replace}}

Replace all occurrences of substring `a` with substring `b`.

**Params**

* `str` **{String}**
* `a` **{String}**
* `b` **{String}**
* `returns` **{String}**

**Example**

```html
{{replace "a b a b a b" "a" "z"}}
<!-- results in:  'z b z b z b' -->
```

### {{replaceFirst}}

Replace the first occurrence of substring `a` with substring `b`.

**Params**

* `str` **{String}**
* `a` **{String}**
* `b` **{String}**
* `returns` **{String}**

**Example**

```html
{{replaceFirst "a b a b a b" "a" "z"}}
<!-- results in:  'z b a b a b' -->
```

### {{reverse}}

Reverse a string.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{reverse "abcde"}}
<!-- results in:  'edcba' -->
```

### {{sentence}}

Sentence case the given string

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{sentence "hello world. goodbye world."}}
<!-- results in:  'Hello world. Goodbye world.' -->
```

### {{snakecase}}

snake_case the characters in the given `string`.

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{snakecase "a-b-c d_e"}}
<!-- results in:  'a_b_c_d_e' -->
```

### {{split}}

Split `string` by the given `character`.

**Params**

* `string` **{String}**: The string to split.
* `character` **{String}**: The character to split by. Default is an empty string.
* `returns` **{Array}**: Array of split strings.

**Example**

```html
{{split "a,b,c" ","}}
<!-- results in:  ['a', 'b', 'c'] -->
```

### {{startsWith}}

Tests whether a string begins with the given prefix.

**Params**

* `prefix` **{String}**: The prefix to test for
* `testString` **{String}**: The string to test
* `returns` **{Boolean}**: True if testString starts with prefix, false otherwise

**Example**

```html
{{startsWith "Hello" "Hello, world!"}}
<!-- results in:  true -->

{{startsWith "Goodbye" "Hello, world!"}}
<!-- results in:  false -->
```

### {{titleize}}

Title case the given string.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{titleize "this is title case"}}
<!-- results in:  'This Is Title Case' -->
```

### {{trim}}

Removes extraneous whitespace from the beginning and end of a string.

**Params**

* `string` **{String}**: The string to trim.
* `returns` **{String}**

**Example**

```html
{{trim " ABC "}}
<!-- results in:  'ABC' -->
```

### {{trimLeft}}

Removes extraneous whitespace from the beginning of a string.

**Params**

* `string` **{String}**: The string to trim.
* `returns` **{String}**

**Example**

```html
{{trimLeft " ABC "}}
<!-- results in:  'ABC ' -->
```

### {{trimRight}}

Removes extraneous whitespace from the end of a string.

**Params**

* `string` **{String}**: The string to trim.
* `returns` **{String}**

**Example**

```html
{{trimRight " ABC "}}
<!-- results in:  ' ABC' -->
```

### {{truncate}}

Truncate a string to the specified `length`. Also see [ellipsis](#ellipsis).

**Params**

* `str` **{String}**
* `limit` **{Number}**: The desired length of the returned string.
* `suffix` **{String}**: Optionally supply a string to use as a suffix to denote when the string has been truncated.
* `returns` **{String}**: The truncated string.

**Example**

```html
{{truncate "foo bar baz" 7}}
<!-- results in:  'foo bar' -->
{{truncate "foo bar baz" 7 "..."}}
<!-- results in:  'foo ...' -->
```

### {{truncateWords}}

Truncate a string to have the specified number of words. Also see [truncate](#truncate).

**Params**

* `str` **{String}**
* `limit` **{Number}**: The number of words to keep.
* `suffix` **{String}**: Optionally supply a string to use as a suffix. Default is '...'.
* `returns` **{String}**: The truncated string.

**Example**

```html
{{truncateWords "foo bar baz" 1}}
<!-- results in:  'foo...' -->
{{truncateWords "foo bar baz" 2}}
<!-- results in:  'foo bar...' -->
{{truncateWords "foo bar baz" 3}}
<!-- results in:  'foo bar baz...' -->
```

### {{upcase}}

Uppercase all of the characters in the given string. Alias for [uppercase](#uppercase).

**Params**

* `string` **{String}**
* `returns` **{String}**

**Example**

```html
{{upcase "aBcDeF"}}
<!-- results in:  'ABCDEF' -->
```

### {{uppercase}}

Uppercase all of the characters in the given string. If used as a block helper it will uppercase the entire block. This helper does not support inverse blocks.

**Params**

* `str` **{String}**: The string to uppercase
* `options` **{Object}**: Handlebars options object
* `returns` **{String}**

**Example**

```html
{{uppercase "aBcDeF"}}
<!-- results in:  'ABCDEF' -->
```

### Url Helpers
URL: https://fumanchu.org/docs/helpers/url/
Description: Handlebars provides a set of built-in helpers for working with URLs. These helpers are used to manipulate and format URLs, making it easier to work with web links in templates.


> **Availability**
>
> | Helper | Node | Browser |
> | --- | :---: | :---: |
> | `decodeURI` | ✅ | ✅ |
> | `encodeURI` | ✅ | ✅ |
> | `escape` | ✅ | — |
> | `stripProtocol` | ✅ | — |
> | `stripQuerystring` | ✅ | ✅ |
> | `urlParse` | ✅ | — |
> | `urlResolve` | ✅ | — |
> | `url_decode` | ✅ | ✅ |
> | `url_encode` | ✅ | ✅ |

## url

### {{encodeURI}}

Encodes a Uniform Resource Identifier (URI) component by replacing each instance of certain characters by one, two, three, or four escape sequences representing the UTF-8 encoding of the character.

**Params**

* `str` **{String}**: The un-encoded string
* `returns` **{String}**: The encoded string

**Example**

```html
{{encodeURI "http://example.com?comment=Thyme &time=again"}}
<!-- results in: 'http%3A%2F%2Fexample.com%3Fcomment%3DThyme%20%26time%3Dagain' -->
```

### {{escape}}

Escape the given string by replacing characters with escape sequences. Useful for allowing the string to be used in a URL, etc.

**Params**

* `str` **{String}**
* `returns` **{String}**: Escaped string.

**Example**

```html
{{escape "http://example.com?comment=Thyme &time=again"}}
<!-- results in: 'http%3A%2F%2Fexample.com%3Fcomment%3DThyme%20%26time%3Dagain' -->
```

### {{decodeURI}}

Decode a Uniform Resource Identifier (URI) component.

**Params**

* `str` **{String}**
* `returns` **{String}**

**Example**

```html
{{decodeURI "http%3A%2F%2Fexample.com%3Fcomment%3DThyme%20%26time%3Dagain"}}
<!-- results in: 'http://example.com?comment=Thyme &time=again' -->
```

### {{url_encode}}

Alias for [encodeURI](#encodeuri).

### {{url_decode}}

Alias for [decodeURI](#decodeuri).

### {{urlResolve}}

Take a base URL, and a href URL, and resolve them as a browser would for an anchor tag.

**Params**

* `base` **{String}**
* `href` **{String}**
* `returns` **{String}**

**Example**

```html
{{urlResolve "/one/two/three" "four"}}
<!-- results in: '/one/two/four' -->

{{urlResolve "http://example.com/" "/one"}}
<!-- results in: 'http://example.com/one' -->
```

### {{urlParse}}

Parses a `url` string into an object.

**Params**

* `str` **{String}**: URL string
* `returns` **{Object}**: Returns parsed URL object

**Example**

```html
{{urlParse "http://foo.com/bar/baz?key=value"}}
<!-- results in an object with: protocol: 'http:', hostname: 'foo.com', pathname: '/bar/baz', query: 'key=value' -->
```

### {{stripQuerystring}}

Strip the query string from the given `url`.

**Params**

* `url` **{String}**
* `returns` **{String}**: the url without the queryString

**Example**

```html
{{stripQuerystring "http://example.com?tests=true"}}
<!-- results in: 'http://example.com' -->
```

### {{stripProtocol}}

Strip protocol from a `url`. Useful for displaying media that may have an 'http' protocol on secure connections.

**Params**

* `str` **{String}**
* `returns` **{String}**: the url with http protocol stripped

**Example**

```html
{{stripProtocol "http://foo.bar"}}
<!-- results in: '//foo.bar/' -->
```

### Utils Helpers
URL: https://fumanchu.org/docs/helpers/utils/
Description: Handlebars provides a set of built-in helpers for working with utility functions. These helpers are used to manipulate and format data, making it easier to work with complex data structures in templates.


## Utils

The following utils are exposed on `.utils`.

Visit the: [code](https://github.com/jaredwray/fumanchu/tree/main/helpers/lib/utils/index.js)

### [{{changecase}}](lib/utils/index.js#L54)

Change casing on the given `string`, optionally passing a delimiter to use between words in the returned string.

**Params**

* `string` **{String}**: The string to change.
* `returns` **{String}**

**Example**

```html
utils.changecase('fooBarBaz');
//=> 'foo bar baz'

utils.changecase('fooBarBaz' '-');
//=> 'foo-bar-baz'
```

### [{{random}}](lib/utils/index.js#L80)

Generate a random number

**Params**

* `min` **{Number}**
* `max` **{Number}**
* `returns` **{Number}**

### Migrating to v3
URL: https://fumanchu.org/docs/migration/v2-to-v3/
Description: This document describes the breaking changes from v2 to v3 of the jaredwray/fumanchu library.

# Breaking Changes from v2 to v3

Because of the complexity in the legacy helpers library we have moved to exporting the libraries and a helper function to make it easier to use. Here are the exports:

- `handlebars` - This is an instance of handlebars library without any helpers. It is the same as calling `Handlebars.create()`
- `helpers` - This is a function that takes an object with a `handlebars` key and adds all the helpers to the handlebars instance. This is the same as calling `helpers({ handlebars: handlebars }, { ..options })`
- `createHandlebars` - This is an async function that returns a handlebars instance with all the helpers added. This is the same as calling `helpers({ handlebars: handlebars }, { ..options })` but async.
- `Handlebars` - This is the handlebars library itself. It is the same as calling `require('handlebars')`

Please see the examples below for how to use the library.

### Migrating to v4
URL: https://fumanchu.org/docs/migration/v3-to-v4/
Description: This document describes the breaking changes from v3 to v4 of the jaredwray/fumanchu library.

# Breaking Changes from v3 to v4

We are now fully migrated 🎉 and all helpers are in typescript and working correctly

- We no longer support the legacy helpers that were in this project as we have migrated to a new helper system.
- `createHandlebars` is now deprecated in favor of just using `fumanchu()` and no more needing async.
- The `FumanchuOptions` has been changed on filtering and also now fully supported with `fumanchu()`
- Caching is now enabled by default! 🚀

### Contributing
URL: https://fumanchu.org/docs/project-guidelines/contributing/
Description: How to contribute to Fumanchu.

# Contributing
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.

Please note we have a [Code of Conduct](./code-of-conduct.md), please follow it in all your interactions with the project.

We release new versions of this project (maintenance/features) on a monthly cadence so please be aware that some items will not get released right away.

# Pull Request Process
You can contribute changes to this repo by opening a pull request:

1) After forking this repository to your Git account, make the proposed changes on your forked branch.
2) Run tests and linting locally by doing `pnpm i && pnpm test:all`.
3) Commit your changes and push them to your forked repository.
4) Navigate to the main `Fumanchu` repository and select the *Pull Requests* tab.
5) Click the *New pull request* button, then select the option "Compare across forks"
6) Leave the base branch set to main. Set the compare branch to your forked branch, and open the pull request.
7) Once your pull request is created, ensure that all checks have passed and that your branch has no conflicts with the base branch. If there are any issues, resolve these changes in your local repository, and then commit and push them to git.
8) Similarly, respond to any reviewer comments or requests for changes by making edits to your local repository and pushing them to Git.
9) Once the pull request has been reviewed, those with write access to the branch will be able to merge your changes into the `Fumanchu` repository.

If you need more information on the steps to create a pull request, you can find a detailed walkthrough in the [Github documentation](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork)

# Code of Conduct
Please refer to our [Code of Conduct](./code-of-conduct.md) readme for how to contribute to this open source project and work within the community.

### Security Policy
URL: https://fumanchu.org/docs/project-guidelines/security/
Description: How to report security vulnerabilities in Fumanchu.

# Security Policy

We take security seriously and work to keep this project up to date. If you discover a security vulnerability, please report it **privately** so we can investigate and ship a fix before the issue becomes public.

## Reporting a vulnerability

Please use one of the following private channels — **do not open a public issue, pull request, or discussion** for security concerns:

1. **Preferred:** open a private report via GitHub's [Privately reporting a security vulnerability](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities/privately-reporting-a-security-vulnerability) flow on this repository's **Security** tab.
2. **Email:** send the details to me@jaredwray.com. If the issue is urgent, include `[SECURITY]` in the subject line and we will respond as soon as possible.

When reporting, please include as much of the following as you can:

- A description of the vulnerability and its impact.
- Steps to reproduce, or a proof-of-concept.
- The affected version(s) and platform.
- Any suggested remediation, if you have one.

We will acknowledge receipt, work with you on a coordinated disclosure timeline, and credit you in the advisory once a fix is published unless you ask to remain anonymous.

## How this repository is secured

This repository follows the [defense-in-depth](https://github.com/jaredwray/agentic/blob/main/skills/security/defense-in-depth-nodejs/SKILL.md) hardening checklist; progress is tracked in [DEFENSE_IN_DEPTH.md](./DEFENSE_IN_DEPTH.md). Measures currently in place:

- All changes land through pull requests — direct pushes to `main` are blocked, and merging requires passing status checks.
- Tags can only be created by repository admins; published GitHub Releases are immutable (assets and tags cannot be changed after publish).
- Workflow runs from outside collaborators always require maintainer approval, and only allowlisted GitHub Actions can run.
- CI runs with read-only permissions (only jobs whose purpose is mutating the repo get `contents: write`); generated output is an artifact, never committed back; every action is pinned to a full commit SHA; Socket Firewall (`sfw`) wraps `pnpm install` / `npm install`; workflows are security-linted with zizmor on every PR.
- Codespaces and Cursor Cloud Agents install through Aikido Safe Chain; package-manager shims must not be bypassed.
- Dependencies install through pnpm with a 7-day cooldown on new versions, lifecycle scripts blocked by default, and `trustPolicy: no-downgrade`. Socket reviews every dependency change; Aikido scans every build.
- npm releases are staged, never published directly: CI publishes via stage-only OIDC trusted publishing, Drydock reviews the exact staged artifact, and a maintainer promotes it with 2FA. There are no npm tokens.

### Code of Conduct
URL: https://fumanchu.org/docs/project-guidelines/code-of-conduct/
Description: Contributor Covenant Code of Conduct for the Fumanchu community.

# Contributor Covenant Code of Conduct

## Our Pledge

We as members, contributors, and leaders pledge to make participation in our
community a harassment-free experience for everyone, regardless of age, body
size, visible or invisible disability, ethnicity, sex characteristics, gender
identity and expression, level of experience, education, socio-economic status,
nationality, personal appearance, race, religion, or sexual identity
and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming,
diverse, inclusive, and healthy community.

## Our Standards

Examples of behavior that contributes to a positive environment for our
community include:

* Demonstrating empathy and kindness toward other people
* Being respectful of differing opinions, viewpoints, and experiences
* Giving and gracefully accepting constructive feedback
* Accepting responsibility and apologizing to those affected by our mistakes,
  and learning from the experience
* Focusing on what is best not just for us as individuals, but for the
  overall community

Examples of unacceptable behavior include:

* The use of sexualized language or imagery, and sexual attention or
  advances of any kind
* Trolling, insulting or derogatory comments, and personal or political attacks
* Public or private harassment
* Publishing others' private information, such as a physical or email
  address, without their explicit permission
* Other conduct which could reasonably be considered inappropriate in a
  professional setting

## Enforcement Responsibilities

Community leaders are responsible for clarifying and enforcing our standards of
acceptable behavior and will take appropriate and fair corrective action in
response to any behavior that they deem inappropriate, threatening, offensive,
or harmful.

Community leaders have the right and responsibility to remove, edit, or reject
comments, commits, code, wiki edits, issues, and other contributions that are
not aligned to this Code of Conduct, and will communicate reasons for moderation
decisions when appropriate.

## Scope

This Code of Conduct applies within all community spaces, and also applies when
an individual is officially representing the community in public spaces.
Examples of representing our community include using an official e-mail address,
posting via an official social media account, or acting as an appointed
representative at an online or offline event.

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
me@jaredwray.com.
All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the
reporter of any incident.

## Enforcement Guidelines

Community leaders will follow these Community Impact Guidelines in determining
the consequences for any action they deem in violation of this Code of Conduct:

### 1. Correction

**Community Impact**: Use of inappropriate language or other behavior deemed
unprofessional or unwelcome in the community.

**Consequence**: A private, written warning from community leaders, providing
clarity around the nature of the violation and an explanation of why the
behavior was inappropriate. A public apology may be requested.

### 2. Warning

**Community Impact**: A violation through a single incident or series
of actions.

**Consequence**: A warning with consequences for continued behavior. No
interaction with the people involved, including unsolicited interaction with
those enforcing the Code of Conduct, for a specified period of time. This
includes avoiding interactions in community spaces as well as external channels
like social media. Violating these terms may lead to a temporary or
permanent ban.

### 3. Temporary Ban

**Community Impact**: A serious violation of community standards, including
sustained inappropriate behavior.

**Consequence**: A temporary ban from any sort of interaction or public
communication with the community for a specified period of time. No public or
private interaction with the people involved, including unsolicited interaction
with those enforcing the Code of Conduct, is allowed during this period.
Violating these terms may lead to a permanent ban.

### 4. Permanent Ban

**Community Impact**: Demonstrating a pattern of violation of community
standards, including sustained inappropriate behavior,  harassment of an
individual, or aggression toward or disparagement of classes of individuals.

**Consequence**: A permanent ban from any sort of public interaction within
the community.

## Attribution

This Code of Conduct is adapted from the [Contributor Covenant][homepage],
version 2.0, available at
https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.

Community Impact Guidelines were inspired by [Mozilla's code of conduct
enforcement ladder](https://github.com/mozilla/diversity).

[homepage]: https://www.contributor-covenant.org

For answers to common questions about this code of conduct, see the FAQ at
https://www.contributor-covenant.org/faq. Translations are available at
https://www.contributor-covenant.org/translations.

### License and Copyright
URL: https://fumanchu.org/docs/project-guidelines/license-and-copyright/
Description: Fumanchu MIT license and copyright notice.

MIT License

Copyright (c) Jared Wray

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.

## API Reference
URL: https://fumanchu.org/api
- Not available.

## Changelog
URL: https://fumanchu.org/changelog

### v4.7.3
URL: https://fumanchu.org/changelog/v4-7-3
Date: August 23, 2026
Tag: Release

## @jaredwray/fumanchu@4.7.3 — 2026-08-23

Maintenance release: supply-chain hardening plus runtime and toolchain dependency refreshes.

### Documentation
- add SECURITY.md and DEFENSE_IN_DEPTH.md (7681007, #245)

### Internal
- add CODEOWNERS for high-risk paths (555b373, #246)
- bootstrap Aikido Safe Chain for cloud agents (4acbc72, #247)
- set pnpm 7-day dependency cooldown (d5f7d6f, #248)
- set pnpm trustPolicy to no-downgrade (b39e01a, #249)
- block pnpm lifecycle scripts by default (896dac5, #250)
- block exotic pnpm subdependencies (e39403b, #251)
- install with frozen lockfile in CI (875fbb1, #252)
- set least-privilege GitHub Actions permissions (330b2bf, #253)
- pin all GitHub Actions via actions-up (e9e7747, #254)
- wrap CI installs with Socket Firewall (99e001a, #255)
- lint GitHub Actions workflows with zizmor (6e07586, #256)
- disable persist-credentials on checkouts (b12a76d, #257)
- disable setup-node cache on publish workflows (db0c2fc, #258)
- stage npm releases instead of publishing live (11fbef9, #259)
- gate staged npm publish on Aikido scan-release (7f1fd6a, #260)
- record repository lockdown settings (217ce01, #261)
- check off lockdown recording after PR #261 (2bb9b1c, #262)
- record stage-only npm trusted publishing (fa2bc45, #263)
- upgrade code quality dependencies: `@biomejs/biome` 2.5.5 → 2.5.8, `@faker-js/faker` 10.5.0 → 10.6.0, `happy-dom` 20.11.1 → 20.11.2 (2af0e32, #264)
- upgrade TypeScript and build tooling: `tsx` 4.23.1 → 4.23.12, `tsdown` 0.22.13 → 0.22.14 (e48e66c, #265)
- upgrade `pnpm` 11.15.1 → 11.22.0 (9f77323, #266)
- upgrade `tinybench` 6.0.2 → 6.1.3 (f6ec449, #267)
- upgrade `dayjs` 1.11.21 → 1.11.22 (9faacfe, #268)
- upgrade `markdown-it` 14.3.0 → 15.0.0 and drop `@types/markdown-it` in favor of bundled types (123c5cc, #269)

### Contributors
- @jaredwray (25)

### Full List of Changes
- fumanchu - chore: defense - add SECURITY.md and DEFENSE_IN_DEPTH.md by @jaredwray in #245
- fumanchu - chore: defense - add CODEOWNERS for high-risk paths by @jaredwray in #246
- fumanchu - chore: defense - bootstrap Aikido Safe Chain for cloud agents by @jaredwray in #247
- fumanchu - chore: defense - set pnpm 7-day dependency cooldown by @jaredwray in #248
- fumanchu - chore: defense - set pnpm trustPolicy to no-downgrade by @jaredwray in #249
- fumanchu - chore: defense - block pnpm lifecycle scripts by default by @jaredwray in #250
- fumanchu - chore: defense - block exotic pnpm subdependencies by @jaredwray in #251
- fumanchu - chore: defense - install with frozen lockfile in CI by @jaredwray in #252
- fumanchu - chore: defense - set least-privilege GitHub Actions permissions by @jaredwray in #253
- fumanchu - chore: defense - pin all GitHub Actions via actions-up by @jaredwray in #254
- fumanchu - chore: defense - wrap CI installs with Socket Firewall by @jaredwray in #255
- fumanchu - chore: defense - lint GitHub Actions workflows with zizmor by @jaredwray in #256
- fumanchu - chore: defense - disable persist-credentials on checkouts by @jaredwray in #257
- fumanchu - chore: defense - disable setup-node cache on publish workflows by @jaredwray in #258
- fumanchu - chore: defense - stage npm releases instead of publishing live by @jaredwray in #259
- fumanchu - chore: defense - gate staged npm publish on Aikido scan-release by @jaredwray in #260
- fumanchu - chore: defense - record repository lockdown settings by @jaredwray in #261
- fumanchu - chore: defense - check off lockdown recording after PR #261 by @jaredwray in #262
- chore: defense - record stage-only npm trusted publishing by @jaredwray in #263
- root - chore: upgrade code quality dependencies by @jaredwray in #264
- root - chore: upgrade TypeScript and build tooling by @jaredwray in #265
- root - chore: upgrade pnpm by @jaredwray in #266
- root - chore: upgrade tinybench by @jaredwray in #267
- root - chore: upgrade dayjs by @jaredwray in #268
- root - chore: upgrade markdown-it (breaking) by @jaredwray in #269

**Full diff:** [https://github.com/jaredwray/fumanchu/compare/v4.7.2...v4.7.3](https://github.com/jaredwray/fumanchu/compare/v4.7.2...v4.7.3)

### v4.7.2
URL: https://fumanchu.org/changelog/v4-7-2
Date: July 24, 2026
Tag: Release

## @jaredwray/fumanchu@4.7.2 — 2026-07-24

Maintenance release: refreshes runtime dependencies and the dev/CI toolchain.

### Bug Fixes
- Allow wrangler build scripts and set the Cloudflare account ID in the site deploy workflow (69ef29e, #234)

### Documentation
- Add an external-link icon to the GitHub header nav link (31b0774, #235)

### Internal
- Upgrade runtime dependencies: `markdown-it` 14.2.0 → 14.3.0 (221f88b, #241), `@cacheable/memory` 2.0.9 → 2.2.0 (1ff0704, #242), `chrono-node` 2.9.1 → 2.10.1 (4df6b63, #243).
- Upgrade dev/build tooling: code-quality dependencies (c4847a0, #236), TypeScript and build tooling (5ba8654, #237), `docula` 2.1.0 → 2.2.0 (3425f44, #238).
- Upgrade `pnpm` 11.9.0 → 11.15.1 via `packageManager` (f1eb7e9, #239).
- Upgrade `actions/setup-node` v6 → v7 (66d33fa, #240). CI-only; no consumer impact.

### Contributors
- @jaredwray (10)

### Full List of Changes
- fix(deploy-site): allow wrangler build scripts and set Cloudflare account ID by @jaredwray in #234
- docs: add external-link icon to GitHub header nav link by @jaredwray in #235
- root - chore: upgrade code quality dependencies by @jaredwray in #236
- root - chore: upgrade TypeScript and build tooling by @jaredwray in #237
- root - chore: upgrade docula by @jaredwray in #238
- root - chore: upgrade pnpm by @jaredwray in #239
- root - chore: upgrade GitHub Actions (breaking) by @jaredwray in #240
- root - chore: upgrade markdown-it by @jaredwray in #241
- root - chore: upgrade @cacheable/memory by @jaredwray in #242
- root - chore: upgrade chrono-node by @jaredwray in #243

**Full diff:** [https://github.com/jaredwray/fumanchu/compare/v4.7.1...v4.7.2](https://github.com/jaredwray/fumanchu/compare/v4.7.1...v4.7.2)

### v4.7.1
URL: https://fumanchu.org/changelog/v4-7-1
Date: June 23, 2026
Tag: Release

## @jaredwray/fumanchu@4.7.1 — 2026-06-23

Maintenance and security release: hardens the `md` helper against XSS, clears a markdown-it DoS advisory, and refreshes runtime and tooling dependencies.

### Security
- The `md`/`markdown` helper no longer HTML-entity-decodes its rendered output — markdown-it's escaping is now preserved (8c3c0f3, #230). The previous `decodeHTML(md.render(...))` step enabled attribute-breakout XSS (e.g. an alt-text payload injecting a live `onerror` handler) and corrupted URLs whose query params began with a legacy entity name (e.g. `&region`). The `ent` dependency was removed with no replacement.
  - **Behavior change:** entities in markdown output are now preserved rather than decoded.

    ```handlebars
    {{md "&amp;"}}
    {{!-- v4.7.0: <p>&</p>  →  v4.7.1: <p>&amp;</p> --}}
    ```
- Upgrade `markdown-it` 14.1.1 → 14.2.0 (12c0c49, #226), resolving a moderate quadratic-complexity DoS advisory in the smartquotes rule (a shipped runtime dependency).

### Internal
- Upgrade runtime dependencies: `@cacheable/memory` 2.0.8 → 2.0.9 (285e799, #227), `chrono-node` 2.9.0 → 2.9.1 (8507644, #228), `dayjs` 1.11.20 → 1.11.21 (30d1874, #229).
- Upgrade dev/build tooling: code-quality deps + migrate to pnpm 11 (416e012, #222), TypeScript and build tooling (d39c0bb, #223), `docula` 1.13.0 → 2.1.0 (965c78a, #225).
- Upgrade GitHub Actions to their latest major versions (5e5b1fe, #224).
- Publish to npm via OIDC trusted publishing with provenance, dropping the long-lived `NPM_TOKEN` (6bd13c2, #232).

### Documentation
- Add a GitHub repository link to the website top navigation (3ddbe20, #231).

### Contributors
- @jaredwray (11)

### Full List of Changes
- root - chore: upgrade code quality deps and migrate to pnpm 11 by @jaredwray in #222
- root - chore: upgrade TypeScript and build tooling by @jaredwray in #223
- root - chore: upgrade GitHub Actions (breaking) by @jaredwray in #224
- root - chore: upgrade docula to 2.x (breaking) by @jaredwray in #225
- root - chore: upgrade markdown-it by @jaredwray in #226
- root - chore: upgrade @cacheable/memory by @jaredwray in #227
- root - chore: upgrade chrono-node by @jaredwray in #228
- root - chore: upgrade dayjs by @jaredwray in #229
- feat: Replace ent with entities for HTML decoding by @jaredwray in #230
- Add GitHub repo link to website top navigation by @jaredwray in #231
- ci: publish to npm via OIDC trusted publishing with provenance by @jaredwray in #232

**Full diff:** [https://github.com/jaredwray/fumanchu/compare/v4.7.0...v4.7.1](https://github.com/jaredwray/fumanchu/compare/v4.7.0...v4.7.1)

### v4.7.0
URL: https://fumanchu.org/changelog/v4-7-0
Date: April 19, 2026
Tag: Release

## What's Changed
* fix: Remove html-tag dependency and implement inline tag helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/215](https://github.com/jaredwray/fumanchu/pull/215)
* fix: Replace is-glob dependency with inline implementation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/216](https://github.com/jaredwray/fumanchu/pull/216)
* fix: Inline kind-of dependency to remove external package by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/217](https://github.com/jaredwray/fumanchu/pull/217)
* fix: replace striptags dependency with inline implementation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/218](https://github.com/jaredwray/fumanchu/pull/218)
* fix: Replace to-gfm-code-block dependency with native implementation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/219](https://github.com/jaredwray/fumanchu/pull/219)
* fix: Replace remarkable with markdown-it by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/220](https://github.com/jaredwray/fumanchu/pull/220)
* feat: adding browser support by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/221](https://github.com/jaredwray/fumanchu/pull/221)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.6.1...v4.7.0](https://github.com/jaredwray/fumanchu/compare/v4.6.1...v4.7.0)

### v4.6.1
URL: https://fumanchu.org/changelog/v4-6-1
Date: April 4, 2026
Tag: Release

## What's Changed
* fix: npm publish error by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/207](https://github.com/jaredwray/fumanchu/pull/207)
* chore: upgrading biome, vitest, rimraf, and types by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/208](https://github.com/jaredwray/fumanchu/pull/208)
* chore: upgrading @cacheable/memory by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/209](https://github.com/jaredwray/fumanchu/pull/209)
* chore: upgrading dayjs by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/210](https://github.com/jaredwray/fumanchu/pull/210)
* chore: upgrading handlebars by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/211](https://github.com/jaredwray/fumanchu/pull/211)
* chore: upgrading typescript and migrating to tsdown by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/212](https://github.com/jaredwray/fumanchu/pull/212)
* feat: updating docs by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/213](https://github.com/jaredwray/fumanchu/pull/213)
* feat: adding caching benchmark by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/214](https://github.com/jaredwray/fumanchu/pull/214)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.6.0...v4.6.1](https://github.com/jaredwray/fumanchu/compare/v4.6.0...v4.6.1)

### v4.6.0
URL: https://fumanchu.org/changelog/v4-6-0
Date: February 23, 2026
Tag: Release

## What's Changed
* feat: moving to nodejs 24 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/205](https://github.com/jaredwray/fumanchu/pull/205)
* feat: adding in caching by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/206](https://github.com/jaredwray/fumanchu/pull/206)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.5.1...v4.6.0](https://github.com/jaredwray/fumanchu/compare/v4.5.1...v4.6.0)

### v4.5.1
URL: https://fumanchu.org/changelog/v4-5-1
Date: January 15, 2026
Tag: Release

## What's Changed
* docs: clean up HTML helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/189](https://github.com/jaredwray/fumanchu/pull/189)
* docs: improve i18n helpers documentation with comprehensive examples by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/190](https://github.com/jaredwray/fumanchu/pull/190)
* docs: clean up inflection helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/191](https://github.com/jaredwray/fumanchu/pull/191)
* docs: add logging helpers documentation and tests by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/192](https://github.com/jaredwray/fumanchu/pull/192)
* docs: clean up match helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/193](https://github.com/jaredwray/fumanchu/pull/193)
* docs: clean up math helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/194](https://github.com/jaredwray/fumanchu/pull/194)
* docs: clean up markdown helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/195](https://github.com/jaredwray/fumanchu/pull/195)
* docs: clean up misc helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/196](https://github.com/jaredwray/fumanchu/pull/196)
* docs: clean up number helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/197](https://github.com/jaredwray/fumanchu/pull/197)
* docs: clean up object helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/198](https://github.com/jaredwray/fumanchu/pull/198)
* docs: clean up path helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/199](https://github.com/jaredwray/fumanchu/pull/199)
* docs: clean up regex helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/200](https://github.com/jaredwray/fumanchu/pull/200)
* docs: clean up url helpers documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/201](https://github.com/jaredwray/fumanchu/pull/201)
* feat: adding in AGENTS.md by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/203](https://github.com/jaredwray/fumanchu/pull/203)
* chore: upgrading vitest to 4.0.17 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/204](https://github.com/jaredwray/fumanchu/pull/204)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.5.0...v4.5.1](https://github.com/jaredwray/fumanchu/compare/v4.5.0...v4.5.1)

### v4.5.0
URL: https://fumanchu.org/changelog/v4-5-0
Date: December 4, 2025
Tag: Release

## What's Changed
* feat: adding array helpers that were missing by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/177](https://github.com/jaredwray/fumanchu/pull/177)
* feat: updating array documents by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/178](https://github.com/jaredwray/fumanchu/pull/178)
* feat: adding in additional date helpers that were missing by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/179](https://github.com/jaredwray/fumanchu/pull/179)
* feat: adding missing helpers for string by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/180](https://github.com/jaredwray/fumanchu/pull/180)
* chore: upgrading tsup to 8.5.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/181](https://github.com/jaredwray/fumanchu/pull/181)
* chore: upgrading dayjs to 1.11.19 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/182](https://github.com/jaredwray/fumanchu/pull/182)
* chore: upgrading vitest to 4.0.15 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/183](https://github.com/jaredwray/fumanchu/pull/183)
* chore: removing handlebars-utils as not longer being used by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/184](https://github.com/jaredwray/fumanchu/pull/184)
* feat: updating code.md file to be correct by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/185](https://github.com/jaredwray/fumanchu/pull/185)
* chore: updating comparison readme by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/186](https://github.com/jaredwray/fumanchu/pull/186)
* chore: updating collection to work by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/187](https://github.com/jaredwray/fumanchu/pull/187)
* chore: updating the fs documentation by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/188](https://github.com/jaredwray/fumanchu/pull/188)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.4.0...v4.5.0](https://github.com/jaredwray/fumanchu/compare/v4.4.0...v4.5.0)

### v4.4.0
URL: https://fumanchu.org/changelog/v4-4-0
Date: October 25, 2025
Tag: Release

## What's Changed
* feat: removing the minify as it causes issues with debug by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/168](https://github.com/jaredwray/fumanchu/pull/168)
* chore: upgrading typescript to 5.9.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/169](https://github.com/jaredwray/fumanchu/pull/169)
* chore: upgrading docula to 0.31.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/170](https://github.com/jaredwray/fumanchu/pull/170)
* chore: upgrading chrono-node to 2.9.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/171](https://github.com/jaredwray/fumanchu/pull/171)
* chore: upgrading vitest to 4.0.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/172](https://github.com/jaredwray/fumanchu/pull/172)
* fix: type errors on string helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/173](https://github.com/jaredwray/fumanchu/pull/173)
* feat: removing handlebars-helper-create-frame for native by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/174](https://github.com/jaredwray/fumanchu/pull/174)
* feat: removing logging-helpers for native code by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/175](https://github.com/jaredwray/fumanchu/pull/175)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.3.0...v4.4.0](https://github.com/jaredwray/fumanchu/compare/v4.3.0...v4.4.0)

### v4.3.0
URL: https://fumanchu.org/changelog/v4-3-0
Date: September 19, 2025
Tag: Release

## What's Changed
* feat: adding helpers for lower case on moment by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/167](https://github.com/jaredwray/fumanchu/pull/167)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.2.0...v4.3.0](https://github.com/jaredwray/fumanchu/compare/v4.2.0...v4.3.0)

### v4.2.0
URL: https://fumanchu.org/changelog/v4-2-0
Date: September 19, 2025
Tag: Release

## What's Changed
* feat: adding in markdown with block support by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/166](https://github.com/jaredwray/fumanchu/pull/166)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.1.0...v4.2.0](https://github.com/jaredwray/fumanchu/compare/v4.1.0...v4.2.0)

### v4.1.0
URL: https://fumanchu.org/changelog/v4-1-0
Date: September 19, 2025
Tag: Release

## What's Changed
* feat: adding in forEach as it was missing by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/165](https://github.com/jaredwray/fumanchu/pull/165)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.0.3...v4.1.0](https://github.com/jaredwray/fumanchu/compare/v4.0.3...v4.1.0)

### v4.0.3
URL: https://fumanchu.org/changelog/v4-0-3
Date: September 18, 2025
Tag: Release

## What's Changed
* feat: removing get-value module as no longer needed by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/161](https://github.com/jaredwray/fumanchu/pull/161)
* feat: removed get-object module as no longer needed by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/162](https://github.com/jaredwray/fumanchu/pull/162)
* fix: ensure new Handlebars instances include existing partials by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/163](https://github.com/jaredwray/fumanchu/pull/163)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.0.2...v4.0.3](https://github.com/jaredwray/fumanchu/compare/v4.0.2...v4.0.3)

### v4.0.2
URL: https://fumanchu.org/changelog/v4-0-2
Date: September 15, 2025
Tag: Release

## What's Changed
* fix: adding in lint and lint:ci with error on warnings by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/157](https://github.com/jaredwray/fumanchu/pull/157)
* chore: upgrading dayjs to 1.11.18 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/158](https://github.com/jaredwray/fumanchu/pull/158)
* feat: updating documentation for site by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/159](https://github.com/jaredwray/fumanchu/pull/159)
* chore: upgrading @biomejs/biome to 2.2.4 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/160](https://github.com/jaredwray/fumanchu/pull/160)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.0.1...v4.0.2](https://github.com/jaredwray/fumanchu/compare/v4.0.1...v4.0.2)

### v4.0.1
URL: https://fumanchu.org/changelog/v4-0-1
Date: August 22, 2025
Tag: Release

## What's Changed
* fix: default import for handlebars by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/156](https://github.com/jaredwray/fumanchu/pull/156)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v4.0.0...v4.0.1](https://github.com/jaredwray/fumanchu/compare/v4.0.0...v4.0.1)

### v4.0.0
URL: https://fumanchu.org/changelog/v4-0-0
Date: August 10, 2025
Tag: Release

## What's Changed
* feat: Add array helper module and edge-case tests by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/125](https://github.com/jaredwray/fumanchu/pull/125)
* feat: add code helpers in TypeScript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/126](https://github.com/jaredwray/fumanchu/pull/126)
* feat: add collection helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/127](https://github.com/jaredwray/fumanchu/pull/127)
* feat: add comparison helpers in TS by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/129](https://github.com/jaredwray/fumanchu/pull/129)
* feat: add fs helper functions by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/130](https://github.com/jaredwray/fumanchu/pull/130)
* feat: migrate html helper to typescript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/131](https://github.com/jaredwray/fumanchu/pull/131)
* feat: add i18n helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/132](https://github.com/jaredwray/fumanchu/pull/132)
* feat: add inflection helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/133](https://github.com/jaredwray/fumanchu/pull/133)
* feat: add logging helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/134](https://github.com/jaredwray/fumanchu/pull/134)
* feat: migrate match helper to TypeScript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/135](https://github.com/jaredwray/fumanchu/pull/135)
* feat: add typescript math helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/136](https://github.com/jaredwray/fumanchu/pull/136)
* feat: Add TypeScript misc helpers and register in helper registry by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/137](https://github.com/jaredwray/fumanchu/pull/137)
* feat: add number helpers in TypeScript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/138](https://github.com/jaredwray/fumanchu/pull/138)
* feat: add object helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/139](https://github.com/jaredwray/fumanchu/pull/139)
* feat: add path helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/140](https://github.com/jaredwray/fumanchu/pull/140)
* feat: add regex helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/141](https://github.com/jaredwray/fumanchu/pull/141)
* feat: add string helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/142](https://github.com/jaredwray/fumanchu/pull/142)
* feat: Add TypeScript URL helper with full test coverage by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/143](https://github.com/jaredwray/fumanchu/pull/143)
* feat: adding in compatibility as an array by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/144](https://github.com/jaredwray/fumanchu/pull/144)
* feat: mark helper compatibility by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/145](https://github.com/jaredwray/fumanchu/pull/145)
* feat: (breaking) moving to only using the new helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/146](https://github.com/jaredwray/fumanchu/pull/146)
* feat: upading documentation on migration by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/147](https://github.com/jaredwray/fumanchu/pull/147)
* feat: add markdown helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/148](https://github.com/jaredwray/fumanchu/pull/148)
* fix: updating contributing guidelines by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/149](https://github.com/jaredwray/fumanchu/pull/149)
* feat: (breaking) removing legacy helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/150](https://github.com/jaredwray/fumanchu/pull/150)
* feat: (breaking) moving to swap and load functions by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/151](https://github.com/jaredwray/fumanchu/pull/151)
* feat: (breaking) adding in arrays for filtering on names and categories by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/152](https://github.com/jaredwray/fumanchu/pull/152)
* chore: remove unused dependencies by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/154](https://github.com/jaredwray/fumanchu/pull/154)
* feat: adding in filtering on load from helper registry by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/153](https://github.com/jaredwray/fumanchu/pull/153)
* chore: upgrading get-value to 4.0.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/155](https://github.com/jaredwray/fumanchu/pull/155)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.1.3...v4.0.0](https://github.com/jaredwray/fumanchu/compare/v3.1.3...v4.0.0)

### v3.1.3
URL: https://fumanchu.org/changelog/v3-1-3
Date: August 6, 2025
Tag: Release

## What's Changed
* feat: migrating markdown to typescript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/119](https://github.com/jaredwray/fumanchu/pull/119)
* chore: upgrading typescript to 5.9.2 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/120](https://github.com/jaredwray/fumanchu/pull/120)
* chore: upgrading docula to 0.13.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/121](https://github.com/jaredwray/fumanchu/pull/121)
* chore: upgrading cacheable to 1.10.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/122](https://github.com/jaredwray/fumanchu/pull/122)
* feat: adding in biome for lint and formatting by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/123](https://github.com/jaredwray/fumanchu/pull/123)
* chore: upgrading chrono-node to 2.8.4 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/124](https://github.com/jaredwray/fumanchu/pull/124)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.1.2...v3.1.3](https://github.com/jaredwray/fumanchu/compare/v3.1.2...v3.1.3)

### v3.1.2
URL: https://fumanchu.org/changelog/v3-1-2
Date: June 27, 2025
Tag: Release

## What's Changed
* chore: upgrading xo to 1.1.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/114](https://github.com/jaredwray/fumanchu/pull/114)
* chore: upgrading vitest to 3.2.4 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/115](https://github.com/jaredwray/fumanchu/pull/115)
* chore: upgrading cacheable to 1.10.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/116](https://github.com/jaredwray/fumanchu/pull/116)
* chore: upgrading docula to 0.13.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/117](https://github.com/jaredwray/fumanchu/pull/117)
* chore: upgrading chrono-node to 2.8.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/118](https://github.com/jaredwray/fumanchu/pull/118)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.1.1...v3.1.2](https://github.com/jaredwray/fumanchu/compare/v3.1.1...v3.1.2)

### v3.1.1
URL: https://fumanchu.org/changelog/v3-1-1
Date: May 28, 2025
Tag: Release

## What's Changed
* fix: regressing chrono-node back to 2.7.5 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/113](https://github.com/jaredwray/fumanchu/pull/113)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.1.0...v3.1.1](https://github.com/jaredwray/fumanchu/compare/v3.1.0...v3.1.1)

### v3.1.0
URL: https://fumanchu.org/changelog/v3-1-0
Date: May 18, 2025
Tag: Release

## What's Changed
* fix: updating the readme and createHelpers library to work by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/103](https://github.com/jaredwray/fumanchu/pull/103)
* fix: updating github actions with permissions by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/104](https://github.com/jaredwray/fumanchu/pull/104)
* chore: upgrading vitest to 3.1.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/105](https://github.com/jaredwray/fumanchu/pull/105)
* chore: upgrading tsup to 8.5.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/106](https://github.com/jaredwray/fumanchu/pull/106)
* chore: upgrading cacheable to 1.9.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/107](https://github.com/jaredwray/fumanchu/pull/107)
* chore: upgrading docula to 0.12.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/108](https://github.com/jaredwray/fumanchu/pull/108)
* fix: updating github actions and contributions to use pnpm by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/109](https://github.com/jaredwray/fumanchu/pull/109)
* feat - moving documentation to fumanchu.org by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/110](https://github.com/jaredwray/fumanchu/pull/110)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.0.4...v3.1.0](https://github.com/jaredwray/fumanchu/compare/v3.0.4...v3.1.0)

### v3.0.4
URL: https://fumanchu.org/changelog/v3-0-4
Date: April 7, 2025
Tag: Release

## What's Changed
* chore: upgrading vitest to 3.0.7 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/90](https://github.com/jaredwray/fumanchu/pull/90)
* chore: upgrading tsup to 8.4.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/91](https://github.com/jaredwray/fumanchu/pull/91)
* chore: upgrading docula to 0.10.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/92](https://github.com/jaredwray/fumanchu/pull/92)
* chore: upgrading cacheable to 1.8.8 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/93](https://github.com/jaredwray/fumanchu/pull/93)
* chore: upgrading chrono-node to 2.7.8 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/94](https://github.com/jaredwray/fumanchu/pull/94)
* feat: updating security policy by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/95](https://github.com/jaredwray/fumanchu/pull/95)
* feat: moving to docs section by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/96](https://github.com/jaredwray/fumanchu/pull/96)
* chore: upgrading vitest to 3.1.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/97](https://github.com/jaredwray/fumanchu/pull/97)
* chore: upgrading typescript to 5.8.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/98](https://github.com/jaredwray/fumanchu/pull/98)
* chore: upgrading cacheable to 1.8.10 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/99](https://github.com/jaredwray/fumanchu/pull/99)
* chore: upgrading docula to 0.11.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/100](https://github.com/jaredwray/fumanchu/pull/100)
* chore: upgrading chrono-node to 2.8.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/101](https://github.com/jaredwray/fumanchu/pull/101)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.0.3...v3.0.4](https://github.com/jaredwray/fumanchu/compare/v3.0.3...v3.0.4)

### v3.0.3
URL: https://fumanchu.org/changelog/v3-0-3
Date: January 16, 2025
Tag: Release

## What's Changed
* adding in year helper tests by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/82](https://github.com/jaredwray/fumanchu/pull/82)
* adding in date parsing for the date helper by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/83](https://github.com/jaredwray/fumanchu/pull/83)
* chore: upgrading vitest to 3.0.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/84](https://github.com/jaredwray/fumanchu/pull/84)
* chore: upgrading typescript to 5.7.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/85](https://github.com/jaredwray/fumanchu/pull/85)
* chore: upgrading cacheable to 1.8.7 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/86](https://github.com/jaredwray/fumanchu/pull/86)
* chore: updating docula to 0.9.6 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/87](https://github.com/jaredwray/fumanchu/pull/87)
* chore: upgrading ent to 2.2.2 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/88](https://github.com/jaredwray/fumanchu/pull/88)
* chore: upgrading highlight.js to 11.11.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/89](https://github.com/jaredwray/fumanchu/pull/89)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.0.2...v3.0.3](https://github.com/jaredwray/fumanchu/compare/v3.0.2...v3.0.3)

### v3.0.2
URL: https://fumanchu.org/changelog/v3-0-2
Date: December 7, 2024
Tag: Release

## What's Changed
* adding in tests to make sure it has or doesnt have helpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/75](https://github.com/jaredwray/fumanchu/pull/75)
* adding in exports of HelperRegistry and HelperFilter by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/76](https://github.com/jaredwray/fumanchu/pull/76)
* upgrading xo to 0.60.0 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/77](https://github.com/jaredwray/fumanchu/pull/77)
* upgrading typescript to 5.7.2 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/78](https://github.com/jaredwray/fumanchu/pull/78)
* upgrading vitest to 2.1.8 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/79](https://github.com/jaredwray/fumanchu/pull/79)
* upgrading cacheable to 1.8.5 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/80](https://github.com/jaredwray/fumanchu/pull/80)
* upgrading docula to 0.9.5 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/81](https://github.com/jaredwray/fumanchu/pull/81)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.0.1...v3.0.2](https://github.com/jaredwray/fumanchu/compare/v3.0.1...v3.0.2)

### v3.0.1
URL: https://fumanchu.org/changelog/v3-0-1
Date: November 10, 2024
Tag: Release

## What's Changed
* moving to helpers folder structure for legacy and src for typescript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/65](https://github.com/jaredwray/fumanchu/pull/65)
* Adding in helper registry by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/66](https://github.com/jaredwray/fumanchu/pull/66)
* making it so we are using the logo.svg on readme by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/67](https://github.com/jaredwray/fumanchu/pull/67)
* removing console.log in production code by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/68](https://github.com/jaredwray/fumanchu/pull/68)
* migrating legacy helper tests to helpers directory by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/69](https://github.com/jaredwray/fumanchu/pull/69)
* Adding in xo for typescript by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/70](https://github.com/jaredwray/fumanchu/pull/70)
* upgrading mocha to 10.8.2 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/71](https://github.com/jaredwray/fumanchu/pull/71)
* adding in vitest by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/72](https://github.com/jaredwray/fumanchu/pull/72)
* adding in FumanchuOptions by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/73](https://github.com/jaredwray/fumanchu/pull/73)
* upgrading cacheable to 1.8.4 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/74](https://github.com/jaredwray/fumanchu/pull/74)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v3.0.0...v3.0.1](https://github.com/jaredwray/fumanchu/compare/v3.0.0...v3.0.1)

### v3.0.0
URL: https://fumanchu.org/changelog/v3-0-0
Date: October 28, 2024
Tag: Release

# Major Breaking change and you can read about it here: 

[https://github.com/jaredwray/fumanchu](https://github.com/jaredwray/fumanchu)?tab=readme-ov-file#breaking-changes-from-v2-to-v3

## What's Changed
* upgrading micromatch to 4.0.8 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/62](https://github.com/jaredwray/fumanchu/pull/62)
* upgrading typescript to 5.6.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/63](https://github.com/jaredwray/fumanchu/pull/63)
* moving to async createHandlebars function to do dynamic import by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/64](https://github.com/jaredwray/fumanchu/pull/64)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v2.1.0...v3.0.0](https://github.com/jaredwray/fumanchu/compare/v2.1.0...v3.0.0)

### v2.1.0
URL: https://fumanchu.org/changelog/v2-1-0
Date: October 6, 2024
Tag: Release

## What's Changed
* migrating back to commonjs as the project is not ready for ESM by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/61](https://github.com/jaredwray/fumanchu/pull/61)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v2.0.0...v2.1.0](https://github.com/jaredwray/fumanchu/compare/v2.0.0...v2.1.0)

### v2.0.0
URL: https://fumanchu.org/changelog/v2-0-0
Date: August 19, 2024
Tag: Release

## What's Changed
* upgrading typescript to 5.5.4 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/57](https://github.com/jaredwray/fumanchu/pull/57)
* upgrading mocha to 10.7.3 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/58](https://github.com/jaredwray/fumanchu/pull/58)
* moving to nodejs 20 and 22. removing support for 18 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/59](https://github.com/jaredwray/fumanchu/pull/59)
* upgrading rimraf to 6.0.1 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/60](https://github.com/jaredwray/fumanchu/pull/60)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v1.5.0...v2.0.0](https://github.com/jaredwray/fumanchu/compare/v1.5.0...v2.0.0)

### v1.5.0
URL: https://fumanchu.org/changelog/v1-5-0
Date: July 5, 2024
Tag: Release

## What's Changed
* Deprecate Falsey by @jeremybalog in [https://github.com/jaredwray/fumanchu/pull/55](https://github.com/jaredwray/fumanchu/pull/55)
* adding in unit tests and version bump by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/56](https://github.com/jaredwray/fumanchu/pull/56)

## New Contributors
* @jeremybalog made their first contribution in [https://github.com/jaredwray/fumanchu/pull/55](https://github.com/jaredwray/fumanchu/pull/55)

**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v1.4.1...v1.5.0](https://github.com/jaredwray/fumanchu/compare/v1.4.1...v1.5.0)

### v1.4.1
URL: https://fumanchu.org/changelog/v1-4-1
Date: June 21, 2024
Tag: Release

## What's Changed
* updated the index.d.ts to what was in 1.3.0
* upgrading md modules by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/54](https://github.com/jaredwray/fumanchu/pull/54)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v1.4.0...v1.4.1](https://github.com/jaredwray/fumanchu/compare/v1.4.0...v1.4.1)

### v1.4.0
URL: https://fumanchu.org/changelog/v1-4-0
Date: June 20, 2024
Tag: Release

Biggest change was on the type definition.

## What's Changed
* esm support for handlebarhelpers by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/47](https://github.com/jaredwray/fumanchu/pull/47)
* Making helper md native to fumanchu by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/48](https://github.com/jaredwray/fumanchu/pull/48)
* types definition update by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/49](https://github.com/jaredwray/fumanchu/pull/49)
* upgrading c8 to 10.1.2 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/50](https://github.com/jaredwray/fumanchu/pull/50)
* upgrading rimraf to 5.0.7 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/51](https://github.com/jaredwray/fumanchu/pull/51)
* upgrading micromatch to 4.0.7 by @jaredwray in [https://github.com/jaredwray/fumanchu/pull/52](https://github.com/jaredwray/fumanchu/pull/52)


**Full Changelog**: [https://github.com/jaredwray/fumanchu/compare/v1.3.0...v1.4.0](https://github.com/jaredwray/fumanchu/compare/v1.3.0...v1.4.0)