fix: added declare free function

Author: arnog

CHANGELOG.md

@@ -73,6 +73,9 @@
   and `Expression`. This means you can pass numbers, MathJSON objects, or tuple
   arrays directly — e.g., `evaluate(["Add", 1, 2])` or
   `simplify(["Power", "x", 2])`.
+- Added `declare()` free function to declare symbols without instantiating a
+  `ComputeEngine` explicitly — e.g., `declare('x', 'integer')` or
+  `declare({ x: 'integer', y: 'real' })`.
 
 ### Units and Quantities
 

src/compute-engine.ts

@@ -38,6 +38,7 @@ export {
   simplify,
   evaluate,
   N,
+  declare,
   assign,
   expand,
   expandAll,

src/compute-engine/free-functions.ts

@@ -2,8 +2,10 @@ import type {
   Expression,
   ExpressionInput,
   AssignValue,
+  SymbolDefinition,
   IComputeEngine,
 } from './global-types';
+import type { Type, TypeString } from '../common/type/types';
 import type { LatexString } from './latex-syntax/types';
 import { isExpression } from './boxed-expression/type-guards';
 import {
@@ -58,6 +60,22 @@ export function N(expr: LatexString | ExpressionInput): Expression {
   return toExpression(expr).N();
 }
 
+export function declare(
+  id: string,
+  def: Type | TypeString | Partial<SymbolDefinition>
+): void;
+export function declare(symbols: {
+  [id: string]: Type | TypeString | Partial<SymbolDefinition>;
+}): void;
+export function declare(
+  arg1:
+    | string
+    | { [id: string]: Type | TypeString | Partial<SymbolDefinition> },
+  arg2?: Type | TypeString | Partial<SymbolDefinition>
+): void {
+  getDefaultEngine().declare(arg1 as any, arg2 as any);
+}
+
 export function assign(id: string, value: AssignValue): void;
 export function assign(ids: { [id: string]: AssignValue }): void;
 export function assign(

src/compute-engine/index.ts

@@ -175,6 +175,7 @@ export {
   simplify,
   evaluate,
   N,
+  declare,
   assign,
   expand,
   expandAll,