gr-base/doc/vocabulary.org
2025-08-14 15:31:42 +07:00

2.4 KiB

Grimu-R vocabulary

Weave

Defines a collection of ornaments.

Ornament

Has reactive inputs and outputs. Serves as an externally invocable entry point. Contains spells or nested ornament instances connected by stitches. Can be distributed within an edition.

Spell

Has reactive inputs and outputs. Atomic execution unit. Cannot be directly invoked by an edition consumer. May have an inscription. Created from a scroll and executed in the shelf environment.

Stitch

Connects a reactive input to a compatible reactive output. Can be decorated on both upstream and downstream ends. May be parameterized by a reactive input, consuming variable assignments for the decoration.

Stitch decorator

Defines reactive behavior. May refer to variables defined by the reactive input.

Inscription

Defines code in a scripting language to be run when the corresponding spell is executed. May be defined statically in the weave or considered a reactive input.

Scroll

Defines source code, its build dependencies and runtime environment. Provides a default spell configuration. Provides default upstream/downstream stitch decorators for outputs/inputs respectively. Declares runtime compatibility (browser-only, non-browser, or universal).

Shelf

Contains a collection of scrolls. Provisions a shared runtime environment for spells based on these scrolls.

Edition

Represents (a part of) the weave as a grimoire, a servitor, or a consistent collection of these.

Grimoire

Presents a subweave as a program with human-facing interface. Uses bridge spells to communicate with servitor-side ornaments within the same edition. Has a dedicated interface ornament (entry point).

Servitor

Presents a subweave as a local/remote daemon's/server's endpoints/methods.

Loom

Provisions tools for interactive or programmatic weaving.