@rsconcept/domain 1.0.0

package/dist/rslang/api.d.ts

@@ -0,0 +1,53 @@
+import { AstNode } from '../parsing/ast.js';
+import { ArgumentsType } from './semantic/arguments-extractor.js';
+export { generateExpressionFromAst } from './parser/expression-generator.js';
+import '@lezer/common';
+import './semantic/typification.js';
+import '../shared/branded.js';
+
+/**
+ * Module: API for RSLanguage.
+ */
+
+/** Represents alias mapping. */
+type AliasMapping = Record<string, string>;
+/** Extract arguments from AST. */
+declare function extractArguments(ast: AstNode): ArgumentsType[];
+/** Extracts global variable names from a given expression. */
+declare function extractGlobals(expression: string): Set<string>;
+/** Check if expression is simple derivation. */
+declare function isSimpleExpression(text: string): boolean;
+/** Check if expression is set typification. */
+declare function isSetTypification(text: string): boolean;
+/**
+ * Splits a string containing a template definition into its head and body parts.
+ *
+ * A template definition is expected to have the following format: `[head] body`.
+ * If the input string does not contain the opening square bracket '[', the entire
+ * string is treated as the body, and an empty string is assigned to the head.
+ * If the opening bracket is present, the function attempts to find the matching
+ * closing bracket ']' to determine the head and body parts.
+ *
+ * @example
+ * const template = '[header] body content';
+ * const result = splitTemplateDefinition(template);
+ * // result: `{ head: 'header', body: 'body content' }`
+ */
+declare function splitTemplateDefinition(target: string): {
+    head: string;
+    body: string;
+};
+/**
+ * Substitutes values for template arguments in a given expression.
+ *
+ * This function takes an input mathematical expression and a list of argument values.
+ * It replaces template argument placeholders in the expression with their corresponding values
+ * from the provided arguments.
+ */
+declare function substituteTemplateArgs(expression: string, mapping: AliasMapping): string;
+/** Apply alias mapping. */
+declare function applyAliasMapping(target: string, mapping: AliasMapping): string;
+/** Apply alias typification mapping. */
+declare function applyTypificationMapping(target: string, mapping: AliasMapping): string;
+
+export { type AliasMapping, applyAliasMapping, applyTypificationMapping, extractArguments, extractGlobals, isSetTypification, isSimpleExpression, splitTemplateDefinition, substituteTemplateArgs };