subscript 9.0.0 → 9.0.1

package/README.md

@@ -1,15 +1,15 @@
 # sub<em>script</em> <a href="https://github.com/spectjs/subscript/actions/workflows/node.js.yml"><img src="https://github.com/spectjs/subscript/actions/workflows/node.js.yml/badge.svg"/></a> <a href="https://bundlejs.com/?q=subscript"><img alt="npm bundle size" src="https://img.shields.io/bundlejs/size/subscript"/></a> <a href="http://npmjs.org/subscript"><img src="https://img.shields.io/npm/v/subscript"/></a> <a href="http://microjs.com/#subscript"><img src="https://img.shields.io/badge/microjs-subscript-blue?color=darkslateblue"/></a>
 
-> _Subscript_ is fast, tiny & extensible expression evaluator / microlanguage with standard syntax.
+> _Subscript_ is fast, tiny & extensible parser / evaluator / microlanguage with standard syntax.
 
 ####  Used for:
 
-* templates (eg. [sprae](https://github.com/dy/sprae))
-* expressions evaluators, calculators
-* subsets of languages (eg. [justin](#justin))
-* sandboxes, playgrounds, safe eval
+* expressions evaluators, calculators 
+* subsets of languages (eg. [jasm](https://github.com/dy/jasm), [justin](#justin))
+* sandboxes, playgrounds, safe eval (eg. [glsl-transpiler](https://github.com/stackgl/glsl-transpiler))
 * custom DSL (eg. [piezo](https://github.com/dy/piezo)) <!-- uneural -->
 * preprocessors (eg. [prepr](https://github.com/dy/prepr))
+* templates (eg. [sprae](https://github.com/dy/sprae))
 
 _Subscript_ has [3.5kb](https://npmfs.com/package/subscript/7.4.3/subscript.min.js) footprint (compare to [11.4kb](https://npmfs.com/package/jsep/1.2.0/dist/jsep.min.js) _jsep_ + [4.5kb](https://npmfs.com/package/expression-eval/5.0.0/dist/expression-eval.module.js) _expression-eval_), best [performance](#performance) and extensive test coverage.
 
@@ -104,26 +104,22 @@ const fn = compile(['+', ['*', 'min', [,60]], [,'sec']])
 fn({min: 5}) // min*60 + "sec" == "300sec"
 
 // node kinds
-['+', a];       // unary operator `+a`
-['+', a, b];    // binary operator `a + b`
-['+', a, b, c]; // n-ary operator `a + b + c`
-['()', a];      // group operator `(a)`
-['()', a, b];   // access operator `a(b)`
-[, a];          // literal value `'a'`
-a;              // variable (from scope)
-null;           // placeholder
+['+', a];         // unary operator `+a`
+['+', a, b];      // binary operator `a + b`
+['+', a, b, c];   // n-ary operator `a + b + c`
+['()', a];        // group operator `(a)`
+['()', a, b];     // access operator `a(b)`
+[, 'a'];          // literal value `'a'`
+a;                // variable (from scope)
+null|empty;       // placeholder
 
 // eg.
-['()', 'a'] // (a)
-['()', 'a', null] // a()
+['()', 'a']       // (a)
+['()', 'a',,]     // a()
+['()', 'a', 'b']  // a(b)
+['+', 'a']        // +a
+['+','a',,]       // a+
 ```
-<!--
-['()'] // ()
-['()', 'a'] // (a)
-['()', 'a', 'b'] // a(b)
-['+',1] // +1
-['+',1,,] // 1+
--->
 
 ### Stringify
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "subscript",
-  "version": "9.0.0",
+  "version": "9.0.1",
   "description": "Fast and tiny expression evaluator with minimal syntax.",
   "main": "subscript.js",
   "module": "subscript.js",
@@ -21,6 +21,7 @@
     "feature",
     "subscript.js",
     "subscript.min.js",
+    "subscript.d.ts",
     "justin.js",
     "justin.min.js"
   ],

package/subscript.d.ts

@@ -0,0 +1,6 @@
+import type { OperatorFunction } from './src/compile';
+
+export default subscript;
+export * from "./src/parse.js";
+export * from "./src/compile.js";
+declare function subscript(s: string): ((ctx?: any) => any) | OperatorFunction;