@thi.ng/lispy 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-05-21T10:56:03Z
+- **Last updated**: 2025-05-28T12:02:40Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [0.3.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/lispy@0.3.0) (2025-05-28)
+
+#### 🚀 Features
+
+- add/update builtins ([ab7cdec](https://github.com/thi-ng/umbrella/commit/ab7cdec))
+
 ## [0.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/lispy@0.2.0) (2025-05-21)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 207 standalone projects, maintained as part
+> This is one of 208 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -51,7 +51,8 @@ Lightweight, extensible, interpreted Lisp-style DSL for embedding in other proje
 ## Core language features
 
 The core language is intentionally kept minimal, aimed at data transformations,
-and currently only contains the following:
+configuration, user code snippets/expressions, and currently only contains the
+following:
 
 ### Constants
 - `T`: true
@@ -60,6 +61,8 @@ and currently only contains the following:
 - `PI`
 - `HALF_PI`
 - `TAU`
+- `INF`: ∞
+- `-INF`: -∞
 
 ### Predicates
 
@@ -133,7 +136,7 @@ All included...
 - `(env! (sym val ...))`: modify bindings in current env
 - `(if test truthy falsey?)`: conditional with optional false branch
 - `(let (sym val ...) body)`: locally scoped var bindings/expression
-- `(while test body... (recur (...))?)`: loop while test is truthy
+- `(while test body...)`: loop while test is truthy
 - `(-> ...)`: Clojure-style thread-first S-expression re-writing
     - `(-> a (+ b) (* c))` → `(* (+ a b) c)`
 - `(->> ...)`: Clojure-style thread-last S-expression re-writing
@@ -181,9 +184,10 @@ All included...
 
 ## Extensibility
 
-The core language can be easily customized/extended by defining new items in the
-root environment `ENV` (see example below) or passing a custom environment to
-[`evalSource()`](https://docs.thi.ng/umbrella/lispyfunctions/evalSource.html).
+The core language can be easily customized/extended by defining new symbols (or
+redefining existing ones) in the root environment `ENV` (see example below) or
+passing a custom environment to
+[`evalSource()`](https://docs.thi.ng/umbrella/lispy/functions/evalSource.html).
 
 ## Status
 
@@ -217,7 +221,7 @@ For Node.js REPL:
 const lispy = await import("@thi.ng/lispy");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 1.92 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 1.96 KB
 
 ## Dependencies
 
@@ -247,12 +251,22 @@ directory is using this package:
 
 [Generated API docs](https://docs.thi.ng/umbrella/lispy/)
 
+> [!NOTE]
+> Please also see
+> [/tests](https://github.com/thi-ng/umbrella/blob/develop/packages/lispy/test)
+> for more small code examples..
+
 ```ts tangle:export/readme-1.ts
 import { evalSource, ENV } from "@thi.ng/lispy";
 
-// define custom FFI in the root environment
-// (here it's actually the same as default print fn)
-ENV.print = console.log;
+// define custom root environment
+const CUSTOM_ENV = {
+    ...ENV,
+    // re-define print fn (actually the same as default)
+    print: console.log,
+    // pre-define new global variable
+    name: "lispy"
+};
 
 const SRC = `
 (print (+ 1 2 3 4))
@@ -266,7 +280,7 @@ const SRC = `
 ;; here, a curried version of the built-in print fn
 (def greetings! (partial print "hello,"))
 
-;; print greeting (name will be provided externally)
+;; print greeting ('name' symbol provided via custom env)
 (greetings! name)
 ;; hello, lispy!
 
@@ -290,7 +304,7 @@ const SRC = `
 `;
 
 // execute with customized environment
-evalSource(SRC, {...ENV, name: "lispy"});
+evalSource(SRC, CUSTOM_ENV);
 
 // output:
 // 10

package/index.js

@@ -104,6 +104,9 @@ const BUILTINS = defmulti(
       }
       return obj;
     },
+    keys: ([_, x], env) => Object.keys(interpret(x, env)),
+    vals: ([_, x], env) => Object.values(interpret(x, env)),
+    pairs: ([_, x], env) => Object.entries(interpret(x, env)),
     // rewriting operators:
     // iteratively threads first child as FIRST arg of next child
     // (-> a (+ b) (* c)) = (* (+ a b) c)
@@ -151,6 +154,8 @@ const ENV = {
   T: true,
   F: false,
   null: null,
+  INF: Infinity,
+  "-INF": -Infinity,
   and: (...args) => {
     let x;
     for (x of args) {
@@ -229,7 +234,7 @@ const ENV = {
   step,
   smoothstep: smoothStep,
   get: (arr, i) => arr[i],
-  "set!": (arr, i, x) => arr[i] = x,
+  "set!": (arr, i, x) => (arr[i] = x, arr),
   push: (list, ...x) => (list.push(...x), list),
   concat: (list, ...x) => list.concat(...x),
   // returns length of first argument (presumably a list or string)

package/kernel.d.ts

@@ -1,2 +1,2 @@
-export declare const KERNEL = "\n; partial functional application (currying for 1 arg)\n(defn partial (f x) (fn (y) (f x y)))\n\n; partial functional application (currying for 2 args)\n(defn partial2 (f x y) (fn (z) (f x y z)))\n\n; functional composition for 1-arg fns\n(defn comp (f g) (fn (x) (f (g x))))\n\n; functional composition for 2-arg fns\n(defn comp2 (f g) (fn (x y z) (f (g x y) z)))\n\n; calls f if x is nullish\n(defn fnull? (x f) (if (null? x) (f) x))\n\n; list reduction\n(defn reduce (f acc xs) (if xs (reduce f (f acc (first xs)) (next xs)) acc))\n\n; list transformation (expressed as reduction)\n(defn map (f xs) (reduce (fn (acc x) (concat acc (f x))) (list) xs))\n\n; filter list with predicate function\n(defn filter (f xs) (reduce (fn (acc x) (if (f x) (concat acc x) acc)) (list) xs))\n";
+export declare const KERNEL = "\n; partial functional application (currying for 1 arg)\n(defn partial (f x) (fn (y) (f x y)))\n\n; partial functional application (currying for 2 args)\n(defn partial2 (f x y) (fn (z) (f x y z)))\n\n; functional composition for 1-arg fns\n(defn comp (f g) (fn (x) (f (g x))))\n\n(defn complement (f) (fn (x) (not (f x))))\n\n; calls f if x is nullish\n(defn fnull? (x f) (if (null? x) (f) x))\n\n; list reduction\n(defn reduce (f acc xs) (if xs (reduce f (f acc (first xs)) (next xs)) acc))\n\n; list transformation (expressed as reduction)\n(defn map (f xs) (reduce (fn (acc x) (concat acc (f x))) (list) xs))\n\n; filter list with predicate function\n(defn filter (f xs) (reduce (fn (acc x) (if (f x) (concat acc x) acc)) (list) xs))\n";
 //# sourceMappingURL=kernel.d.ts.map

package/kernel.js

@@ -8,8 +8,7 @@ const KERNEL = `
 ; functional composition for 1-arg fns
 (defn comp (f g) (fn (x) (f (g x))))
 
-; functional composition for 2-arg fns
-(defn comp2 (f g) (fn (x y z) (f (g x y) z)))
+(defn complement (f) (fn (x) (not (f x))))
 
 ; calls f if x is nullish
 (defn fnull? (x f) (if (null? x) (f) x))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/lispy",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Lightweight, extensible, interpreted Lisp-style DSL for embedding in other projects",
   "type": "module",
   "module": "./index.js",
@@ -39,19 +39,19 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.27",
-    "@thi.ng/checks": "^3.7.7",
-    "@thi.ng/compare": "^2.4.19",
-    "@thi.ng/defmulti": "^3.0.67",
-    "@thi.ng/errors": "^2.5.33",
-    "@thi.ng/math": "^5.11.27",
-    "@thi.ng/object-utils": "^1.1.23",
-    "@thi.ng/sexpr": "^1.0.17",
-    "@thi.ng/strings": "^3.9.12"
+    "@thi.ng/api": "^8.11.28",
+    "@thi.ng/checks": "^3.7.8",
+    "@thi.ng/compare": "^2.4.20",
+    "@thi.ng/defmulti": "^3.0.68",
+    "@thi.ng/errors": "^2.5.34",
+    "@thi.ng/math": "^5.11.28",
+    "@thi.ng/object-utils": "^1.1.24",
+    "@thi.ng/sexpr": "^1.0.18",
+    "@thi.ng/strings": "^3.9.13"
   },
   "devDependencies": {
-    "esbuild": "^0.25.3",
-    "typedoc": "^0.28.3",
+    "esbuild": "^0.25.5",
+    "typedoc": "^0.28.5",
     "typescript": "^5.8.3"
   },
   "keywords": [
@@ -96,5 +96,5 @@
     "status": "beta",
     "year": 2023
   },
-  "gitHead": "0108278642f57ca9fc7bed0edc967991c20cd594\n"
+  "gitHead": "61c3833b7ef7d044621454b5ea4af885d39f065e\n"
 }