@rcrsr/rill 0.9.0 → 0.11.0

package/dist/signature-parser.js

@@ -0,0 +1,289 @@
+/**
+ * Signature Parser
+ *
+ * Parses annotated rill closure type signature strings at registration time.
+ * This module bridges the lexer/parser boundary so that runtime/core/context.ts
+ * can parse signatures without importing from parser/* or lexer/* directly.
+ *
+ * Import boundary note (§NOD.2.1):
+ * - This file lives at src/ level (not in runtime/), so it may import from
+ *   both lexer and parser barrels.
+ * - runtime/core/context.ts imports from this file (../../signature-parser.js),
+ *   which is NOT in parser/* or lexer/* — boundary preserved.
+ */
+import { tokenize } from './lexer/index.js';
+import { ParseError, TOKEN_TYPES } from './types.js';
+import { createParserState, advance, check, current, expect, skipNewlines, isAtEnd, parseTypeRef, } from './parser/index.js';
+// ============================================================
+// TypeRef → RillType static conversion
+// ============================================================
+/**
+ * Convert a static TypeRef to a RillType.
+ *
+ * Only handles static refs (type names and unions). Dynamic refs ($var)
+ * are not valid in registration-time signatures — they throw Error.
+ *
+ * @internal
+ */
+function staticTypeRefToRillType(typeRef, functionName) {
+    if (typeRef.kind === 'dynamic') {
+        throw new Error(`Invalid signature for function '${functionName}': dynamic type references ($variable) are not allowed in signatures`);
+    }
+    if (typeRef.kind === 'union') {
+        return {
+            type: 'union',
+            members: typeRef.members.map((m) => staticTypeRefToRillType(m, functionName)),
+        };
+    }
+    // static kind
+    const { typeName, args } = typeRef;
+    if (!args || args.length === 0) {
+        return { type: typeName };
+    }
+    // Parameterized types
+    if (typeName === 'list') {
+        if (args.length === 1 &&
+            args[0] !== undefined &&
+            args[0].name === undefined) {
+            const element = staticTypeRefToRillType(args[0].ref, functionName);
+            return { type: 'list', element };
+        }
+        throw new Error(`Invalid signature for function '${functionName}': list requires exactly one positional type argument`);
+    }
+    if (typeName === 'dict') {
+        const fields = {};
+        for (const arg of args) {
+            if (arg.name === undefined) {
+                throw new Error(`Invalid signature for function '${functionName}': dict type arguments must be named (e.g. dict(key: string))`);
+            }
+            fields[arg.name] = staticTypeRefToRillType(arg.ref, functionName);
+        }
+        return { type: 'dict', fields };
+    }
+    if (typeName === 'tuple') {
+        const elements = args.map((arg) => staticTypeRefToRillType(arg.ref, functionName));
+        return { type: 'tuple', elements };
+    }
+    throw new Error(`Invalid signature for function '${functionName}': type '${typeName}' does not accept type arguments`);
+}
+// ============================================================
+// Annotation parsing
+// ============================================================
+/**
+ * Extract a string literal value from the current token position.
+ * Only string literals are valid as annotation values in signatures.
+ *
+ * @internal
+ */
+function extractAnnotationStringValue(state, functionName) {
+    if (!check(state, TOKEN_TYPES.STRING)) {
+        throw new Error(`Invalid signature for function '${functionName}': annotation values must be string literals`);
+    }
+    const tok = advance(state);
+    return tok.value;
+}
+/**
+ * Parse annotation args: `key: "value", ...` inside `^(...)`.
+ * Returns a record of annotation key-value pairs.
+ * Only string literal values are supported in signatures.
+ *
+ * @internal
+ */
+function parseSignatureAnnotations(state, functionName) {
+    const annotations = {};
+    while (!check(state, TOKEN_TYPES.RPAREN) && !isAtEnd(state)) {
+        // Support bare string shorthand: "description text" → description: "description text"
+        if (check(state, TOKEN_TYPES.STRING)) {
+            const tok = advance(state);
+            annotations['description'] = tok.value;
+        }
+        else {
+            // Named arg: key: "value"
+            const nameToken = expect(state, TOKEN_TYPES.IDENTIFIER, `Expected annotation key in function '${functionName}'`);
+            expect(state, TOKEN_TYPES.COLON, `Expected ':' after annotation key in function '${functionName}'`);
+            const value = extractAnnotationStringValue(state, functionName);
+            annotations[nameToken.value] = value;
+        }
+        if (check(state, TOKEN_TYPES.COMMA)) {
+            advance(state); // consume comma
+        }
+    }
+    return annotations;
+}
+/**
+ * Parse a rill closure type signature string into structured parameter declarations.
+ *
+ * Signature format (optional closure-level annotation before param list):
+ * ```
+ * ^(description: "...") |^(description: "...") x: string = "default", y: number|:string
+ * ```
+ * The return type follows `:type` directly after the closing `|`.
+ *
+ * Throws Error with message `Invalid signature for function '{name}': {parse error}`
+ * on any parse failure (EC-8, EC-9).
+ *
+ * @param signature - The signature string to parse
+ * @param functionName - The function name (for error messages)
+ * @returns Parsed params, return type, and description
+ *
+ * @internal
+ */
+export function parseSignatureRegistration(signature, functionName) {
+    let tokens;
+    try {
+        tokens = tokenize(signature);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Invalid signature for function '${functionName}': ${message}`, { cause: err });
+    }
+    // Filter out newlines and comments for cleaner parsing
+    const filtered = tokens.filter((t) => t.type !== TOKEN_TYPES.NEWLINE && t.type !== TOKEN_TYPES.COMMENT);
+    const state = createParserState(filtered, { recoveryMode: false });
+    try {
+        return parseSignatureBody(state, functionName);
+    }
+    catch (err) {
+        if (err instanceof ParseError) {
+            throw new Error(`Invalid signature for function '${functionName}': ${err.message}`, { cause: err });
+        }
+        // Re-throw registration errors (already have proper message format)
+        throw err;
+    }
+}
+/**
+ * Parse the body of the signature string given a parser state.
+ *
+ * @internal
+ */
+function parseSignatureBody(state, functionName) {
+    // Step 1: Optional closure-level annotation ^(...)
+    let description = undefined;
+    if (check(state, TOKEN_TYPES.CARET)) {
+        advance(state); // consume ^
+        expect(state, TOKEN_TYPES.LPAREN, `Expected '(' after '^' in signature for function '${functionName}'`);
+        const annots = parseSignatureAnnotations(state, functionName);
+        expect(state, TOKEN_TYPES.RPAREN, `Expected ')' to close annotation in signature for function '${functionName}'`);
+        description = annots['description'];
+        skipNewlines(state);
+    }
+    // Step 2: Param list between | ... | (or || for zero params)
+    const params = [];
+    if (check(state, TOKEN_TYPES.OR)) {
+        // || — zero params
+        advance(state);
+    }
+    else if (check(state, TOKEN_TYPES.PIPE_BAR)) {
+        advance(state); // consume opening |
+        skipNewlines(state);
+        // Parse params until closing |
+        while (!check(state, TOKEN_TYPES.PIPE_BAR) && !isAtEnd(state)) {
+            const param = parseSignatureParam(state, functionName);
+            params.push(param);
+            if (check(state, TOKEN_TYPES.COMMA)) {
+                advance(state);
+                skipNewlines(state);
+            }
+        }
+        if (!check(state, TOKEN_TYPES.PIPE_BAR)) {
+            throw new Error(`Invalid signature for function '${functionName}': expected '|' to close parameter list`);
+        }
+        advance(state); // consume closing |
+    }
+    else {
+        throw new Error(`Invalid signature for function '${functionName}': expected '|' or '||' to start parameter list`);
+    }
+    skipNewlines(state);
+    // Step 3: Optional return type :type
+    let returnType = undefined;
+    if (check(state, TOKEN_TYPES.COLON)) {
+        advance(state); // consume :
+        skipNewlines(state);
+        const typeRef = parseTypeRef(state);
+        returnType = staticTypeRefToRillType(typeRef, functionName);
+    }
+    // Step 5: Verify no trailing tokens
+    if (!isAtEnd(state)) {
+        const tok = current(state);
+        throw new Error(`Invalid signature for function '${functionName}': unexpected token '${tok.value}' after signature`);
+    }
+    return { params, returnType, description };
+}
+/**
+ * Parse a single parameter from a signature param list.
+ *
+ * Grammar: `^(annots) name : type = literal`
+ *
+ * @internal
+ */
+function parseSignatureParam(state, functionName) {
+    // Optional param-level annotation ^(...)
+    const annotations = {};
+    if (check(state, TOKEN_TYPES.CARET)) {
+        advance(state); // consume ^
+        expect(state, TOKEN_TYPES.LPAREN, `Expected '(' after '^' in parameter annotation for function '${functionName}'`);
+        const annots = parseSignatureAnnotations(state, functionName);
+        expect(state, TOKEN_TYPES.RPAREN, `Expected ')' to close parameter annotation for function '${functionName}'`);
+        // Store annotation values as strings in annotations record
+        for (const [key, value] of Object.entries(annots)) {
+            annotations[key] = value;
+        }
+    }
+    // Param name
+    const nameToken = expect(state, TOKEN_TYPES.IDENTIFIER, `Expected parameter name in signature for function '${functionName}'`);
+    const name = nameToken.value;
+    // Optional type annotation : type
+    let type = undefined;
+    skipNewlines(state);
+    if (check(state, TOKEN_TYPES.COLON)) {
+        advance(state); // consume :
+        skipNewlines(state);
+        const typeRef = parseTypeRef(state, { allowTrailingPipe: true });
+        type = staticTypeRefToRillType(typeRef, functionName);
+    }
+    // Optional default value = literal
+    let defaultValue = undefined;
+    skipNewlines(state);
+    if (check(state, TOKEN_TYPES.ASSIGN)) {
+        advance(state); // consume =
+        skipNewlines(state);
+        defaultValue = parseSignatureLiteral(state, functionName);
+    }
+    return { name, type, defaultValue, annotations };
+}
+/**
+ * Parse a simple literal value for a default parameter value.
+ * Supported: string, number, bool (true/false), negative number.
+ *
+ * @internal
+ */
+function parseSignatureLiteral(state, functionName) {
+    if (check(state, TOKEN_TYPES.STRING)) {
+        const tok = advance(state);
+        return tok.value;
+    }
+    if (check(state, TOKEN_TYPES.NUMBER)) {
+        const tok = advance(state);
+        return parseFloat(tok.value);
+    }
+    if (check(state, TOKEN_TYPES.TRUE)) {
+        advance(state);
+        return true;
+    }
+    if (check(state, TOKEN_TYPES.FALSE)) {
+        advance(state);
+        return false;
+    }
+    // Negative number: - NUMBER
+    if (check(state, TOKEN_TYPES.MINUS)) {
+        advance(state); // consume -
+        if (check(state, TOKEN_TYPES.NUMBER)) {
+            const tok = advance(state);
+            return -parseFloat(tok.value);
+        }
+        throw new Error(`Invalid signature for function '${functionName}': expected number after '-' in default value`);
+    }
+    const tok = current(state);
+    throw new Error(`Invalid signature for function '${functionName}': unsupported default value '${tok.value}' (only string, number, bool supported)`);
+}
+//# sourceMappingURL=signature-parser.js.map

package/dist/signature-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature-parser.js","sourceRoot":"","sources":["../src/signature-parser.ts"],"names":[],"mappings":"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"}

package/dist/token-types.d.ts

@@ -49,6 +49,7 @@ export declare const TOKEN_TYPES: {
     readonly ORDERED_LBRACKET: "ORDERED_LBRACKET";
     readonly DESTRUCT_LANGLE: "DESTRUCT_LANGLE";
     readonly SLICE_LANGLE: "SLICE_LANGLE";
+    readonly USE_LANGLE: "USE_LANGLE";
     readonly CONVERT: "CONVERT";
     readonly BREAK: "BREAK";
     readonly RETURN: "RETURN";

package/dist/token-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-types.d.ts","sourceRoot":"","sources":["../src/token-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiGd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B"}
+{"version":3,"file":"token-types.d.ts","sourceRoot":"","sources":["../src/token-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAMvD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkGd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEvE,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B"}

package/dist/token-types.js

@@ -64,6 +64,7 @@ export const TOKEN_TYPES = {
     ORDERED_LBRACKET: 'ORDERED_LBRACKET', // ordered[
     DESTRUCT_LANGLE: 'DESTRUCT_LANGLE', // destruct<
     SLICE_LANGLE: 'SLICE_LANGLE', // slice<
+    USE_LANGLE: 'USE_LANGLE', // use<
     // Type conversion operator
     CONVERT: 'CONVERT', // :>
     // Keywords

package/dist/token-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"token-types.js","sourceRoot":"","sources":["../src/token-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"token-types.js","sourceRoot":"","sources":["../src/token-types.ts"],"names":[],"mappings":"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"}

package/dist/value-types.d.ts

@@ -1,21 +1,35 @@
+import { VALID_TYPE_NAMES } from './constants.js';
 /** Rill type names for type annotations */
-export type RillTypeName = 'string' | 'number' | 'bool' | 'closure' | 'list' | 'dict' | 'tuple' | 'ordered' | 'vector' | 'any' | 'type';
+export type RillTypeName = (typeof VALID_TYPE_NAMES)[number];
 /**
- * A reference to a type — either a static type name literal or a dynamic
- * variable holding a type value at runtime.
+ * A reference to a type — either a static type name literal, a dynamic
+ * variable holding a type value at runtime, or a union of multiple type refs.
  *
- * - `static`: a known RillTypeName literal (e.g. `string`, `number`)
+ * - `static`: a known RillTypeName literal (e.g. `string`, `number`), optionally
+ *   parameterized with `args` (e.g. `list(string)`, `dict(key: string)`)
  * - `dynamic`: a variable name whose runtime value provides the type
+ * - `union`: two or more type refs (flattened at parse time; no nested unions)
+ *   Members preserve source order. `members.length >= 2`.
  */
 export type TypeRef = {
     kind: 'static';
     typeName: RillTypeName;
+    args?: TypeRefArg[];
 } | {
     kind: 'dynamic';
     varName: string;
+} | {
+    kind: 'union';
+    members: TypeRef[];
 };
 /**
- * Return type declaration for host-provided and script functions.
+ * A single argument in a parameterized type reference.
+ *
+ * - Named form:    `field: string` → `{ name: 'field', ref: { kind: 'static', typeName: 'string' } }`
+ * - Positional form: `string`     → `{ ref: { kind: 'static', typeName: 'string' } }`
  */
-export type RillFunctionReturnType = RillTypeName;
+export interface TypeRefArg {
+    name?: string;
+    ref: TypeRef;
+}
 //# sourceMappingURL=value-types.d.ts.map

package/dist/value-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-types.d.ts","sourceRoot":"","sources":["../src/value-types.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,QAAQ,GACR,KAAK,GACL,MAAM,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,YAAY,CAAC"}
+{"version":3,"file":"value-types.d.ts","sourceRoot":"","sources":["../src/value-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd"}

package/dist/value-types.js

@@ -1,2 +1,2 @@
-export {};
+import { VALID_TYPE_NAMES } from './constants.js';
 //# sourceMappingURL=value-types.js.map

package/dist/value-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"value-types.js","sourceRoot":"","sources":["../src/value-types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"value-types.js","sourceRoot":"","sources":["../src/value-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Scripting designed for machine-generated code",
   "license": "MIT",
   "author": "Andre Bremer",
@@ -54,6 +54,9 @@
   "bugs": {
     "url": "https://github.com/rcrsr/rill/issues"
   },
+  "engines": {
+    "node": ">=20.0.0"
+  },
   "publishConfig": {
     "access": "public"
   },