eolang 0.33.0 → 0.33.2

package/Formula/eolang.rb

@@ -7,9 +7,9 @@ require "language/node"
 class Eolang < Formula
   desc "Command-line Tool-Kit"
   homepage "https://github.com/objectionary/eoc"
-  url "https://github.com/objectionary/eoc/archive/refs/tags/0.32.1.tar.gz"
-  version "0.32.1"
-  sha256 "6770b4eb3068b5675e2f8c1cce580693f2ad844c6f9472fd2e236f81ba356ab2"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.33.1.tar.gz"
+  version "0.33.1"
+  sha256 "ba76c6b5e63db422777583bcf09020683ebfbe59b28bc949df5e178c1756a1f4"
   license "MIT"
 
   depends_on "node"

package/Formula/eolang@0.32.0.rb

@@ -7,9 +7,9 @@ require "language/node"
 class Eolang < Formula
   desc "Command-line Tool-Kit"
   homepage "https://github.com/objectionary/eoc"
-  url "https://github.com/objectionary/eoc/archive/refs/tags/0.32.1.tar.gz"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.33.1.tar.gz"
   version "0.32.0"
-  sha256 "6770b4eb3068b5675e2f8c1cce580693f2ad844c6f9472fd2e236f81ba356ab2"
+  sha256 "ba76c6b5e63db422777583bcf09020683ebfbe59b28bc949df5e178c1756a1f4"
   license "MIT"
 
   depends_on "node"

package/Formula/eolang@0.32.1.rb

@@ -0,0 +1,25 @@
+#
+# SPDX-FileCopyrightText: Copyright (c) 2022-2025 Objectionary.com
+# SPDX-License-Identifier: MIT
+#
+
+require "language/node"
+class Eolang < Formula
+  desc "Command-line Tool-Kit"
+  homepage "https://github.com/objectionary/eoc"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.33.1.tar.gz"
+  version "0.32.1"
+  sha256 "ba76c6b5e63db422777583bcf09020683ebfbe59b28bc949df5e178c1756a1f4"
+  license "MIT"
+
+  depends_on "node"
+
+  def install
+    system "npm", "install", *std_npm_args
+    bin.install_symlink Dir["#{libexec}/bin/*"]
+  end
+
+  test do
+    system "#{bin}/eoc", "--version"
+  end
+end

package/Formula/eolang@0.33.0.rb

@@ -0,0 +1,25 @@
+#
+# SPDX-FileCopyrightText: Copyright (c) 2022-2025 Objectionary.com
+# SPDX-License-Identifier: MIT
+#
+
+require "language/node"
+class Eolang < Formula
+  desc "Command-line Tool-Kit"
+  homepage "https://github.com/objectionary/eoc"
+  url "https://github.com/objectionary/eoc/archive/refs/tags/0.33.1.tar.gz"
+  version "0.33.0"
+  sha256 "ba76c6b5e63db422777583bcf09020683ebfbe59b28bc949df5e178c1756a1f4"
+  license "MIT"
+
+  depends_on "node"
+
+  def install
+    system "npm", "install", *std_npm_args
+    bin.install_symlink Dir["#{libexec}/bin/*"]
+  end
+
+  test do
+    system "#{bin}/eoc", "--version"
+  end
+end

package/README.md

@@ -18,14 +18,14 @@ First, you install [npm][npm-install] and [Java SE][java-se].
 Then, you install [eolang][npm] package, using [npm][npm-install]:
 
 ```bash
-npm install -g eolang@0.32.1
+npm install -g eolang@0.33.1
 ```
 
 You can also use [Homebrew] (on macOS):
 
 ```bash
 brew tap objectionary/eoc https://github.com/objectionary/eoc
-brew install objectionary/eoc/eolang@0.32.1
+brew install objectionary/eoc/eolang@0.33.1
 ```
 
 Then, you write a simple [EO](https://www.eolang.org) program in `hello.eo` file

package/eslint.config.js

@@ -60,16 +60,7 @@ module.exports = [
       'require-unicode-regexp': 'off',
       'sort-keys': 'off',
       'sort-vars': 'off',
-      "promise/prefer-await-to-then": "off"
+      "promise/prefer-await-to-then": "error"
     }
   },
