Initial commit.

Author: ldthomas

.gitignore

@@ -0,0 +1,17 @@
+.*
+!.gitignore
+*~
+*.log
+*.out
+*.zip
+*.tgz
+*.html
+**html/
+!dist/guide/*
+**node_modules/
+**docs/
+**input/
+**output/
+**tmp/
+**test/
+

LICENSE.md

@@ -0,0 +1,28 @@
+## [2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause)
+
+<p>
+Copyright (c) 2021 Lowell D. Thomas<br>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+</p>

README.md

@@ -0,0 +1,85 @@
+# JavaScript APG
+
+## What's New
+
+`apg-js` obsoletes `apg`, `apg-lib`, `apg-exp`, `apg-conv`, `apg-conv-api` and `apg-api`. It changes them in two significant ways.
+
+-   It fixes a major problem in the attributes algorithm. Previous versions could fail on large grammars with many or large sets of mutually-recursive rules.
+-   It combines all of those packages into a single, easier to manage and maintain package.
+
+## Overview
+
+`apg-js` is the JavaScript version of APG, an ABNF Parser Generator. APG generates recursive-descent parsers directly from a superset of [ABNF](https://tools.ietf.org/html/rfc5234) (SABNF). Visit the [APG](https://sabnf.com/`) website for a complete [overview](https://sabnf.com/overview/) of APG and SABNF.
+
+## Installation
+
+> `npm install apg-js`
+
+or
+
+> `git clone https://github.com/ldthomas/apg-js.git`
+
+## Documentation
+
+This package is meant to assist other parsing applications and is normally not installed by itself, rather installed along with those other applications. For details and many examples of using of the libraries, both in node.js and browser applications, see `apg-js-examples` at [GitHub](https://github.com/ldthomas/apg-js-examples) or [npmjs](https://www.npmjs.com/package/apg-js-examples).
+However, it does provide access to two, node.js applications.
+
+### Applications
+
+`apg` is the parser generator. To see its usage run,
+
+> `npm run apg`
+
+`apg-conv` is a data conversion application. To see its usage run,
+
+> `npm run apg-conv`
+
+### Libraries
+
+This package also contains four libraries that can be used in either node.js or browser applications.
+The libraries depend upon one another and the dependency tree looks like so:
+
+```
+apg-exp
+|- apg-api
+|-|- apg-lib
+|-|-|- apg-conv-api
+```
+
+Each of the libraries is bundled for browser use along with some special styles.
+Each bundle contains all of its dependencies explicitly. That is, if a browser application needs both `apg-api` and `apg-lib`, only the `apg-api` bundle need be scripted into the page.
+
+The library and css bundles are in the `./dist` directory.
+
+```
+./dist/apg-exp-bundle.js
+./dist/apg-api-bundle.js
+./dist/apg-lib-bundle.js
+./dist/apg-conv-api-bundle.js
+./dist/apg-lib-bundle.css
+```
+
+The bundles can all be regenerated with:
+
+```
+npm install -g [email protected]
+npm install -g [email protected]
+npm install -g [email protected]
+npm run bundle-apg-conv-api
+npm run bundle-apg-lib
+npm run bundle-apg-api
+npm run bundle-apg-exp
+npm run bundle-apg-lib-css
+```
+
+### Code Documentation
+
+The code documentation is in [docco](http://ashkenas.com/docco/) format and can be generated with:
+
+```
+npm install -g [email protected]
+./bin/docco-gen.sh
+```
+
+(Higher versions of docco may work, but some lower versions definitely do not.)
+The documentation is then at `./docs/index.html` or see it [here](https://sabnf.com/docs/java-script/apg-exp-guide/index.html) at the [APG](https://sabnf.com/) website.

bin/apg-api-bundle.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+browserify ./src/apg-api/web-exports.js > temp-bundle.js
+minify temp-bundle.js > ./dist/apg-api-bundle.js
+rm temp-bundle.js
+exit 0
+

bin/apg-conv-api-bundle.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+browserify ./src/apg-conv-api/web-exports.js > temp-bundle.js
+minify temp-bundle.js > ./dist/apg-conv-api-bundle.js
+rm temp-bundle.js
+exit 0
+

bin/apg-conv.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+(require("../src/apg-conv/apg-conv.js"))();

bin/apg-exp-bundle.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+browserify ./src/apg-exp/web-exports.js > temp-bundle.js
+minify temp-bundle.js > ./dist/apg-exp-bundle.js
+rm temp-bundle.js
+exit 0
+

bin/apg-lib-bundle.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+browserify ./src/apg-lib/web-exports.js > temp-bundle.js
+minify temp-bundle.js > ./dist/apg-lib-bundle.js
+rm temp-bundle.js
+exit 0
+

bin/apg.sh

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("../src/apg/apg.js")(process.argv.slice(2));

bin/docco-gen.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+docco -l classic index.md README.md LICENSE.md \
+ ./src/apg/*.js \
+ ./src/apg-api/*.js \
+ ./src/apg-conv/*.js \
+ ./src/apg-conv-api/*.js \
+ ./src/apg-exp/*.js \
+ ./src/apg-lib/*.js
+exit 0

dev/apg-lib-bundle-css.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+console.log(process.cwd());
+let toless = require("./jsonToLESS.js");
+let tojs = require("./jsonToCLASS_.js");
+let emitcss = require("./cssToJS.js");
+let exec = require("child_process").exec;
+
+// 1. Create ./dist/temp.css (temporary, non-compressed)
+toless("./dev/style.json", "./temp.less");
+console.log("complete: create ./temp.less");
+exec("cat ./temp.less ./dev/apg-lib.less > ./temp-cat.less", (error, stdout, stderr) => {
+    if (error) {
+        console.error(`exec error: cat ./temp.less ./apg-lib.less > ./temp-cat.less: ${error}`);
+        return;
+    }
+    console.log("complete 1.: composite LESS file created, ./temp-cat.less");
+    
+    // 2. LESS to create the css file
+    exec("lessc ./temp-cat.less ./temp.css", (error, stdout, stderr) => {
+        if (error) {
+            console.error(`exec error: lessc ./temp-cat.less ./temp.css: ${error}`);
+            return;
+        }
+        console.log("complete 2.: create the uncompressed css file, temp.css");
+
+        // 3. Create ./src/emitcss.js
+        emitcss("./temp.css", "./src/apg-lib/emitcss.js");
+        console.log("complete 3.: css file generates emitcss.js");
+
+        // 4. Create ./src/style.js
+        tojs(".//dev/style.json", "./src/apg-lib/style.js");
+        console.log("complete 4.: generate the style.js file");
+
+        // 5. compress css -> apg-lib-bundle.css
+        exec("minify ./temp.css > ./dist/apg-lib-bundle.css", (error, stdout, stderr) => {
+            if (error) {
+                console.error(`exec error: minify ./temp.css > ../dist/apg-lib-bundle.css: ${error}`);
+                return;
+            }
+            console.log("complete 5.: compress the css file");
+            
+            // 6. delete temporary files
+            exec("rm ./temp.less && rm ./temp-cat.less && rm ./temp.css", (error, stdout, stderr) => {
+                if (error) {
+                    console.error(`exec error: rm ./temp.less && rm ./temp-cat.less && rm ./temp.css: ${error}`);
+                    return;
+                }
+                console.log("complete 6.: delete temporary files");
+            });
+        });
+    });
+});
+
+return;