@dallaylaen/ski-interpreter 2.1.0 → 2.2.1

package/CHANGELOG.md

@@ -5,6 +5,43 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.1] - 2026-02-22
+
+### Added
+
+- `Expr.diag()` outputs an expression as an indented tree (breadth-first) with class names and variables labeled for deduplication.
+- `lib/ski-quest.min.js` bundle to create quest pages.
+- The [playground](https://dallaylaen.github.io/ski-interpreter/playground.html) gets history!
+
+### Fixed
+
+- Greatly improved type definitions.
+- Quests calculate solution complexity via `fold()`.
+
+## [2.2.0] - 2026-02-14
+
+### BREAKING CHANGES
+
+- Remove `Expr.declare()` method for good, use `toposort()` or static `declare` instead
+
+### Added
+
+- `SKI.extras.toposort(list, env)` function to output named terms in dependency order
+- `SKI.extras.declare(term, {env})` function for term declarations
+- `Expr.unroll()` method to get a list of terms
+that give the initial expression when applied
+from left to right: `((a, b), (c, d)) => [a, b, (c, d)]`
+- Parser: Support for chained assignments (`'foo=bar=baz'` expressions)
+- Parser: Support for multi-line comment syntax (`/* comments */`)
+- `SKI_REPL=1 node -r @dallaylaen/ski-interpreter` will now start a REPL with the `SKI` class available globally.
+
+### Changed
+
+- Parser improvements and bug fixes for variable handling
+- `expand()` method refactored to use `traverse()`
+- Package now builds both CJS and ESM bundles.
+- Moved source from `lib/` to `src/` directory
+
 ## [2.1.0] - 2026-02-12
 
 ### BREAKING CHANGES

package/README.md

@@ -68,16 +68,19 @@ all free variables are bound.
 This page contains small tasks of increasing complexity.
 Each task requires the user to build a combinator with specific properties.
 
-# CLI
-
-REPL comes with the package as [bin/ski.js](bin/ski.js).
-
 # Installation
 
 ```bash
 npm install @dallaylaen/ski-interpreter
 ```
 
+# CLI
+
+REPL comes with the package as [bin/ski.js](bin/ski.js).
+
+Running `SKI_REPL=1 node -r @dallaylaen/ski-interpreter/bin/ski.js`
+will start a node shell with the `SKI` class available as a global variable.
+
 # Usage
 
 ## A minimal example
@@ -147,7 +150,11 @@ const lambdaSteps = [...skiExpr.toLambda()];
 ## Fancy formatting
 
 The `format` methods of the `Expr` class supports
-a number of options, see [the source code](lib/expr.js) for details.
+a number of options, see [the source code](src/expr.js) for details.
+
+`expr.diag()` will instead output indented
+expression tree (breadth-first) with class information
+and variables labeled for disambiguation.
 
 ## Variable scoping
 
@@ -183,6 +190,9 @@ expr.traverse(e => e.equals(SKI.I) ? SKI.S.apply(SKI.K, SKI.K) : null);
 // replaces all I's with S K K
 // here a returned `Expr` object replaces the subexpression,
 // whereas `null` means "leave it alone and descend if possible"
+
+expr.fold(0, (acc, e) => acc + (e.equals(SKI.K) ? acc+1 : acc));
+// counts the number of K's in the expression
 ```
 
 ## Test cases
@@ -209,6 +219,17 @@ q.check('K(K(y x))') // nope! the variable scopes won't match
 
 See [quest page data](docs/quest-data/) for more examples.
 
+# Package contents
+
+* `lib/ski-interpreter.cjs.js` - main entry point for Node.js;
+* `lib/ski-interpreter.esm.js` - main entry point for ES modules;
+* `lib/ski-interpreter.min.js` - minified version for browsers;
+* `lib/ski-quest.min.js` - script with the interpreter
+plus `QuestBox`, `QuestChapter`, and `QuestPage` classes
+for building interactive quest pages from JSON-encoded quest data;
+* `bin/ski.js` - a CLI REPL;
+* `types` - TypeScript type definitions.
+
 # Thanks
 
 * [@ivanaxe](https://github.com/ivanaxe) for luring me into [icfpc 2011](http://icfpc2011.blogspot.com/2011/06/task-description-contest-starts-now.html) where I was introduced to combinators.

package/bin/ski.js

@@ -2,7 +2,7 @@
 
 const fs = require('node:fs/promises');
 
-const { SKI } = require('../index');
+const { SKI } = require('../lib/ski-interpreter.cjs');
 
 const [myname, options, positional] = parseArgs(process.argv);