npm - @weborigami/language - Versions diffs - 0.0.35 - Mend

@weborigami/language 0.0.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/index.ts +30 -0
package/main.js +21 -0
package/package.json +24 -0
package/src/compiler/code.d.ts +3 -0
package/src/compiler/compile.js +55 -0
package/src/compiler/origami.pegjs +277 -0
package/src/compiler/parse.js +2292 -0
package/src/compiler/parserHelpers.js +26 -0
package/src/runtime/EventTargetMixin.d.ts +9 -0
package/src/runtime/EventTargetMixin.js +117 -0
package/src/runtime/ExpressionTree.js +20 -0
package/src/runtime/FileLoadersTransform.d.ts +5 -0
package/src/runtime/FileLoadersTransform.js +43 -0
package/src/runtime/ImportModulesMixin.d.ts +5 -0
package/src/runtime/ImportModulesMixin.js +48 -0
package/src/runtime/InheritScopeMixin.js +34 -0
package/src/runtime/InheritScopeMixin.ts +9 -0
package/src/runtime/InvokeFunctionsTransform.d.ts +5 -0
package/src/runtime/InvokeFunctionsTransform.js +27 -0
package/src/runtime/OrigamiFiles.d.ts +11 -0
package/src/runtime/OrigamiFiles.js +9 -0
package/src/runtime/OrigamiTransform.d.ts +11 -0
package/src/runtime/OrigamiTransform.js +11 -0
package/src/runtime/OrigamiTree.js +4 -0
package/src/runtime/ReadMe.md +1 -0
package/src/runtime/Scope.js +89 -0
package/src/runtime/TreeEvent.js +6 -0
package/src/runtime/WatchFilesMixin.d.ts +5 -0
package/src/runtime/WatchFilesMixin.js +58 -0
package/src/runtime/concatTreeValues.js +46 -0
package/src/runtime/evaluate.js +90 -0
package/src/runtime/expressionFunction.js +33 -0
package/src/runtime/extname.js +20 -0
package/src/runtime/format.js +126 -0
package/src/runtime/functionResultsMap.js +28 -0
package/src/runtime/internal.js +20 -0
package/src/runtime/ops.js +222 -0
package/test/compiler/compile.test.js +64 -0
package/test/compiler/parse.test.js +389 -0
package/test/runtime/EventTargetMixin.test.js +68 -0
package/test/runtime/ExpressionTree.test.js +27 -0
package/test/runtime/FileLoadersTransform.test.js +41 -0
package/test/runtime/InheritScopeMixin.test.js +29 -0
package/test/runtime/OrigamiFiles.test.js +37 -0
package/test/runtime/Scope.test.js +37 -0
package/test/runtime/concatTreeValues.js +20 -0
package/test/runtime/evaluate.test.js +55 -0
package/test/runtime/fixtures/foo.js +1 -0
package/test/runtime/fixtures/makeTest/a +1 -0
package/test/runtime/fixtures/makeTest/b = a +0 -0
package/test/runtime/fixtures/metagraphs/foo.txt +1 -0
package/test/runtime/fixtures/metagraphs/greeting = this('world').js +3 -0
package/test/runtime/fixtures/metagraphs/obj = this.json +5 -0
package/test/runtime/fixtures/metagraphs/sample.txt = this().js +3 -0
package/test/runtime/fixtures/metagraphs/string = this.json +1 -0
package/test/runtime/fixtures/metagraphs/value = fn() +0 -0
package/test/runtime/fixtures/programs/context.yaml +4 -0
package/test/runtime/fixtures/programs/files.yaml +2 -0
package/test/runtime/fixtures/programs/obj.yaml +3 -0
package/test/runtime/fixtures/programs/simple.yaml +2 -0
package/test/runtime/fixtures/subgraph = this.js +5 -0
package/test/runtime/fixtures/templates/greet.orit +4 -0
package/test/runtime/fixtures/templates/index.orit +15 -0
package/test/runtime/fixtures/templates/names.yaml +3 -0
package/test/runtime/fixtures/templates/plain.txt +1 -0
package/test/runtime/fixtures/virtualKeys/.keys.json +1 -0
package/test/runtime/format.test.js +66 -0
package/test/runtime/functionResultsMap.test.js +27 -0
package/test/runtime/ops.test.js +111 -0

