@mrhenry/twig-parser 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Mr. Henry
+
+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.
+
+This license applies only to the code in this repository.
+Images are explicitly excluded.

package/package.json

@@ -0,0 +1,13 @@
+{
+	"name": "@mrhenry/twig-parser",
+	"version": "0.1.0",
+	"license": "MIT",
+	"type": "module",
+	"main": "src/index.js",
+	"exports": {
+		".": "./src/index.js"
+	},
+	"dependencies": {
+		"@mrhenry/twig-tokenizer": "0.1.0"
+	}
+}

package/src/array-expression.js

@@ -0,0 +1,69 @@
+// @ts-check
+/**
+ * The array/mapping literal expression node.
+ *
+ * Mirrors `Twig\Node\Expression\ArrayExpression`. Pairs are stored as
+ * `[key, value]` tuples; list elements have an auto-incremented constant key.
+ *
+ * @module twig-parser
+ */
+import { Node, NodeType, n } from './node.js';
+
+/**
+ * An array expression: a sequence or mapping literal.
+ */
+export class ArrayExpression extends Node {
+	/**
+	 * @param {number} line The template line.
+	 */
+	constructor(line) {
+		super(NodeType.ArrayExpr, {}, { pairs: [], index: -1 }, line);
+	}
+
+	/**
+	 * Adds an element.
+	 *
+	 * @param {Node} value The element value.
+	 * @param {Node|null} [key] The element key (auto-incremented when null).
+	 */
+	addElement(value, key = null) {
+		const pairs = /** @type {Array<[Node, Node]>} */ (this.attributes.pairs);
+		let index = /** @type {number} */ (this.attributes.index);
+		if (key === null) {
+			index += 1;
+			key = n(NodeType.Constant, {}, { value: index }, value.getTemplateLine());
+		} else if (
+			key.type === NodeType.Constant &&
+			/^[0-9]+$/.test(String(key.getAttribute('value')))
+		) {
+			const numeric = Number(key.getAttribute('value'));
+			if (numeric > index) {
+				index = numeric;
+			}
+		}
+		this.attributes.index = index;
+		pairs.push([key, value]);
+	}
+
+	/**
+	 * @returns {Array<[Node, Node]>} The `[key, value]` pairs.
+	 */
+	getKeyValuePairs() {
+		return /** @type {Array<[Node, Node]>} */ (this.attributes.pairs);
+	}
+
+	/**
+	 * Whether the array is a list (keys are sequential integers from 0).
+	 *
+	 * @returns {boolean} True when the array is a sequence.
+	 */
+	isSequence() {
+		return this.getKeyValuePairs().every((pair, i) => {
+			const key = pair[0];
+			if (!key || key.type !== NodeType.Constant) {
+				return false;
+			}
+			return key.getAttribute('value') === i;
+		});
+	}
+}

package/src/callables.js

@@ -0,0 +1,127 @@
+// @ts-check
+/**
+ * Metadata for the core Twig filters, functions and tests used at parse time.
+ *
+ * The actual runtime implementations live in `@mrhenry/twig-js`. This module only
+ * carries the names and parse-time flags needed by the parser, mirroring
+ * `CoreExtension::getFilters()`, `getFunctions()` and `getTests()`.
+ *
+ * @module twig-parser
+ */
+
+/**
+ * A callable descriptor returned by the parser environment.
+ *
+ * @typedef {object} TwigCallable
+ * @property {string} name The callable name.
+ * @property {'function'|'filter'|'test'} type The callable kind.
+ * @property {boolean} [parserCallable] Whether the function has a compile-time parser callable (`parent`, `block`, `attribute`).
+ * @property {boolean} [oneMandatoryArgument] Whether a test requires its argument without parentheses (`divisible by`, `same as`).
+ */
+
+/**
+ * Core filter names (the first argument is the piped value).
+ *
+ * @type {string[]}
+ */
+export const CORE_FILTER_NAMES = [
+	'date',
+	'date_modify',
+	'format',
+	'replace',
+	'number_format',
+	'abs',
+	'round',
+	'url_encode',
+	'json_encode',
+	'convert_encoding',
+	'title',
+	'capitalize',
+	'upper',
+	'lower',
+	'striptags',
+	'trim',
+	'nl2br',
+	'spaceless',
+	'join',
+	'split',
+	'sort',
+	'merge',
+	'batch',
+	'column',
+	'filter',
+	'map',
+	'reduce',
+	'find',
+	'keys',
+	'reverse',
+	'shuffle',
+	'length',
+	'slice',
+	'first',
+	'last',
+	'default',
+	'invoke',
+	'escape',
+	'e',
+	'raw',
+];
+
+/**
+ * Core function names.
+ *
+ * @type {string[]}
+ */
+export const CORE_FUNCTION_NAMES = [
+	'parent',
+	'block',
+	'attribute',
+	'max',
+	'min',
+	'range',
+	'constant',
+	'cycle',
+	'random',
+	'date',
+	'include',
+	'include_only',
+	'source',
+	'enum_cases',
+	'enum',
+	'template_from_string',
+];
+
+/**
+ * Names of functions resolved at compile time (parser callables).
+ *
+ * @type {Set<string>}
+ */
+export const PARSER_CALLABLE_FUNCTIONS = new Set(['parent', 'block', 'attribute']);
+
+/**
+ * Core test names.
+ *
+ * @type {string[]}
+ */
+export const CORE_TEST_NAMES = [
+	'even',
+	'odd',
+	'defined',
+	'same as',
+	'none',
+	'null',
+	'divisible by',
+	'constant',
+	'empty',
+	'iterable',
+	'sequence',
+	'mapping',
+	'true',
+];
+
+/**
+ * Tests requiring an argument without parentheses (`x is divisible by(3)`).
+ *
+ * @type {Set<string>}
+ */
+export const ONE_MANDATORY_ARGUMENT_TESTS = new Set(['divisible by', 'same as']);