v2.4.0 Release Notes

The Textwire version v2.4.0 is an important release. The first release in 2025. It adds several convenient features and improvements to the language. This release includes Component Path Alias, introduction of new built-in functions, debugging utilities and more. Read the complete release notes to learn more about the changes.

Component Path Alias

Component Path Alias is a small but useful feature that is useful for people who will keep their components in the components directory. The ~ alias can be used to reference components in the components directory.

Consider this example of calling a components/post-card component before the version v2.4.0:

<div class="posts">
    @each(post in posts)
        @component("components/post-card", { post })
    @end
</div>

Now you can repleace the components/ part with ~ alias like so:

<div class="posts">
    @each(post in posts)
        @component("~post-card", { post })
    @end
</div>

The ~ alias will be replaced with components/ behind the scenes.

New trimRight and trimLeft Functions

A couple of people suggested to add trimRight and trimLeft functions and now they are available in the v2.4.0 release. We already had the trim function for trimming both sides of a string, but now you can trim only the left or right side of a string if that's what you need.

The usage is simple:

Example

<span>{{ " Textwire ".trim() }}</span>

Output

<span>Textwire</span>

You can also pass a string of characters to trim from a string:

Example

<span>{{ "_Textwire".trimLeft('_') }}</span>

Output

<span>Textwire</span>

New repeat Function

A new function repeat is added to strings. The function repeats a string a specified number of times. The function takes a single argument, the number of times to repeat the string.

Example

<span>{{ '🤣'.repeat(5) }}</span>

Output

<span>🤣🤣🤣🤣🤣</span>

New append and prepend Functions

Two new functions append and prepend are added to arrays. The append function adds one or more elements to the end of an array and returns a new array. The prepend function adds one or more elements to the beginning of an array and returns a new array.

Example

<span>{{ ["one", "two"].append("three", "four") }}</span>

Output

<span>one, two, three, four</span>

Example

<span>{{ ["one", "two"].prepend("three", "four") }}</span>

Output

<span>three, four, one, two</span>

New @dump Directive

The @dump directive is used for debugging purposes. It will print the value of the passed variables, objects, arrays, etc. to the output. Here is an example of using the @dump directive:

Example

<h1>This is my title</h1>

@dump({
    name: "John",
    age: 25,
    admin: false,
    hobbies: ["reading", "coding"],
})

<p>Some content</p>

The output would look like something like this:

It's an easy and convenient way to debug your templates and see what's going on inside of them.