Re-organize stdlib into tools, runtime utils, builtins and prelude

Document runtime types.

ref #146

src/__tests__/parser/source.spec.ts

@@ -8,7 +8,7 @@ import {
 import {TimeMonzo} from '../../monzo';
 import {Interval} from '../../interval';
 import {RootContext} from '../../context';
-import {relative} from '../../builtin';
+import {relative} from '../../stdlib';
 
 function parseSource(source: string) {
   const visitor = evaluateSource(source, false);

src/__tests__/parser/stdlib.spec.ts

@@ -7,7 +7,7 @@ import {
   parseAST,
 } from '../../parser';
 import {Interval} from '../../interval';
-import {builtinNode, track} from '../../builtin';
+import {builtinNode, track} from '../../stdlib';
 
 function parseSource(source: string) {
   const visitor = evaluateSource(source);

src/__tests__/builtin.spec.ts → src/__tests__/tools.spec.ts

@@ -1,5 +1,5 @@
 import {describe, it, expect} from 'vitest';
-import {hasConstantStructure, subtensions} from '../builtin';
+import {hasConstantStructure, subtensions} from '../tools';
 import {TimeMonzo} from '../monzo';
 
 describe('Constant structure checker', () => {

src/cli.ts

@@ -1,5 +1,5 @@
 /* eslint-disable @typescript-eslint/no-unused-vars */
-import {relative} from './builtin';
+import {relative, repr} from './stdlib';
 import {Interval} from './interval';
 import {
   ExpressionVisitor,
@@ -8,7 +8,6 @@ import {
   getSourceVisitor,
   parseAST,
 } from './parser';
-import {repr} from './builtin';
 import type {REPLServer, ReplOptions} from 'repl';
 import type {Context} from 'node:vm';
 import {parse as parenCounter} from './paren-counter';

src/context.ts

@@ -1,4 +1,4 @@
-import {SonicWeaveValue} from './builtin';
+import {SonicWeaveValue} from './stdlib';
 import {Val, type Interval} from './interval';
 import {TimeMonzo} from './monzo';
 import {ZERO} from './utils';

src/index.ts

@@ -1,5 +1,5 @@
 export * from './ast';
-export * from './builtin';
+export * from './stdlib';
 export * from './chord-parser';
 export * from './cli';
 export * from './context';
@@ -19,6 +19,7 @@ export {
   type Nominal,
   type AbsolutePitch,
 } from './pythagorean';
+export * from './tools';
 export * from './utils';
 export * from './warts';
 export * from './words';

src/parser.ts

@@ -48,7 +48,7 @@ import {
   upcastBool,
   SonicWeavePrimitive,
   sort,
-} from './builtin';
+} from './stdlib';
 import {
   bigGcd,
   metricExponent,