# quara

> Query as Sara.

Latest version **0.10.13-alpha** (published 2025-11-16) · CC BY-ND 4.0 license · 0 weekly downloads

## Install

```sh
npm install quara
pnpm add quara
yarn add quara
bun add quara
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.10.13-alpha |
| Published | 2025-11-16 |
| First published | 2024-03-16 |
| Weekly downloads | 0 |
| License | CC BY-ND 4.0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >=18.17.1 |
| Dependencies | 0 |
| Unpacked size | 408.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Bernardo Alemán Siverio |
| Maintainers | wandeber |
| Keywords | quara, language, interpreter |

## Links

- npm: https://www.npmjs.com/package/quara
- Repository: https://github.com/wandeber/quara
- Issues: https://github.com/wandeber/quara/issues
- npm.io page: https://npm.io/package/quara

## Recent versions

- 0.10.13-alpha (latest) — 2025-11-16
- 0.10.12 — 2025-11-16
- 0.10.11 — 2024-06-06
- 0.10.10 — 2024-05-02
- 0.10.9 — 2024-04-29
- 0.10.8 — 2024-04-27
- 0.10.7 — 2024-04-24
- 0.10.6 — 2024-04-24
- 0.10.5 — 2024-04-23
- 0.10.4 — 2024-04-02
- 0.10.3 — 2024-03-16

## README

# [Quara](https://www.npmjs.com/package/quara) - [![GitHub license](https://img.shields.io/badge/license-CC_BY--ND_4.0-blue.svg)](https://github.com/wandeber/quara?tab=License-1-ov-file#readme) [![Version](https://img.shields.io/github/package-json/v/wandeber/quara)](https://www.npmjs.com/package/quara) [![size](https://img.shields.io/bundlephobia/min/quara)](https://www.npmjs.com/package/quara)


> Query as Sara

**Don't use this in production**: I may introduce breaking changes until version 1.0.0.

Programming language interpreted by JavaScript to preprocess text files like email templates.

## About
- Supported comments:
  - Line comments: // ...
  - Block comments: /* ... */
- Supported operators:
  - +, -, *, /, %, ^, ¬/
  - =, +=, -=, *=, /=, %=, ^=
  - !, ==, !=, ~=, !~=, <, >, <=, >=, &&, ||
  - not, eq, ne, leq, lne, lt, gt, lte, gte, and, or
  - $not, $eq, $ne, $leq, $lne, $lt, $gt, $lte, $gte, $and, $or
  - (, )
  - ++, -- (as pre-increment and pre-decrement)
  - ., [, ]
  - .. (inclusive range operator)
  - ..< (exclusive range operator)
  - {, }
  - , (Comma)
  - ;, :
  - ->
  - ", `, \
  - in, $in
  - /if, /while, /for, /fn, /struct, /class, /interface, /enum
- Supported types:
  - Booleans.
  - Integer and decimal numbers.
  - Strings.
  - Objects, arrays.
- Variables.
- Reserved keywords:
  - true, false
  - const, var
  - any, char, int, float, double, string, bool
  - if, else
  - while,
  - for,
  - fn, return,
  - null
  - enum
  - struct,
  - class, extends
  - get, set
  - static, abstract, final, virtual
  - private, public, protected
  - interface, implements

### Variables and constants
```js
var a = 14.10;
const b = "Query as Sara";
c = true; // var is optional unless you want to override an outer variable.
```

### Objects

> WIP: The operator ":" could be replaced by "=".

```js
obj = {
  key1: 1,
  key2: 2
};
key = "key3";
print(obj.{key});
obj.{key} = 4;
```

### Arrays
```js
list = [1, 2, 3, 4, 5];
list.length; // 5
print(list[0]);
num = 2;
print(list[num]);
list[4] = 6;
list[num] = 7;
list.{4} = 6;

// TODO: Add support for this?
list.2 = 5;
```

### Control

#### If/else
```js
if condition {
  // ...
}
else if condition {
  // ...
}
else {
  // ...
}

if c {r}
else if c2 {r2}
else {r3}

if c -> r
else if c2 -> r2
else -> r3
```

#### While
```js
while condition {
  // ...
}

while c {r}
while c: r /while;
while c -> r
```

#### For
```rust
for value, index in list {
  // ...
}

for list {...}
for value in list {...}
for value, index in list {...}

for list: ... /for;
for value in list: ... /for;
for value, index in list: ... /for;

for list -> /* One statement */;
for value in list -> /* One statement */;
for value, index in list -> /* One statement */;
```

List could be a range in any of the forms:
```rust
for i in 0..5 {
  // ...
}
```

### Functions

```js
fn sum(a, b) {
  return a + b;
}
```

### Text processor/templates
```js
`Hola` // Hola
```

Assign the output to a variable:
```js
name = "Sara";
text = `Hola, {name}`; // Hola Sara
```

Coding:
```js
name = "Sara";
text = `Hola, {name += " V."; name}`; // Hola Sara V.
```

#### variables:
```js
name = "Sara";
`Hola, {name}` // Hola Sara
```

#### if/else statements:
```js
name = "Sara";
useName = true;
`
  Hola
  {if useName:}
    , {name}
  {else:}
    !
  {/if}
`
```

#### While loops:
```js
i = 0;
`
  {while i < 5:}
    {i}
    {i = i + 1}
  {/while}
`
```

## Standard functions
```js
contains
isNaN

// String:
length
split
join
upperCase
lowerCase
trim
replace
replaceAll

// Math:
abs
ceil
floor
round
trunc
max
min
fixed

// Types:
isNumber
isDecimal
isInteger
isString
isBoolean
isObject
isArray
help
log
print
hi
```

## Pending
- Regular expressions
- `break` and `continue`

### Objects
```js
k = "key1";
obj = {
  {k}: 1,
  {"key2"}: 2
};
```

## References and special thanks

- Thanks to [Ruslan Spivak](https://ruslanspivak.com/) for his [Let's Build A Simple Interpreter](https://ruslanspivak.com/lsbasi-part1/) series.
- [LUA](https://github.com/lua/lua)

## License

Quara © 2024 by [Bernardo Alemán Siverio (wandeber)](https://github.com/wandeber) is licensed under [CC BY-ND 4.0](https://github.com/wandeber/quara?tab=License-1-ov-file#readme)

---
_Source: https://npm.io/package/quara · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._