-  {
-    files: [
-      'src/commands/js/transpile.js',
-      'src/commands/js/link.js',
-    ],
-    rules: {
-      'promise/prefer-await-to-then': 'warn',
-    },
-  }
 ];

package/mvnw/dependency-reduced-pom.xml

@@ -121,6 +121,6 @@
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <heap-size>undefined</heap-size>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <jeo.version>0.14.0</jeo.version>
+    <jeo.version>0.14.12</jeo.version>
   </properties>
 </project>

package/mvnw/mvnw

@@ -23,7 +23,7 @@
 # ----------------------------------------------------------------------------
 
 # ----------------------------------------------------------------------------
-# Apache Maven Wrapper startup batch script, version 3.3.0
+# Apache Maven Wrapper startup batch script, version 3.3.4
 #
 # Optional ENV vars
 # -----------------

package/mvnw/mvnw.cmd

@@ -23,7 +23,7 @@
 @REM ----------------------------------------------------------------------------
 
 @REM ----------------------------------------------------------------------------
-@REM Apache Maven Wrapper startup batch script, version 3.3.0
+@REM Apache Maven Wrapper startup batch script, version 3.3.4
 @REM
 @REM Optional ENV vars
 @REM   MVNW_REPOURL - repo url base for downloading maven distribution

package/mvnw/pom.xml

@@ -10,7 +10,7 @@
   <version>0.0.0</version>
   <packaging>jar</packaging>
   <properties>
-    <jeo.version>0.14.0</jeo.version>
+    <jeo.version>0.14.12</jeo.version>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <eo.version>undefined</eo.version>
@@ -26,13 +26,13 @@
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
-      <version>5.13.4</version>
+      <version>6.0.0</version>
       <scope>compile</scope>
     </dependency>
     <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-engine</artifactId>
-      <version>5.13.4</version>
+      <version>6.0.0</version>
       <scope>compile</scope>
     </dependency>
   </dependencies>

package/package.json

@@ -24,9 +24,9 @@
     "eslint-plugin-promise": "^7.2.1",
     "grunt": "^1.6.1",
     "grunt-contrib-clean": "^2.0.1",
-    "grunt-eslint": "^25.0.0",
+    "grunt-eslint": "^26.0.0",
     "grunt-mocha-cli": "^7.0.0",
-    "mocha": "^11.7.2",
+    "mocha": "^11.7.4",
     "patch-package": "^8.0.0"
   },
   "engines": {
@@ -57,5 +57,5 @@
     "postinstall": "node scripts/postinstall.js",
     "test": "mocha --timeout 1200000"
   },
-  "version": "0.33.0"
+  "version": "0.33.2"
 }

package/src/commands/assemble.js

@@ -15,8 +15,9 @@ const {elapsed} = require('../elapsed');
  */
 module.exports = function(opts) {
   const target = path.resolve(opts.target);
-  return elapsed((tracked) => mvnw(['eo:assemble'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
+  return elapsed(async (tracked) => {
+    const r = await mvnw(['eo:assemble'].concat(flags(opts)), opts.target, opts.batch);
     tracked.print(`EO program assembled in ${rel(target)}`);
     return r;
-  }));
+  });
 };

package/src/commands/docs.js