package/test/runtime/evaluate.test.js ADDED Viewed

@@ -0,0 +1,55 @@
+import { ObjectTree } from "@weborigami/async-tree";
+import assert from "node:assert";
+import { describe, test } from "node:test";
+import * as ops from "../../src/runtime/ops.js";
+import evaluate from "../../src/runtime/evaluate.js";
+describe("evaluate", () => {
+  test("can retrieve values from scope", async () => {
+    const code = [ops.scope, "message"];
+    const scope = {
+      message: "Hello",
+    };
+    const result = await evaluate.call(scope, code);
+    assert.equal(result, "Hello");
+  });
+  test("can invoke functions in scope", async () => {
+    // Match the array representation of code generated by the parser.
+    const code = [
+      [ops.scope, "greet"],
+      [ops.scope, "name"],
+    ];
+    const scope = new ObjectTree({
+      async greet(name) {
+        return `Hello ${name}`;
+      },
+      name: "world",
+    });
+    const result = await evaluate.call(scope, code);
+    assert.equal(result, "Hello world");
+  });
+  test("passes context to invoked functions", async () => {
+    const code = [ops.scope, "fn"];
+    const scope = {
+      async fn() {
+        assert.equal(this, scope);
+      },
+    };
+    await evaluate.call(scope, code);
+  });
+  test("if object in function position isn't a function, can unpack it", async () => {
+    const fn = (...args) => args.join(",");
+    const packed = {
+      unpack: async () => fn,
+    };
+    const code = [packed, "a", "b", "c"];
+    const result = await evaluate.call(null, code);
+    assert.equal(result, "a,b,c");
+  });
+});

package/test/runtime/fixtures/foo.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export default () => "bar";

package/test/runtime/fixtures/makeTest/a ADDED Viewed

	@@ -0,0 +1 @@
1	+ Hello, world.

package/test/runtime/fixtures/makeTest/b = a ADDED Viewed

File without changes

package/test/runtime/fixtures/metagraphs/foo.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ Foo

package/test/runtime/fixtures/metagraphs/greeting = this('world').js ADDED Viewed

@@ -0,0 +1,3 @@
+export default function (name) {
+  return `Hello, ${name}.`;
+}

package/test/runtime/fixtures/metagraphs/obj = this.json ADDED Viewed

@@ -0,0 +1,5 @@
+{
+  "a": "Hello, a.",
+  "b": "Hello, b.",
+  "c": "Hello, c."
+}

package/test/runtime/fixtures/metagraphs/sample.txt = this().js ADDED Viewed

@@ -0,0 +1,3 @@
+export default function () {
+  return "Hello, world.";
+}

package/test/runtime/fixtures/metagraphs/string = this.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ "Hello, world."

package/test/runtime/fixtures/metagraphs/value = fn() ADDED Viewed

File without changes

package/test/runtime/fixtures/programs/context.yaml ADDED Viewed

@@ -0,0 +1,4 @@
+title: Reference the special context key
+# This will pull in the value of "obj.yaml" from the result tree.
+obj = context 'obj.yaml':

package/test/runtime/fixtures/programs/files.yaml ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ title: Files demonstration
2	+ files = keys context():

package/test/runtime/fixtures/programs/obj.yaml ADDED Viewed

@@ -0,0 +1,3 @@
+a: Hello, a.
+b: Hello, b.
+c: Hello, c.

package/test/runtime/fixtures/programs/simple.yaml ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ a = b: ""
2	+ b: Hello, world.

package/test/runtime/fixtures/subgraph = this.js ADDED Viewed

