@shurizma/discord-message-contract 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShuriZma
+
+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.

package/README.md

@@ -0,0 +1,151 @@
+# @shurizma/discord-message-contract
+
+The template engine shared by the [shuri.gg](https://shuri.gg) Discord Message Builder and the bots
+that implement its compatibility contract.
+
+The builder lets you compose a Discord [Components V2](https://discord.com/developers/docs/components/reference)
+message in the browser and hand it to a bot to send. Templates let that message carry placeholders
+(`{{guild.name}}`) that the bot fills in at send time, so a stored message can re-render itself
+against fresh data.
+
+That only works if the website's live preview and the bot's actual send agree on the grammar, down
+to the character. This package is that agreement, extracted so there is exactly one implementation
+instead of one per participant.
+
+## Install
+
+```
+pnpm add @shurizma/discord-message-contract
+```
+
+Zero runtime dependencies. Works in Node and in a browser bundle.
+
+## API
+
+### `renderTemplate(value, data, placeholders)`
+
+Walks any JSON-shaped value and substitutes every template tag found in its strings. Arrays and
+objects recurse; non-strings pass through untouched.
+
+```ts
+import { renderTemplate } from '@shurizma/discord-message-contract';
+
+const placeholders = [
+    { name: 'guild.name', description: 'Server name', kind: 'scalar' },
+    { name: 'roles', description: 'Server roles', kind: 'list', itemAlias: 'role' },
+];
+
+const data = {
+    guild: { name: 'Skadi' },
+    roles: [{ name: 'Admin' }, { name: 'Mod' }],
+};
+
+renderTemplate(
+    { components: [{ type: 10, content: '# {{guild.name}}\n{{#foreach:roles:, }}{{role.name}}{{/foreach}}' }] },
+    data,
+    placeholders,
+);
+// { components: [{ type: 10, content: '# Skadi\nAdmin, Mod' }] }
+```
+
+### `applyConditionalButtons(components, rules, data)`
+
+Removes buttons whose declared condition does not hold, and drops any action row left empty. A
+button matches a rule when its `custom_id` starts with the rule's `customIdPrefix`. Buttons matching
+no rule are always kept.
+
+Link buttons with an empty `url` are always removed, because Discord rejects them outright.
+
+```ts
+import { applyConditionalButtons } from '@shurizma/discord-message-contract';
+
+const rules = [{ customIdPrefix: 'boost:', condition: 'guild.boostCount', negate: true }];
+
+applyConditionalButtons(components, rules, { guild: { boostCount: 0 } });
+// the boost: button survives, because boostCount is falsy and the rule is negated
+```
+
+A bot must apply these rules on **every** render that reaches Discord, not only on scheduled
+refreshes. If it does not, the website's preview and the message people actually see will disagree.
+
+### `resolveNowTimestamps(value)`
+
+Replaces `<t:now>` and `<t:now:R>` with a real Unix timestamp, recursing the same way
+`renderTemplate` does. Call it last, immediately before handing the payload to Discord, and keep the
+literal `<t:now>` in storage so it re-resolves on every future send or edit rather than freezing to
+whenever the message was composed.
+
+Supported format suffixes are Discord's own: `t`, `T`, `d`, `D`, `f`, `F`, `R`. Anything else is
+left alone.
+
+### Order of operations
+
+```ts
+const rendered = renderTemplate(stored.payload, data, definition.placeholders);
+const filtered = { ...rendered, components: applyConditionalButtons(rendered.components, definition.conditionalButtons, data) };
+const payload = resolveNowTimestamps(filtered);
+```
+
+Substitute, then filter, then resolve timestamps. Filtering before substitution would test
+conditions against unrendered placeholder text; resolving timestamps early would freeze them.
+
+## Grammar
+
+| Tag | Meaning |
+| --- | --- |
+| `{{path}}` | Insert a value. Dotted paths walk objects. A missing or null value renders as the empty string. |
+| `{{#if:path}}` | Truthy test. An empty array is falsy; every other value follows JavaScript truthiness. |
+| `{{#if:empty:path}}` | True when the value is `null`, `undefined`, `0` or `""`. |
+| `{{#if:isset:path}}` | True when the value is neither `null` nor `undefined`. `0` and `""` count as set. |
+| `{{#if:eq:path:value}}` | String comparison against a literal. `{{#if:eq:count:0}}` matches the number `0`. |
+| `{{else}}` | Optional alternate branch. |
+| `{{/if}}` | Closes the nearest open `if`. |
+| `{{#foreach:list}}` | Iterate a list placeholder. |
+| `{{#foreach:list:separator}}` | Same, joining iterations with the literal separator. `{{#foreach:roles:, }}` gives `Admin, Mod`. |
+| `{{/foreach}}` | Closes the nearest open `foreach`. |
+
+Inside a `foreach` body, the current item is bound to the list placeholder's `itemAlias`, so a
+placeholder declared as `{ name: 'roles', kind: 'list', itemAlias: 'role' }` exposes `{{role.name}}`.
+The enclosing scope stays visible, so `{{guild.name}}` still resolves inside the loop.
+
+`if` blocks nest. `foreach` blocks do not: a `foreach` inside another `foreach` is emitted as
+literal text rather than iterated. Iterating a list with no registered `itemAlias` throws.
+
+Unrecognised tags pass through as literal text.
+
+### Known malformed-input behaviour
+
+Malformed blocks fail quietly rather than raising:
+
+- An unclosed `{{#if:x}}` renders its body when the condition holds.
+- Text after an unmatched `{{/if}}` is discarded. `a{{/if}}b` renders as `a`.
+
+These are frozen as-is because three live implementations already agreed on them. Treat them as
+behaviour to preserve, not as intent.
+
+## Conforming in another language
+
+`fixtures/grammar.json` is the language-agnostic definition of the grammar. Passing every fixture is
+what conformance means. Each entry is:
+
+```json
+{
+  "name": "foreach-separator",
+  "template": "{{#foreach:roles:, }}{{role.name}}{{/foreach}}",
+  "placeholders": [{ "name": "roles", "description": "roles", "kind": "list", "itemAlias": "role" }],
+  "data": { "roles": [{ "name": "Admin" }, { "name": "Mod" }] },
+  "expected": "Admin, Mod"
+}
+```
+
+`template` is any JSON value, not only a string, since substitution recurses through objects and
+arrays. An entry carrying `throws` instead of `expected` must raise an error containing that text.
+
+The fixtures were generated by running a shared corpus through the two implementations that existed
+before this package (the shuri.gg frontend and the dallas bot) and recording only the cases where
+both agreed, so they describe behaviour that was already in production rather than a fresh
+specification.
+
+## License
+
+MIT

package/dist/conditional-buttons.d.ts

@@ -0,0 +1,3 @@
+import type { ConditionalButtonRule } from './types.js';
+export declare function applyConditionalButtons(components: unknown, rules: ConditionalButtonRule[], data: Record<string, unknown>): unknown;
+//# sourceMappingURL=conditional-buttons.d.ts.map

package/dist/conditional-buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-buttons.d.ts","sourceRoot":"","sources":["../src/conditional-buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA8CxD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAUnI"}

package/dist/conditional-buttons.js

@@ -0,0 +1,55 @@
+const ACTION_ROW = 1;
+const CONTAINER = 17;
+function resolvePath(data, path) {
+    return path.split('.').reduce((value, key) => {
+        if (value === null || value === undefined)
+            return undefined;
+        return value[key];
+    }, data);
+}
+function isTruthy(value) {
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'boolean')
+        return value;
+    return Boolean(value);
+}
+function isEmptyLinkButton(button) {
+    return typeof button.url === 'string' && button.custom_id === undefined && button.url === '';
+}
+function keepButton(button, rules, data) {
+    if (isEmptyLinkButton(button))
+        return false;
+    const customId = typeof button.custom_id === 'string' ? button.custom_id : undefined;
+    const rule = customId !== undefined ? rules.find((r) => customId.startsWith(r.customIdPrefix)) : undefined;
+    if (!rule)
+        return true;
+    const raw = isTruthy(resolvePath(data, rule.condition));
+    return rule.negate ? !raw : raw;
+}
+function filterContainerChildren(children, rules, data) {
+    const result = [];
+    for (const child of children) {
+        const row = child;
+        if (row?.type === ACTION_ROW && Array.isArray(row.components)) {
+            const kept = row.components.filter((b) => keepButton(b, rules, data));
+            if (kept.length > 0)
+                result.push({ ...row, components: kept });
+            continue;
+        }
+        result.push(child);
+    }
+    return result;
+}
+export function applyConditionalButtons(components, rules, data) {
+    if (!Array.isArray(components))
+        return components;
+    return components.map((component) => {
+        const container = component;
+        if (container?.type === CONTAINER && Array.isArray(container.components)) {
+            return { ...container, components: filterContainerChildren(container.components, rules, data) };
+        }
+        return component;
+    });
+}
+//# sourceMappingURL=conditional-buttons.js.map

package/dist/conditional-buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional-buttons.js","sourceRoot":"","sources":["../src/conditional-buttons.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,CAAC,CAAC;AACrB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,SAAS,WAAW,CAAC,IAA6B,EAAE,IAAY;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAU,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC5D,OAAQ,KAAiC,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,MAA+B;IACtD,OAAO,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;AACjG,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B,EAAE,KAA8B,EAAE,IAA6B;IAC9G,IAAI,iBAAiB,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,MAAM,IAAI,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,SAAS,uBAAuB,CAAC,QAAmB,EAAE,KAA8B,EAAE,IAA6B;IAC/G,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,GAAI,GAAG,CAAC,UAAwC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YACrG,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/D,SAAS;QACb,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAmB,EAAE,KAA8B,EAAE,IAA6B;IACtH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAElD,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,SAAkB,EAAE,EAAE;QACzC,MAAM,SAAS,GAAG,SAAoC,CAAC;QACvD,IAAI,SAAS,EAAE,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YACvE,OAAO,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,uBAAuB,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;QACpG,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/grammar.d.ts

@@ -0,0 +1,3 @@
+import type { TemplatePlaceholder } from './types.js';
+export declare function renderTemplate(value: unknown, data: Record<string, unknown>, placeholders: TemplatePlaceholder[]): unknown;
+//# sourceMappingURL=grammar.d.ts.map

package/dist/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAsNtD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,OAAO,CAe1H"}

package/dist/grammar.js

@@ -0,0 +1,219 @@
+const TAG_PATTERN = /\{\{(?:#if:(?:(empty|isset):([\w.]+)|eq:([\w.]+):([^}]*)|([\w.]+))|(else)|(\/if)|#foreach:([\w.]+)(?::([^}]*))?|(\/foreach)|([\w.]+))\}\}/g;
+function tokenize(template) {
+    const tokens = [];
+    let lastIndex = 0;
+    let match;
+    TAG_PATTERN.lastIndex = 0;
+    while ((match = TAG_PATTERN.exec(template)) !== null) {
+        if (match.index > lastIndex) {
+            tokens.push({ kind: 'text', value: template.slice(lastIndex, match.index) });
+        }
+        const [, ifModeRaw, ifPath, eqPath, eqValue, ifPathPlain, elseTag, endifTag, foreachName, foreachSeparator, endforeachTag, scalarPath] = match;
+        if (ifModeRaw !== undefined) {
+            tokens.push({ kind: 'if', mode: ifModeRaw, path: ifPath });
+        }
+        else if (eqPath !== undefined) {
+            tokens.push({ kind: 'if', mode: 'eq', path: eqPath, value: eqValue });
+        }
+        else if (ifPathPlain !== undefined) {
+            tokens.push({ kind: 'if', mode: 'plain', path: ifPathPlain });
+        }
+        else if (elseTag !== undefined) {
+            tokens.push({ kind: 'else' });
+        }
+        else if (endifTag !== undefined) {
+            tokens.push({ kind: 'endif' });
+        }
+        else if (foreachName !== undefined) {
+            tokens.push({ kind: 'foreach', name: foreachName, separator: foreachSeparator });
+        }
+        else if (endforeachTag !== undefined) {
+            tokens.push({ kind: 'endforeach' });
+        }
+        else if (scalarPath !== undefined) {
+            tokens.push({ kind: 'scalar', path: scalarPath });
+        }
+        lastIndex = TAG_PATTERN.lastIndex;
+    }
+    if (lastIndex < template.length) {
+        tokens.push({ kind: 'text', value: template.slice(lastIndex) });
+    }
+    return tokens;
+}
+function tokenToLiteral(token) {
+    switch (token.kind) {
+        case 'text':
+            return token.value;
+        case 'scalar':
+            return `{{${token.path}}}`;
+        case 'if':
+            return token.mode === 'eq'
+                ? `{{#if:eq:${token.path}:${token.value}}}`
+                : `{{#if:${token.mode === 'plain' ? '' : `${token.mode}:`}${token.path}}}`;
+        case 'else':
+            return '{{else}}';
+        case 'endif':
+            return '{{/if}}';
+        case 'foreach':
+            return `{{#foreach:${token.name}${token.separator !== undefined ? `:${token.separator}` : ''}}}`;
+        case 'endforeach':
+            return '{{/foreach}}';
+    }
+}
+function consumeNestedForeachAsLiteral(tokens, pos, openToken) {
+    let buffer = tokenToLiteral(openToken);
+    let depth = 1;
+    while (pos.i < tokens.length && depth > 0) {
+        const token = tokens[pos.i++];
+        buffer += tokenToLiteral(token);
+        if (token.kind === 'foreach')
+            depth++;
+        if (token.kind === 'endforeach')
+            depth--;
+    }
+    return buffer;
+}
+function parseNodes(tokens, pos, insideForeach) {
+    const nodes = [];
+    while (pos.i < tokens.length) {
+        const token = tokens[pos.i];
+        if (token.kind === 'endif' || token.kind === 'else' || token.kind === 'endforeach')
+            break;
+        pos.i++;
+        if (token.kind === 'text') {
+            nodes.push({ type: 'text', value: token.value });
+        }
+        else if (token.kind === 'scalar') {
+            nodes.push({ type: 'scalar', path: token.path });
+        }
+        else if (token.kind === 'if') {
+            const thenNodes = parseNodes(tokens, pos, insideForeach);
+            let elseNodes = [];
+            if (tokens[pos.i]?.kind === 'else') {
+                pos.i++;
+                elseNodes = parseNodes(tokens, pos, insideForeach);
+            }
+            if (tokens[pos.i]?.kind === 'endif')
+                pos.i++;
+            nodes.push({ type: 'if', mode: token.mode, path: token.path, value: token.value, thenNodes, elseNodes });
+        }
+        else if (token.kind === 'foreach') {
+            if (insideForeach) {
+                nodes.push({ type: 'text', value: consumeNestedForeachAsLiteral(tokens, pos, token) });
+                continue;
+            }
+            const body = parseNodes(tokens, pos, true);
+            if (tokens[pos.i]?.kind === 'endforeach')
+                pos.i++;
+            nodes.push({ type: 'foreach', name: token.name, separator: token.separator, body });
+        }
+    }
+    return nodes;
+}
+function parseTemplate(template) {
+    return parseNodes(tokenize(template), { i: 0 }, false);
+}
+class Scope {
+    bindings;
+    parent;
+    constructor(bindings, parent) {
+        this.bindings = bindings;
+        this.parent = parent;
+    }
+    resolve(path) {
+        const [head, ...rest] = path.split('.');
+        let value;
+        if (Object.prototype.hasOwnProperty.call(this.bindings, head)) {
+            value = this.bindings[head];
+        }
+        else if (this.parent) {
+            return this.parent.resolve(path);
+        }
+        else {
+            return undefined;
+        }
+        for (const key of rest) {
+            if (value === null || value === undefined)
+                return undefined;
+            value = value[key];
+        }
+        return value;
+    }
+}
+function isTruthy(value) {
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'boolean')
+        return value;
+    return Boolean(value);
+}
+function isEmpty(value) {
+    return value === null || value === undefined || value === 0 || value === '';
+}
+function isSet(value) {
+    return value !== null && value !== undefined;
+}
+function renderNodes(nodes, scope, itemAliasByListName) {
+    let out = '';
+    for (const node of nodes) {
+        if (node.type === 'text') {
+            out += node.value;
+        }
+        else if (node.type === 'scalar') {
+            const value = scope.resolve(node.path);
+            out += value === null || value === undefined ? '' : String(value);
+        }
+        else if (node.type === 'if') {
+            const value = scope.resolve(node.path);
+            const condition = node.mode === 'empty'
+                ? isEmpty(value)
+                : node.mode === 'isset'
+                    ? isSet(value)
+                    : node.mode === 'eq'
+                        ? String(value) === node.value
+                        : isTruthy(value);
+            out += renderNodes(condition ? node.thenNodes : node.elseNodes, scope, itemAliasByListName);
+        }
+        else if (node.type === 'foreach') {
+            const list = scope.resolve(node.name);
+            if (Array.isArray(list)) {
+                const itemAlias = itemAliasByListName.get(node.name);
+                if (!itemAlias) {
+                    throw new Error(`Template references {{#foreach:${node.name}}} but no list placeholder "${node.name}" with an itemAlias is registered`);
+                }
+                const rendered = list.map((item) => {
+                    const childScope = new Scope({ [itemAlias]: item }, scope);
+                    return renderNodes(node.body, childScope, itemAliasByListName);
+                });
+                out += rendered.join(node.separator ?? '');
+            }
+        }
+    }
+    return out;
+}
+function renderTemplateString(template, data, placeholders) {
+    const itemAliasByListName = new Map();
+    for (const def of placeholders) {
+        if (def.kind === 'list' && def.itemAlias)
+            itemAliasByListName.set(def.name, def.itemAlias);
+    }
+    const nodes = parseTemplate(template);
+    return renderNodes(nodes, new Scope(data), itemAliasByListName);
+}
+export function renderTemplate(value, data, placeholders) {
+    if (typeof value === 'string') {
+        return renderTemplateString(value, data, placeholders);
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => renderTemplate(v, data, placeholders));
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const [key, v] of Object.entries(value)) {
+            result[key] = renderTemplate(v, data, placeholders);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=grammar.js.map

package/dist/grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.js","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { applyConditionalButtons } from './conditional-buttons.js';
+export { renderTemplate } from './grammar.js';
+export { resolveNowTimestamps } from './timestamps.js';
+export type { ConditionalButtonRule, TemplateDefinition, TemplatePlaceholder, TemplatePlaceholderKind, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EACR,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { applyConditionalButtons } from './conditional-buttons.js';
+export { renderTemplate } from './grammar.js';
+export { resolveNowTimestamps } from './timestamps.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/timestamps.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveNowTimestamps(value: unknown): unknown;
+//# sourceMappingURL=timestamps.d.ts.map

package/dist/timestamps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../src/timestamps.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAc5D"}

package/dist/timestamps.js

@@ -0,0 +1,18 @@
+const NOW_TIMESTAMP = /<t:now(?::([tTdDfFR]))?>/g;
+export function resolveNowTimestamps(value) {
+    if (typeof value === 'string') {
+        const nowUnix = Math.floor(Date.now() / 1000);
+        return value.replace(NOW_TIMESTAMP, (_match, format) => (format ? `<t:${nowUnix}:${format}>` : `<t:${nowUnix}>`));
+    }
+    if (Array.isArray(value))
+        return value.map(resolveNowTimestamps);
+    if (value !== null && typeof value === 'object') {
+        const cleaned = {};
+        for (const [key, v] of Object.entries(value)) {
+            cleaned[key] = resolveNowTimestamps(v);
+        }
+        return cleaned;
+    }
+    return value;
+}
+//# sourceMappingURL=timestamps.js.map

package/dist/timestamps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamps.js","sourceRoot":"","sources":["../src/timestamps.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAElD,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,OAAO,GAA4B,EAAE,CAAC;QAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export type TemplatePlaceholderKind = 'scalar' | 'list';
+export interface TemplatePlaceholder {
+    name: string;
+    description: string;
+    kind: TemplatePlaceholderKind;
+    itemAlias?: string;
+    example?: unknown;
+    current?: unknown;
+}
+export interface ConditionalButtonRule {
+    customIdPrefix: string;
+    condition: string;
+    negate?: boolean;
+}
+export interface TemplateDefinition {
+    templateId: string;
+    description: string;
+    needsChannel: boolean;
+    autoRefreshesLive: boolean;
+    supportsGamePreview: boolean;
+    conditionalButtons: ConditionalButtonRule[];
+    placeholders: TemplatePlaceholder[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;IAC5C,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACvC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/fixtures/grammar.json

@@ -0,0 +1,648 @@
+[
+  {
+    "name": "plain-scalar",
+    "template": "Hello {{name}}",
+    "placeholders": [
+      {
+        "name": "name",
+        "description": "name",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "name": "World"
+    },
+    "expected": "Hello World"
+  },
+  {
+    "name": "dotted-path",
+    "template": "{{guild.name}}",
+    "placeholders": [
+      {
+        "name": "guild.name",
+        "description": "guild.name",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "guild": {
+        "name": "Skadi"
+      }
+    },
+    "expected": "Skadi"
+  },
+  {
+    "name": "missing-path",
+    "template": "[{{nope.deep.deeper}}]",
+    "placeholders": [
+      {
+        "name": "nope",
+        "description": "nope",
+        "kind": "scalar"
+      }
+    ],
+    "data": {},
+    "expected": "[]"
+  },
+  {
+    "name": "scalar-null",
+    "template": "[{{v}}]",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": null
+    },
+    "expected": "[]"
+  },
+  {
+    "name": "scalar-zero",
+    "template": "[{{v}}]",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": 0
+    },
+    "expected": "[0]"
+  },
+  {
+    "name": "scalar-false",
+    "template": "[{{v}}]",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": false
+    },
+    "expected": "[false]"
+  },
+  {
+    "name": "scalar-array",
+    "template": "[{{v}}]",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": [
+        1,
+        2
+      ]
+    },
+    "expected": "[1,2]"
+  },
+  {
+    "name": "if-plain-true",
+    "template": "{{#if:v}}yes{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": "x"
+    },
+    "expected": "yes"
+  },
+  {
+    "name": "if-plain-false",
+    "template": "{{#if:v}}yes{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": ""
+    },
+    "expected": ""
+  },
+  {
+    "name": "if-plain-empty-array",
+    "template": "{{#if:v}}yes{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": []
+    },
+    "expected": ""
+  },
+  {
+    "name": "if-plain-nonempty-array",
+    "template": "{{#if:v}}yes{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": [
+        1
+      ]
+    },
+    "expected": "yes"
+  },
+  {
+    "name": "if-empty-true",
+    "template": "{{#if:empty:v}}empty{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": 0
+    },
+    "expected": "empty"
+  },
+  {
+    "name": "if-empty-false",
+    "template": "{{#if:empty:v}}empty{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": "x"
+    },
+    "expected": ""
+  },
+  {
+    "name": "if-empty-undefined",
+    "template": "{{#if:empty:v}}empty{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {},
+    "expected": "empty"
+  },
+  {
+    "name": "if-isset-true",
+    "template": "{{#if:isset:v}}set{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": 0
+    },
+    "expected": "set"
+  },
+  {
+    "name": "if-isset-false",
+    "template": "{{#if:isset:v}}set{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": null
+    },
+    "expected": ""
+  },
+  {
+    "name": "if-eq-true",
+    "template": "{{#if:eq:v:42}}match{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": 42
+    },
+    "expected": "match"
+  },
+  {
+    "name": "if-eq-false",
+    "template": "{{#if:eq:v:42}}match{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": 7
+    },
+    "expected": ""
+  },
+  {
+    "name": "if-eq-empty-value",
+    "template": "{{#if:eq:v:}}blank{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": ""
+    },
+    "expected": "blank"
+  },
+  {
+    "name": "if-else-then",
+    "template": "{{#if:v}}A{{else}}B{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": true
+    },
+    "expected": "A"
+  },
+  {
+    "name": "if-else-otherwise",
+    "template": "{{#if:v}}A{{else}}B{{/if}}",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": false
+    },
+    "expected": "B"
+  },
+  {
+    "name": "if-nested",
+    "template": "{{#if:a}}[{{#if:b}}both{{else}}only-a{{/if}}]{{else}}none{{/if}}",
+    "placeholders": [
+      {
+        "name": "a",
+        "description": "a",
+        "kind": "scalar"
+      },
+      {
+        "name": "b",
+        "description": "b",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "a": true,
+      "b": false
+    },
+    "expected": "[only-a]"
+  },
+  {
+    "name": "foreach-no-separator",
+    "template": "{{#foreach:roles}}{{role.name}}{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ]
+    },
+    "expected": "AdminModMember"
+  },
+  {
+    "name": "foreach-separator",
+    "template": "{{#foreach:roles:, }}{{role.name}}{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ]
+    },
+    "expected": "Admin, Mod, Member"
+  },
+  {
+    "name": "foreach-empty-list",
+    "template": "[{{#foreach:roles:, }}{{role.name}}{{/foreach}}]",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {
+      "roles": []
+    },
+    "expected": "[]"
+  },
+  {
+    "name": "foreach-missing-list",
+    "template": "[{{#foreach:roles}}{{role.name}}{{/foreach}}]",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {},
+    "expected": "[]"
+  },
+  {
+    "name": "foreach-outer-scope-access",
+    "template": "{{#foreach:roles:, }}{{guild.name}}/{{role.name}}{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      },
+      {
+        "name": "guild.name",
+        "description": "guild.name",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ],
+      "guild": {
+        "name": "Skadi"
+      }
+    },
+    "expected": "Skadi/Admin, Skadi/Mod, Skadi/Member"
+  },
+  {
+    "name": "foreach-if-inside",
+    "template": "{{#foreach:roles:, }}{{#if:eq:role.memberCount:5}}!{{/if}}{{role.name}}{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ]
+    },
+    "expected": "Admin, !Mod, Member"
+  },
+  {
+    "name": "foreach-nested-becomes-literal",
+    "template": "{{#foreach:roles}}{{#foreach:roles}}{{role.name}}{{/foreach}}{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "list",
+        "itemAlias": "role"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ]
+    },
+    "expected": "{{#foreach:roles}}{{role.name}}{{/foreach}}{{#foreach:roles}}{{role.name}}{{/foreach}}{{#foreach:roles}}{{role.name}}{{/foreach}}"
+  },
+  {
+    "name": "foreach-without-item-alias-throws",
+    "template": "{{#foreach:roles}}x{{/foreach}}",
+    "placeholders": [
+      {
+        "name": "roles",
+        "description": "roles",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "roles": [
+        {
+          "name": "Admin",
+          "id": "1",
+          "memberCount": 2
+        },
+        {
+          "name": "Mod",
+          "id": "2",
+          "memberCount": 5
+        },
+        {
+          "name": "Member",
+          "id": "3",
+          "memberCount": 40
+        }
+      ]
+    },
+    "throws": "Template references {{#foreach:roles}} but no list placeholder \"roles\" with an itemAlias is registered"
+  },
+  {
+    "name": "unclosed-if",
+    "template": "{{#if:v}}dangling",
+    "placeholders": [
+      {
+        "name": "v",
+        "description": "v",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "v": true
+    },
+    "expected": "dangling"
+  },
+  {
+    "name": "stray-endif",
+    "template": "a{{/if}}b",
+    "placeholders": [],
+    "data": {},
+    "expected": "a"
+  },
+  {
+    "name": "unknown-tag-passthrough",
+    "template": "a{{!weird}}b",
+    "placeholders": [],
+    "data": {},
+    "expected": "a{{!weird}}b"
+  },
+  {
+    "name": "object-recursion",
+    "template": {
+      "a": "Hi {{name}}",
+      "b": [
+        1,
+        "and {{name}}",
+        null
+      ],
+      "c": {
+        "d": "{{name}}"
+      }
+    },
+    "placeholders": [
+      {
+        "name": "name",
+        "description": "name",
+        "kind": "scalar"
+      }
+    ],
+    "data": {
+      "name": "Z"
+    },
+    "expected": {
+      "a": "Hi Z",
+      "b": [
+        1,
+        "and Z",
+        null
+      ],
+      "c": {
+        "d": "Z"
+      }
+    }
+  },
+  {
+    "name": "non-string-passthrough",
+    "template": 42,
+    "placeholders": [],
+    "data": {},
+    "expected": 42
+  },
+  {
+    "name": "null-passthrough",
+    "template": null,
+    "placeholders": [],
+    "data": {},
+    "expected": null
+  }
+]

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@shurizma/discord-message-contract",
+  "version": "0.1.0",
+  "description": "Shared template grammar and types for the shuri.gg Discord message builder bot contract",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./fixtures/grammar.json": "./fixtures/grammar.json"
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.shuri.gg/ShuriZma/discord-message-contract.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "capture": "tsx scripts/capture-fixtures.ts",
+    "prepublishOnly": "pnpm run build && pnpm run test"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  }
+}