@@ -5,6 +5,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const SaxonJS = require('saxon-js');
 
 /**
  * Recursively reads all .xmir files from a directory.
@@ -25,27 +26,127 @@ function readXmirsRecursively(dir) {
   return files;
 }
 
+/**
+ * Applies XSLT to XMIR
+ * @param {String} xmir - Text of XMIR file
+ * @param {String} xsl - Text of XSL file
+ * @return {String} HTML document
+ */
+function transformDocument(xmir, xsl) {
+  const html = SaxonJS.XPath.evaluate(
+    `transform(
+        map { 
+            'source-node' : parse-xml($xml), 
+            'stylesheet-text' : $xslt,
+            'delivery-format' : 'serialized' 
+        }
+    )?output`, 
+    null, 
+    {
+      params : {
+        'xml' : xmir, 
+        'xslt' : xsl
+      } 
+    }
+  );
+  return html;
+}
+
+/**
+ * Creates documentation block from given XMIR
+ * @param {String} xmir_path - path of XMIR
+ * @return {String} HTML block
+ */
+function createXmirHtmlBlock(xmir_path) {
+  try {
+    const xmir = fs.readFileSync(xmir_path).toString();
+    const xsl = fs.readFileSync(path.join(__dirname, '..', 'resources', 'xmir-transformer.xsl')).toString();
+    return transformDocument(xmir, xsl);
+  } catch(error) {
+    throw new Error(`Error while applying XSL to XMIR: ${error.message}`, error);
+  }
+}
+
+/**
+ * Generates Package HTML
+ * @param {String} name - Package name
+ * @param {String[]} xmir_htmls - Array of xmirs htmls
+ * @param {String} css_path - CSS file path
+ * @return {String} HTML of the package
+ */
+function generatePackageHtml(name, xmir_htmls, css_path) {
+  const title = `<h1 class="package-title">Package ${name} documentation</h1>`;
+  return `<!DOCTYPE html>
+    <html>
+      <head>
+        <link href="${css_path}" rel="stylesheet" type="text/css">
+        ${title}
+      </head>
+      <body>
+        ${xmir_htmls.join('\n')}
+      </body>
+    </html>`;
+}
+
+/**
+ * Wraps given html body
+ * @param {String} html - HTML body
+ * @param {String} css_path - CSS file path
+ * @return {String} Ready HTML
+ */
+function wrapHtml(html, css_path) {
+  return `
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <link href="${css_path}" rel="stylesheet" type="text/css">
+      </head>
+      <body>
+        ${html}
+      </body>
+    </html>
+  `;
+}
+
 /**
  * Command to generate documentation.
  * @param {Hash} opts - All options
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   try {
-    const input = path.resolve(opts.target, '.eoc', '1-parse');
+    const input = path.resolve(opts.target, '1-parse');
     const output = path.resolve(opts.target, 'docs');
     fs.mkdirSync(output, {recursive: true});
+    const css = path.join(output, 'styles.css');
+    fs.writeFileSync(css, '');
+    const packages_info = {};
+    const all_xmir_htmls = [];
     const xmirs = readXmirsRecursively(input);
     for (const xmir of xmirs) {
       const relative = path.relative(input, xmir);
+      const name = path.parse(xmir).name;
+      const xmir_html = createXmirHtmlBlock(xmir);
+      const html_app = path.join(output, path.dirname(relative),`${name}.html`);
+      fs.mkdirSync(path.dirname(html_app), {recursive: true});
+      fs.writeFileSync(html_app, wrapHtml(xmir_html, css));
       const packages = path.dirname(relative).split(path.sep).join('.');
-      const html = path.join(output, `package_${packages}.html`);
-      fs.mkdirSync(path.dirname(html), {recursive: true});
-      fs.writeFileSync(html, '');
+      const html_package = path.join(output, `package_${packages}.html`);
+      if (!(packages in packages_info)) {
+        packages_info[packages] = {
+          xmir_htmls : [],
+          path: html_package
+        };
+      }
+      packages_info[packages].xmir_htmls.push(xmir_html);
+      all_xmir_htmls.push(xmir_html);
+    }
+    for (const package_name of Object.keys(packages_info)) {
+      fs.mkdirSync(path.dirname(packages_info[package_name].path), {recursive: true});
+      fs.writeFileSync(packages_info[package_name].path,
+        generatePackageHtml(package_name, packages_info[package_name].xmir_htmls, css));
     }
     const packages = path.join(output, 'packages.html');
-    fs.writeFileSync(packages, '');
-    const css = path.join(output, 'styles.css');
-    fs.writeFileSync(css, '');
+    fs.writeFileSync(packages, generatePackageHtml('', all_xmir_htmls, css));
     console.info('Documentation generation completed in the %s directory', output);
   } catch (error) {
     console.error('Error generating documentation:', error);

package/src/commands/java/compile.js

@@ -12,14 +12,13 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of compile task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const target = path.resolve(opts.target);
   /**
    * @todo #368:30min Wrap logs in 'elapsed'
    *  It is necessary to use 'elapsed' in all logging cases that require output of elapsed time
    */