@@ -0,0 +1,5 @@
+import { ObjectTree } from "@weborigami/async-tree";
+export default new ObjectTree({
+  a: "Hello, a.",
+  b: "Hello, b.",
+});

package/test/runtime/fixtures/templates/greet.orit ADDED Viewed

@@ -0,0 +1,4 @@
+Greetings:
+{{ @map(=`Hello, {{ _ }}.
+`)(names.yaml) }}

package/test/runtime/fixtures/templates/index.orit ADDED Viewed

@@ -0,0 +1,15 @@
+---
+title: Greetings
+message: !ori title
+---
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width,initial-scale=1" />
+    <title>{{ title }}</title>
+  </head>
+  <body>
+    {{ message }}
+  </body>
+</html>

package/test/runtime/fixtures/templates/names.yaml ADDED Viewed

@@ -0,0 +1,3 @@
+- Alice
+- Bob
+- Carol

package/test/runtime/fixtures/templates/plain.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ Hello, world.

package/test/runtime/fixtures/virtualKeys/.keys.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ ["a", "b", "c"]

package/test/runtime/format.test.js ADDED Viewed

@@ -0,0 +1,66 @@
+import assert from "node:assert";
+import { describe, test } from "node:test";
+import format from "../../src/runtime/format.js";
+import * as ops from "../../src/runtime/ops.js";
+describe("Origami language code formatter", () => {
+  test("assignment", () => {
+    const code = [ops.assign, "foo", [ops.scope, "bar"]];
+    assert.equal(format(code), "foo = bar");
+  });
+  test("scope reference", () => {
+    const code = [ops.scope, "foo"];
+    assert.equal(format(code), "foo");
+  });
+  test("implicit function call", () => {
+    const code = [ops.scope, "foo"];
+    assert.equal(format(code, true), "foo()");
+  });
+  test("function call", () => {
+    const code = [[ops.scope, "foo"], undefined];
+    assert.equal(format(code, true), "foo()");
+  });
+  test("tree traversal with string args", () => {
+    const code = [[ops.scope, "a"], "b", "c"];
+    assert.equal(format(code), "a/b/c");
+  });
+  test("tree traversal with numeric and string args", () => {
+    const code = [ops.scope, "fn", "x", 1, 2];
+    assert.equal(format(code), "fn('x', 1, 2)");
+  });
+  test("tree traversal with function arg and string arg", () => {
+    const code = [ops.scope, "fn", [ops.scope, "foo"], "bar"];
+    assert.equal(format(code), "fn(foo, 'bar')");
+  });
+  test("function composition", () => {
+    const code = [[[ops.scope, "fn"], "a"], "b"];
+    assert.equal(format(code), "(fn/a)/b");
+  });
+  test("lambda", () => {
+    const code = [ops.lambda, [ops.scope, "message"]];
+    assert.equal(format(code), "=message");
+  });
+  test("object", () => {
+    const code = [ops.object, ["a", "Hello"], ["b", "Goodbye"]];
+    assert.equal(format(code), "{ a: 'Hello', b: 'Goodbye' }");
+  });
+  test("template", () => {
+    const code = [ops.concat, "Hello, ", [ops.scope, "name"], "."];
+    assert.equal(format(code), "`Hello, {{name}}.`");
+  });
+  test("tree", () => {
+    const code = [ops.tree, ["x", [[ops.scope, "fn"], undefined]]];
+    assert.equal(format(code), "{ x = fn() }");
+  });
+});

package/test/runtime/functionResultsMap.test.js ADDED Viewed