-  return mvnw(['test-compile'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('Java .class files compiled in %s', rel(target));
-    return r;
-  });
+  const r = await mvnw(['test-compile'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('Java .class files compiled in %s', rel(target));
+  return r;
 };

package/src/commands/java/link.js

@@ -12,10 +12,9 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of link task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const jar = path.resolve(opts.target, 'eoc.jar');
-  return mvnw(['jar:jar', 'shade:shade'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('Executable JAR created at %s', rel(jar));
-    return r;
-  });
+  const r = await mvnw(['jar:jar', 'shade:shade'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('Executable JAR created at %s', rel(jar));
+  return r;
 };

package/src/commands/java/resolve.js

@@ -12,15 +12,12 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of resolve task
  */
-module.exports = function(opts) {
-  return mvnw(['eo:resolve'].concat(flags(opts)), opts.target, opts.batch)
-    .then((r) => {
-      const sources = path.resolve(opts.target, 'eo/6-resolve');
-      console.info('Dependencies resolved in %s', rel(sources));
-      return mvnw(['eo:place'].concat(flags(opts)), opts.target, opts.batch);
-    }).then((r) => {
-      const classes = path.resolve(opts.target, 'classes');
-      console.info('Dependencies placed in %s', rel(classes));
-      return r;
-    });
+module.exports = async function(opts) {
+  await mvnw(['eo:resolve'].concat(flags(opts)), opts.target, opts.batch);
+  const sources = path.resolve(opts.target, 'eo/6-resolve');
+  console.info('Dependencies resolved in %s', rel(sources));
+  const r = await mvnw(['eo:place'].concat(flags(opts)), opts.target, opts.batch);
+  const classes = path.resolve(opts.target, 'classes');
+  console.info('Dependencies placed in %s', rel(classes));
+  return r;
 };

package/src/commands/java/transpile.js

@@ -12,10 +12,9 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of transpile task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const sources = path.resolve(opts.target, 'generated-sources');
-  return mvnw(['eo:transpile'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('Java sources generated in %s', rel(sources));
-    return r;
-  });
+  const r = await mvnw(['eo:transpile'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('Java sources generated in %s', rel(sources));
+  return r;
 };

package/src/commands/jeo/assemble.js

@@ -12,8 +12,8 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of assemble task
  */
-module.exports = function(opts) {
-  return mvnw(
+module.exports = async function(opts) {
+  const r = await mvnw(
     ['jeo:assemble']
       .concat(flags(opts))
       .concat(
@@ -24,11 +24,10 @@ module.exports = function(opts) {
         ]
       ),
     opts.target, opts.batch
-  ).then((r) => {
-    console.info(
-      'EO .xmir files from %s assembled to .class files in %s',
-      rel(opts.xmirs), rel(opts.classes)
-    );
-    return r;
-  });
+  );
+  console.info(
+    'EO .xmir files from %s assembled to .class files in %s',
+    rel(opts.xmirs), rel(opts.classes)
+  );
+  return r;
 };

package/src/commands/jeo/disassemble.js

@@ -12,8 +12,8 @@ const path = require('path');
  * @param {Object} opts - All options
  * @return {Promise} of disassemble task
  */
-module.exports = function(opts) {
-  return mvnw(
+module.exports = async function(opts) {
+  const r = await mvnw(
     ['jeo:disassemble']
       .concat(flags(opts))
       .concat(
@@ -24,11 +24,10 @@ module.exports = function(opts) {
         ]
       ),
     opts.target, opts.batch
-  ).then((r) => {
-    console.info(
-      'Bytecode .class files from %s disassembled to .xmir files in %s',
-      rel(opts.classes), rel(opts.xmirs)
-    );
-    return r;
-  });
+  );
+  console.info(
+    'Bytecode .class files from %s disassembled to .xmir files in %s',
+    rel(opts.classes), rel(opts.xmirs)
+  );
+  return r;
 };

package/src/commands/latex.js

@@ -13,10 +13,9 @@ const fs = require('fs');
  * @param {Object} opts - All options
  * @return {Promise} of latex generation task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const latex = path.resolve(opts.target, 'latex');
-  return mvnw(['eo:latex'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('LaTeX files generated in %s', rel(latex));
-    return r;
-  });
+  const r = await mvnw(['eo:latex'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('LaTeX files generated in %s', rel(latex));
+  return r;
 };

package/src/commands/lint.js

@@ -13,32 +13,38 @@ const semver = require('semver');
  * @param {Hash} opts - All options
  * @return {Promise} of assemble task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const extra = [
     `-Deo.failOnWarning=${opts.easy ? 'false' : 'true'}`,
     `-Deo.skipLinting=${opts.blind ? 'true' : 'false'}`,
   ];
   if (opts.parser.endsWith('-SNAPSHOT') || semver.gte(opts.parser, '0.45.0')) {
-    return mvnw(
-      ['eo:lint'].concat(flags(opts)).concat(extra),
-      opts.target, opts.batch
-    ).then((r) => {
+    try {
+      const r = await mvnw(
+        ['eo:lint'].concat(flags(opts)).concat(extra),
+        opts.target, opts.batch
+      );
       console.info('EO program linted in %s', rel(path.resolve(opts.target)));
       return r;
-    }).catch((error) => {
+    } catch (error) {
       throw new Error(
-        'There are errors and/or warnings; you may disable warnings via the --easy option'
+        'There are errors and/or warnings; you may disable warnings via the --easy option',
+        { cause: error }
       );
-    });
+    }
   }
-  return mvnw(
-    ['eo:verify'].concat(flags(opts)).concat(extra),
-    opts.target, opts.batch
-  ).then((r) => {
+  try {
+    const r = await mvnw(
+      ['eo:verify'].concat(flags(opts)).concat(extra),
+      opts.target, opts.batch
+    );
     console.info('EO program verified in %s', rel(path.resolve(opts.target)));
     return r;
-  }).catch((error) => {
-    throw new Error('You may disable warnings via the --easy option');
-  });
+  } catch (error) {
+    throw new Error(
+      'You may disable warnings via the --easy option',
+      { cause: error }
+    );
+  }
 
 };

package/src/commands/parse.js

@@ -12,10 +12,9 @@ const {mvnw, flags} = require('../mvnw');
  * @param {Hash} opts - All options
  * @return {Promise} of assemble task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const target = path.resolve(opts.target);
-  return mvnw(['eo:parse'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('EO sources parsed in %s', rel(target));
-    return r;
-  });
+  const r = await mvnw(['eo:parse'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('EO sources parsed in %s', rel(target));
+  return r;
 };

package/src/commands/print.js

@@ -12,12 +12,12 @@ const {mvnw, flags} = require('../mvnw');
  * @param {Object} opts - All options
  * @return {Promise} of assemble task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const input = path.resolve(opts.target, opts.printInput);
   console.debug('Reading from %s', rel(input));
   const output = path.resolve(opts.target, opts.printOutput);
   console.debug('Writing to %s', rel(output));
-  return mvnw(
+  const r = await mvnw(
     ['eo:print']
       .concat(flags(opts))
       .concat(
@@ -27,8 +27,7 @@ module.exports = function(opts) {
         ]
       ),
     opts.target, opts.batch
-  ).then((r) => {
-    console.info('XMIR files converted to EO files at %s', rel(output));
-    return r;
-  });
+  );
+  console.info('XMIR files converted to EO files at %s', rel(output));
+  return r;
 };

package/src/commands/register.js

@@ -12,10 +12,9 @@ const path = require('path');
  * @param {Hash} opts - All options
  * @return {Promise} of register task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const foreign = path.resolve(opts.target, 'eo-foreign.json');
-  return mvnw(['eo:register'].concat(flags(opts)), opts.target, opts.batch).then((r) => {
-    console.info('EO objects registered in %s', rel(foreign));
-    return r;
-  });
+  const r = await mvnw(['eo:register'].concat(flags(opts)), opts.target, opts.batch);
+  console.info('EO objects registered in %s', rel(foreign));
+  return r;
 };

package/src/commands/sodg.js

@@ -12,7 +12,7 @@ const {mvnw, flags} = require('../mvnw');
  * @param {Hash} opts - All options
  * @return {Promise} of sodg task
  */
-module.exports = function(opts) {
+module.exports = async function(opts) {
   const argv = ['eo:sodg'].concat(flags(opts));
   argv.push(`-Deo.sodgIncludes=${opts.include}`);
   if (opts.exclude) {
@@ -36,8 +36,7 @@ module.exports = function(opts) {
     argv.push('-Deo.generateGraphFiles');
     argv.push('-Deo.generateDotFiles');
   }
-  return mvnw(argv, opts.target, opts.batch).then((r) => {
-    console.info('SODG files generated in %s', rel(path.resolve(opts.target)));
-    return r;
-  });
+  const r = await mvnw(argv, opts.target, opts.batch);
+  console.info('SODG files generated in %s', rel(path.resolve(opts.target)));
+  return r;
 };

package/src/mvnw.js

@@ -7,7 +7,7 @@ const path = require('path');
 const fs = require('fs');
 const rel = require('relative');
 const readline = require('readline');
-const {spawn} = require('child_process');
+const { spawn } = require('child_process');
 const colors = require('colors');
 
 /**
@@ -30,7 +30,7 @@ let beginning,
  * @param {Object} opts - Opts provided to the "eoc"
  * @return {Array} of Maven options
  */
-module.exports.flags = function(opts) {
+module.exports.flags = function (opts) {
   const sources = path.resolve(opts.sources);
   console.debug('Sources in %s', rel(sources));
   const target = path.resolve(opts.target);
@@ -58,20 +58,24 @@ module.exports.flags = function(opts) {
  * @param {Boolean} [batch] - Is it batch mode (TRUE) or interactive (FALSE)?
  * @return {Promise} of maven execution task
  */
-module.exports.mvnw = function(args, tgt, batch) {
+module.exports.mvnw = function (args, tgt, batch) {
   return new Promise((resolve, reject) => {
     target = tgt;
     phase = args[0];
-    const home = path.resolve(__dirname, '../mvnw'),
-      bin = path.resolve(home, 'mvnw') + (process.platform === 'win32' ? '.cmd' : ''),
-      params = args.filter((t) => t !== '').concat([
-        '--batch-mode',
-        '--color=never',
-        '--update-snapshots',
-        '--fail-fast',
-        '--strict-checksums',
-      ]),
-      cmd = `${bin  } ${  params.join(' ')}`;
+    const home = path.resolve(__dirname, '../mvnw');
+    let bin = path.resolve(home, 'mvnw') + (process.platform === 'win32' ? '.cmd' : '');
+    if (!fs.existsSync(bin)) {
+      console.warn(colors.yellow(`Warning: mvnw not found at ${bin}, falling back to system "mvn"`));
+      bin = 'mvn';
+    }
+    const params = args.filter((t) => t !== '').concat([
+      '--batch-mode',
+      '--color=never',
+      '--update-snapshots',
+      '--fail-fast',
+      '--strict-checksums',
+    ]);
+    const cmd = `${bin} ${params.join(' ')}`;
     console.debug('+ %s', cmd);
     const result = spawn(
       bin,
@@ -114,7 +118,7 @@ module.exports.mvnw = function(args, tgt, batch) {
 function start() {
   running = true;
   beginning = Date.now();
-  const check = function() {
+  const check = function () {
     if (running) {
       print();
       setTimeout(check, 1000);
@@ -143,18 +147,36 @@ function print() {
    * @return {Integer} Total number files.
    */
   function count(dir, curr) {
-    if (fs.existsSync(dir)) {
-      for (const f of fs.readdirSync(dir)) {
-        const next = path.join(dir, f);
-        if (fs.statSync(next).isDirectory()) {
-          curr = count(next, curr);
-        } else {
-          curr++;
-        }
+    if (!fs.existsSync(dir)) {
+      return curr;
+    }
+    try {
+      const files = fs.readdirSync(dir);
+      for (const f of files) {
+        curr = processFile(path.join(dir, f), curr);
+      }
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        return curr;
       }
+      throw error;
     }
     return curr;
   }
+  function processFile(filePath, curr) {
+    try {
+      const stat = fs.statSync(filePath);
+      if (stat.isDirectory()) {
+        return count(filePath, curr);
+      }
+      return curr + 1;
+    } catch (error) {
+      if (error.code === 'ENOENT') {
+        return curr;
+      }
+      throw error;
+    }
+  }
   let elapsed;
   if (duration < 1000) {
     elapsed = `${duration}ms`;

package/src/resources/xmir-transformer.xsl

@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * SPDX-FileCopyrightText: Copyright (c) 2022-2025 Objectionary.com
+ * SPDX-License-Identifier: MIT
+-->
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+  <xsl:template match="/">
+    <div class="app-block">
+      <xsl:for-each select="//o[(@name and @name != 'φ') and (not(@base) or (@base != '∅' and @base != 'ξ'))]">
+        <xsl:if test="//comments/comment[@line = current()/@line]">
+          <div class="object-block">
+            <xsl:variable name="fullname">
+              <xsl:for-each select="ancestor-or-self::o[@name and @name != 'φ']">
+                <xsl:value-of select="@name"/>
+                <xsl:choose>
+                  <xsl:when test="position() != last()">.</xsl:when>
+                </xsl:choose>
+              </xsl:for-each>
+            </xsl:variable>
+            <h2 class="object-title"><xsl:value-of select="$fullname"/></h2>
+            <p class="object-sign">
+              <xsl:value-of select="$fullname"/>(<xsl:for-each select="current()/o[@base and @base = '∅']">
+                <xsl:value-of select="@name"/>
+                <xsl:choose>
+                  <xsl:when test="position() != last()">, </xsl:when>
+                </xsl:choose>
+              </xsl:for-each>)</p>
+            <p class="object-desc">
+              <xsl:call-template name="break">
+                <xsl:with-param name="text" select="//comments/comment[@line = current()/@line]"/>
+              </xsl:call-template>
+            </p>
+          </div>
+        </xsl:if>
+      </xsl:for-each>
+    </div>
+  </xsl:template>
+  <xsl:template name="break">
+    <xsl:param name="text" select="string(.)"/>
+    <xsl:choose>
+      <xsl:when test="contains($text, '\n')">
+        <xsl:value-of select="substring-before($text, '\n')"/>
+        <br/>
+        <xsl:call-template name="break">
+          <xsl:with-param 
+            name="text" 
+            select="substring-after($text, '\n')"
+          />
+        </xsl:call-template>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:value-of select="$text"/>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:template>
+</xsl:stylesheet>

package/src/version.js

@@ -6,6 +6,6 @@
 // The values here are replaced automatically by the .rultor.yml script,
 // at the "release" pipeline:
 module.exports = {
-  what: '0.33.0',
-  when: '2025-09-16'
+  what: '0.33.2',
+  when: '2025-10-07'
 };