@@ -0,0 +1,27 @@
+import { Tree } from "@weborigami/async-tree";
+import assert from "node:assert";
+import { describe, test } from "node:test";
+import Scope from "../../src/runtime/Scope.js";
+import functionResultsMap from "../../src/runtime/functionResultsMap.js";
+describe("functionResultsMap", () => {
+  test("get() invokes functions using scope, returns other values as is", async () => {
+    const scope = {
+      message: "Hello",
+    };
+    const tree = Scope.treeWithScope(
+      {
+        fn: /** @this {import("@weborigami/types").AsyncTree} */ function () {
+          return this.get("message");
+        },
+        string: "string",
+      },
+      scope
+    );
+    const fixture = functionResultsMap(tree);
+    assert.deepEqual(await Tree.plain(fixture), {
+      fn: "Hello",
+      string: "string",
+    });
+  });
+});

package/test/runtime/ops.test.js ADDED Viewed

@@ -0,0 +1,111 @@
+import { ObjectTree, Tree } from "@weborigami/async-tree";
+import assert from "node:assert";
+import { describe, test } from "node:test";
+import Scope from "../../src/runtime/Scope.js";
+import {
+  OrigamiTree,
+  evaluate,
+  expressionFunction,
+  ops,
+} from "../../src/runtime/internal.js";
+describe("ops", () => {
+  test("can resolve substitutions in a template literal", async () => {
+    const scope = new ObjectTree({
+      name: "world",
+    });
+    const code = [ops.concat, "Hello, ", [ops.scope, "name"], "."];
+    const result = await evaluate.call(scope, code);
+    assert.equal(result, "Hello, world.");
+  });
+  test("can invoke a lambda", async () => {
+    const scope = new ObjectTree({
+      message: "Hello",
+    });
+    const code = [ops.lambda, [ops.scope, "message"]];
+    const fn = await evaluate.call(scope, code);
+    const result = await fn.call(scope);
+    assert.equal(result, "Hello");
+  });
+  test("lambda adds input to scope as `_`", async () => {
+    const code = [ops.lambda, [ops.scope, "_"]];
+    const fn = await evaluate.call(null, code);
+    const result = await fn("Hello");
+    assert.equal(result, "Hello");
+  });
+  test("a lambda can reference itself with @recurse", async () => {
+    const code = [ops.lambda, [ops.scope, "@recurse"]];
+    const fn = await evaluate.call(null, code);
+    const result = await fn();
+    assert.equal(result, fn);
+  });
+  test("can instantiate an object", async () => {
+    const scope = new ObjectTree({
+      upper: (s) => s.toUpperCase(),
+    });
+    const code = [
+      ops.object,
+      ["hello", [[ops.scope, "upper"], "hello"]],
+      ["world", [[ops.scope, "upper"], "world"]],
+    ];
+    const result = await evaluate.call(scope, code);
+    assert.equal(result.hello, "HELLO");
+    assert.equal(result.world, "WORLD");
+  });
+  test("can instantiate an array", async () => {
+    const scope = new ObjectTree({
+      upper: (s) => s.toUpperCase(),
+    });
+    const code = [ops.array, "Hello", 1, [[ops.scope, "upper"], "world"]];
+    const result = await evaluate.call(scope, code);
+    assert.deepEqual(result, ["Hello", 1, "WORLD"]);
+  });
+  test("can instantiate an Origami tree", async () => {
+    const code = [
+      ops.tree,
+      ["name", "world"],
+      [
+        "message",
+        expressionFunction.createExpressionFunction([
+          ops.concat,
+          "Hello, ",
+          [ops.scope, "name"],
+          "!",
+        ]),
+      ],
+    ];
+    const result = await evaluate.call({}, code);
+    assert(result instanceof OrigamiTree);
+    assert.deepEqual(await Tree.plain(result), {
+      name: "world",
+      message: "Hello, world!",
+    });
+  });
+  test("can search inherited scope", async () => {
+    const a = new ObjectTree({
+      a: 1, // This is the inherited value we want
+    });
+    /** @type {any} */
+    const b = new ObjectTree({
+      a: 2, // Should be ignored
+    });
+    b.scope = new Scope(b, a);
+    const code = [ops.inherited, "a"];
+    const result = await evaluate.call(b.scope, code);
+    assert.equal(result, 1);
+  });
+});