@rcrsr/rill 0.7.2 → 0.8.0

package/dist/runtime/ext/extensions.js

@@ -1,4 +1,3 @@
-import { RuntimeError } from '../../types.js';
 /**
  * Prefix all function names in an extension with a namespace.
  *
@@ -15,10 +14,16 @@ import { RuntimeError } from '../../types.js';
  * ```
  */
 export function prefixFunctions(namespace, functions) {
-    // Validate namespace pattern: non-empty alphanumeric with underscores/hyphens
+    // EC-7: Extension not object
+    if (typeof functions !== 'object' ||
+        functions === null ||
+        Array.isArray(functions)) {
+        throw new TypeError('Extension must be an object');
+    }
+    // EC-6: Invalid namespace format
     const NAMESPACE_PATTERN = /^[a-zA-Z0-9_-]+$/;
     if (!NAMESPACE_PATTERN.test(namespace)) {
-        throw new RuntimeError('RILL-R004', `Invalid namespace: must be non-empty alphanumeric with underscores or hyphens, got "${namespace}"`);
+        throw new Error('Invalid namespace format: must match /^[a-zA-Z0-9_-]+$/');
     }
     // Create new object with prefixed keys
     const result = {};
@@ -35,12 +40,59 @@ export function prefixFunctions(namespace, functions) {
     }
     return resultWithDispose;
 }
+/**
+ * Separate dispose from functions for safe createRuntimeContext usage.
+ * Wraps prefixFunctions and returns separated structure.
+ *
+ * @param namespace - String matching /^[a-zA-Z0-9_-]+$/
+ * @param extension - Output from extension factory
+ * @returns Separated functions and dispose handler
+ * @throws {Error} If namespace is empty
+ * @throws {Error} If namespace has invalid format
+ * @throws {TypeError} If extension is null or undefined
+ *
+ * @example
+ * ```typescript
+ * const { functions, dispose } = hoistExtension('db', dbExtension);
+ * const ctx = createRuntimeContext({ functions });
+ * ```
+ */
+export function hoistExtension(namespace, extension) {
+    // EC-3: Null/undefined extension
+    if (extension === null || extension === undefined) {
+        throw new TypeError('Extension cannot be null or undefined');
+    }
+    // EC-2: Empty namespace
+    if (namespace === '') {
+        throw new Error('Namespace cannot be empty');
+    }
+    // EC-1: Invalid namespace format
+    const NAMESPACE_PATTERN = /^[a-zA-Z0-9_-]+$/;
+    if (!NAMESPACE_PATTERN.test(namespace)) {
+        throw new Error('Invalid namespace format: must match /^[a-zA-Z0-9_-]+$/');
+    }
+    // Call prefixFunctions internally
+    const prefixed = prefixFunctions(namespace, extension);
+    // Extract dispose from result
+    const { dispose, ...functions } = prefixed;
+    // Return separated structure
+    const result = {
+        functions: functions,
+    };
+    // Only add dispose if it exists (exactOptionalPropertyTypes)
+    if (dispose !== undefined) {
+        result.dispose = dispose;
+    }
+    return result;
+}
 /**
  * Emit an extension event with auto-generated timestamp.
  * Adds ISO timestamp if event.timestamp is undefined, then calls onLogEvent callback.
  *
- * @param ctx - Runtime context containing callbacks
+ * @param ctx - Runtime context or context-like object containing callbacks
  * @param event - Extension event (timestamp auto-added if omitted)
+ * @throws {TypeError} If ctx is null or undefined
+ * @throws {Error} If event.event is missing or empty
  *
  * @example
  * ```typescript
@@ -53,14 +105,27 @@ export function prefixFunctions(namespace, functions) {
  * ```
  */
 export function emitExtensionEvent(ctx, event) {
-    // Call callback if defined
-    if (ctx.callbacks.onLogEvent !== undefined) {
-        // Auto-add timestamp if not present
-        const eventWithTimestamp = {
-            ...event,
-            timestamp: event.timestamp ?? new Date().toISOString(),
-        };
-        ctx.callbacks.onLogEvent(eventWithTimestamp);
+    // EC-4: Null/undefined context
+    if (ctx === null || ctx === undefined) {
+        throw new TypeError('Context cannot be null or undefined');
+    }
+    // EC-5: Missing/empty event.event field
+    if (!event['event'] ||
+        typeof event['event'] !== 'string' ||
+        event['event'].trim() === '') {
+        throw new Error('Event must include non-empty event field');
+    }
+    // IC-2: Guard for callbacks property (graceful degradation)
+    if ('callbacks' in ctx && ctx.callbacks) {
+        // Call callback if defined
+        if (ctx.callbacks.onLogEvent !== undefined) {
+            // Auto-add timestamp if not present
+            const eventWithTimestamp = {
+                ...event,
+                timestamp: event.timestamp ?? new Date().toISOString(),
+            };
+            ctx.callbacks.onLogEvent(eventWithTimestamp);
+        }
     }
 }
 //# sourceMappingURL=extensions.js.map

package/dist/runtime/ext/extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../src/runtime/ext/extensions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAgB9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,SAA0B;IAE1B,8EAA8E;IAC9E,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;IAE7C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,YAAY,CACpB,WAAW,EACX,uFAAuF,SAAS,GAAG,CACpG,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3D,2CAA2C;QAC3C,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QAEjC,MAAM,CAAC,GAAG,SAAS,KAAK,IAAI,EAAE,CAAC,GAAG,UAAoC,CAAC;IACzE,CAAC;IAED,qCAAqC;IACrC,MAAM,iBAAiB,GAAoB,MAAM,CAAC;IAClD,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACpC,iBAAiB,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;IAChD,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAmB,EACnB,KAA6E;IAE7E,2BAA2B;IAC3B,IAAI,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3C,oCAAoC;QACpC,MAAM,kBAAkB,GAAG;YACzB,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACpB,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../../src/runtime/ext/extensions.ts"],"names":[],"mappings":"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"}

package/dist/runtime/index.d.ts

@@ -17,14 +17,14 @@
  *   - builtins.ts: Built-in functions and methods
  */
 export type { CaptureEvent, ErrorEvent, ExecutionResult, ExecutionStepper, HostCallEvent, FunctionReturnEvent, ObservabilityCallbacks, RuntimeCallbacks, RuntimeContext, RuntimeOptions, StepEndEvent, StepResult, StepStartEvent, } from './core/types.js';
-export type { ApplicationCallable, CallableFn, HostFunctionDefinition, HostFunctionParam, RillCallable, RillFunctionReturnType, RuntimeCallable, ScriptCallable, } from './core/callable.js';
+export type { ApplicationCallable, CallableFn, CallableParam, HostFunctionDefinition, HostFunctionParam, RillCallable, RillFunctionReturnType, RuntimeCallable, ScriptCallable, } from './core/callable.js';
 export { callable, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, validateHostFunctionArgs, validateReturnType, } from './core/callable.js';
-export type { RillTuple, RillValue } from './core/values.js';
-export { isTuple, isReservedMethod, RESERVED_DICT_METHODS, } from './core/values.js';
+export type { RillIterator, RillTuple, RillValue, RillVector, } from './core/values.js';
+export { createVector, isRillIterator, isTuple, isVector, isReservedMethod, RESERVED_DICT_METHODS, } from './core/values.js';
 export { BreakSignal, ReturnSignal } from './core/signals.js';
 export type { ExtensionEvent } from './core/types.js';
-export type { ExtensionFactory, ExtensionResult } from './ext/extensions.js';
-export { prefixFunctions, emitExtensionEvent } from './ext/extensions.js';
+export type { ExtensionFactory, ExtensionResult, HoistedExtension, } from './ext/extensions.js';
+export { prefixFunctions, emitExtensionEvent, hoistExtension, } from './ext/extensions.js';
 export { createRuntimeContext } from './core/context.js';
 export type { CallFrame } from '../types.js';
 export { getCallStack, pushCallFrame, popCallFrame } from './core/context.js';

package/dist/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,YAAY,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAM5B,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM9D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAMzD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM9E,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM3D,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,YAAY,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,iBAAiB,CAAC;AAMzB,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAM5B,YAAY,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM9D,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAMzD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAM9E,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM3D,YAAY,EACV,2BAA2B,EAC3B,gBAAgB,EAChB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/runtime/index.js

@@ -17,12 +17,12 @@
  *   - builtins.ts: Built-in functions and methods
  */
 export { callable, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, validateHostFunctionArgs, validateReturnType, } from './core/callable.js';
-export { isTuple, isReservedMethod, RESERVED_DICT_METHODS, } from './core/values.js';
+export { createVector, isRillIterator, isTuple, isVector, isReservedMethod, RESERVED_DICT_METHODS, } from './core/values.js';
 // ============================================================
 // CONTROL FLOW SIGNALS
 // ============================================================
 export { BreakSignal, ReturnSignal } from './core/signals.js';
-export { prefixFunctions, emitExtensionEvent } from './ext/extensions.js';
+export { prefixFunctions, emitExtensionEvent, hoistExtension, } from './ext/extensions.js';
 // ============================================================
 // CONTEXT FACTORY
 // ============================================================

package/dist/runtime/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqCH,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,+DAA+D;AAC/D,uBAAuB;AACvB,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAU9D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQzD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9E,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAY3D,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAsCH,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAa5B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,OAAO,EACP,QAAQ,EACR,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,+DAA+D;AAC/D,uBAAuB;AACvB,+DAA+D;AAE/D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAc9D,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D;AAE/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQzD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE9E,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAY3D,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/source-location.d.ts

@@ -0,0 +1,10 @@
+export interface SourceLocation {
+    readonly line: number;
+    readonly column: number;
+    readonly offset: number;
+}
+export interface SourceSpan {
+    readonly start: SourceLocation;
+    readonly end: SourceLocation;
+}
+//# sourceMappingURL=source-location.d.ts.map

package/dist/source-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.d.ts","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;CAC9B"}

package/dist/source-location.js

@@ -0,0 +1,5 @@
+// ============================================================
+// SOURCE LOCATION
+// ============================================================
+export {};
+//# sourceMappingURL=source-location.js.map

package/dist/source-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-location.js","sourceRoot":"","sources":["../src/source-location.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kBAAkB;AAClB,+DAA+D"}

package/dist/token-types.d.ts

@@ -0,0 +1,68 @@
+import type { SourceSpan } from './source-location.js';
+export declare const TOKEN_TYPES: {
+    readonly STRING: "STRING";
+    readonly NUMBER: "NUMBER";
+    readonly TRUE: "TRUE";
+    readonly FALSE: "FALSE";
+    readonly IDENTIFIER: "IDENTIFIER";
+    readonly DOLLAR: "DOLLAR";
+    readonly PIPE_VAR: "PIPE_VAR";
+    readonly ARROW: "ARROW";
+    readonly CAPTURE_ARROW: "CAPTURE_ARROW";
+    readonly DOT: "DOT";
+    readonly QUESTION: "QUESTION";
+    readonly AT: "AT";
+    readonly CARET: "CARET";
+    readonly COLON: "COLON";
+    readonly DOUBLE_COLON: "DOUBLE_COLON";
+    readonly COMMA: "COMMA";
+    readonly BANG: "BANG";
+    readonly AND: "AND";
+    readonly OR: "OR";
+    readonly NULLISH_COALESCE: "NULLISH_COALESCE";
+    readonly DOT_QUESTION: "DOT_QUESTION";
+    readonly AMPERSAND: "AMPERSAND";
+    readonly ASSIGN: "ASSIGN";
+    readonly EQ: "EQ";
+    readonly NE: "NE";
+    readonly LT: "LT";
+    readonly GT: "GT";
+    readonly LE: "LE";
+    readonly GE: "GE";
+    readonly STAR_LT: "STAR_LT";
+    readonly SLASH_LT: "SLASH_LT";
+    readonly UNDERSCORE: "UNDERSCORE";
+    readonly ELLIPSIS: "ELLIPSIS";
+    readonly PIPE_BAR: "PIPE_BAR";
+    readonly PLUS: "PLUS";
+    readonly MINUS: "MINUS";
+    readonly STAR: "STAR";
+    readonly SLASH: "SLASH";
+    readonly PERCENT: "PERCENT";
+    readonly LPAREN: "LPAREN";
+    readonly RPAREN: "RPAREN";
+    readonly LBRACE: "LBRACE";
+    readonly RBRACE: "RBRACE";
+    readonly LBRACKET: "LBRACKET";
+    readonly RBRACKET: "RBRACKET";
+    readonly BREAK: "BREAK";
+    readonly RETURN: "RETURN";
+    readonly PASS: "PASS";
+    readonly ASSERT: "ASSERT";
+    readonly ERROR: "ERROR";
+    readonly EACH: "EACH";
+    readonly MAP: "MAP";
+    readonly FOLD: "FOLD";
+    readonly FILTER: "FILTER";
+    readonly FRONTMATTER_DELIM: "FRONTMATTER_DELIM";
+    readonly NEWLINE: "NEWLINE";
+    readonly COMMENT: "COMMENT";
+    readonly EOF: "EOF";
+};
+export type TokenType = (typeof TOKEN_TYPES)[keyof typeof TOKEN_TYPES];
+export interface Token {
+    readonly type: TokenType;
+    readonly value: string;
+    readonly span: SourceSpan;
+}
+//# sourceMappingURL=token-types.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwFd,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

@@ -0,0 +1,79 @@
+// ============================================================
+// TOKEN TYPES
+// ============================================================
+export const TOKEN_TYPES = {
+    // Literals
+    STRING: 'STRING',
+    NUMBER: 'NUMBER',
+    TRUE: 'TRUE',
+    FALSE: 'FALSE',
+    // Identifiers
+    IDENTIFIER: 'IDENTIFIER',
+    // Variables
+    DOLLAR: 'DOLLAR', // $
+    PIPE_VAR: 'PIPE_VAR', // $ (lone dollar sign)
+    // Operators
+    ARROW: 'ARROW', // ->
+    CAPTURE_ARROW: 'CAPTURE_ARROW', // =>
+    DOT: 'DOT', // .
+    QUESTION: 'QUESTION', // ?
+    AT: 'AT', // @
+    CARET: 'CARET', // ^ (annotation prefix)
+    COLON: 'COLON', // :
+    DOUBLE_COLON: 'DOUBLE_COLON', // :: (namespace separator)
+    COMMA: 'COMMA', // ,
+    // Boolean operators
+    BANG: 'BANG', // !
+    AND: 'AND', // &&
+    OR: 'OR', // ||
+    // Null-coalescing and existence
+    NULLISH_COALESCE: 'NULLISH_COALESCE', // ??
+    DOT_QUESTION: 'DOT_QUESTION', // .?
+    AMPERSAND: 'AMPERSAND', // &
+    // Assignment
+    ASSIGN: 'ASSIGN', // =
+    // Comparison operators
+    EQ: 'EQ', // ==
+    NE: 'NE', // !=
+    LT: 'LT', // <
+    GT: 'GT', // >
+    LE: 'LE', // <=
+    GE: 'GE', // >=
+    // Extraction operators
+    STAR_LT: 'STAR_LT', // *< (destructure)
+    SLASH_LT: 'SLASH_LT', // /< (slice)
+    UNDERSCORE: 'UNDERSCORE', // _ (skip in destructure)
+    // Spread operator
+    ELLIPSIS: 'ELLIPSIS', // ... (list spread)
+    // Arithmetic operators
+    PIPE_BAR: 'PIPE_BAR', // |
+    PLUS: 'PLUS', // +
+    MINUS: 'MINUS', // -
+    STAR: 'STAR', // *
+    SLASH: 'SLASH', // /
+    PERCENT: 'PERCENT', // %
+    // Delimiters
+    LPAREN: 'LPAREN', // (
+    RPAREN: 'RPAREN', // )
+    LBRACE: 'LBRACE', // {
+    RBRACE: 'RBRACE', // }
+    LBRACKET: 'LBRACKET', // [
+    RBRACKET: 'RBRACKET', // ]
+    // Keywords
+    BREAK: 'BREAK',
+    RETURN: 'RETURN',
+    PASS: 'PASS',
+    ASSERT: 'ASSERT',
+    ERROR: 'ERROR',
+    EACH: 'EACH',
+    MAP: 'MAP',
+    FOLD: 'FOLD',
+    FILTER: 'FILTER',
+    // Frontmatter
+    FRONTMATTER_DELIM: 'FRONTMATTER_DELIM', // ---
+    // Special
+    NEWLINE: 'NEWLINE',
+    COMMENT: 'COMMENT',
+    EOF: 'EOF',
+};
+//# sourceMappingURL=token-types.js.map

package/dist/token-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-types.js","sourceRoot":"","sources":["../src/token-types.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAC/D,cAAc;AACd,+DAA+D;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW;IACX,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IAEd,cAAc;IACd,UAAU,EAAE,YAAY;IAExB,YAAY;IACZ,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,QAAQ,EAAE,UAAU,EAAE,uBAAuB;IAE7C,YAAY;IACZ,KAAK,EAAE,OAAO,EAAE,KAAK;IACrB,aAAa,EAAE,eAAe,EAAE,KAAK;IACrC,GAAG,EAAE,KAAK,EAAE,IAAI;IAChB,QAAQ,EAAE,UAAU,EAAE,IAAI;IAC1B,EAAE,EAAE,IAAI,EAAE,IAAI;IACd,KAAK,EAAE,OAAO,EAAE,wBAAwB;IACxC,KAAK,EAAE,OAAO,EAAE,IAAI;IACpB,YAAY,EAAE,cAAc,EAAE,2BAA2B;IACzD,KAAK,EAAE,OAAO,EAAE,IAAI;IAEpB,oBAAoB;IACpB,IAAI,EAAE,MAAM,EAAE,IAAI;IAClB,GAAG,EAAE,KAAK,EAAE,KAAK;IACjB,EAAE,EAAE,IAAI,EAAE,KAAK;IAEf,gCAAgC;IAChC,gBAAgB,EAAE,kBAAkB,EAAE,KAAK;IAC3C,YAAY,EAAE,cAAc,EAAE,KAAK;IACnC,SAAS,EAAE,WAAW,EAAE,IAAI;IAE5B,aAAa;IACb,MAAM,EAAE,QAAQ,EAAE,IAAI;IAEtB,uBAAuB;IACvB,EAAE,EAAE,IAAI,EAAE,KAAK;IACf,EAAE,EAAE,IAAI,EAAE,KAAK;IACf,EAAE,EAAE,IAAI,EAAE,IAAI;IACd,EAAE,EAAE,IAAI,EAAE,IAAI;IACd,EAAE,EAAE,IAAI,EAAE,KAAK;IACf,EAAE,EAAE,IAAI,EAAE,KAAK;IAEf,uBAAuB;IACvB,OAAO,EAAE,SAAS,EAAE,mBAAmB;IACvC,QAAQ,EAAE,UAAU,EAAE,aAAa;IACnC,UAAU,EAAE,YAAY,EAAE,0BAA0B;IAEpD,kBAAkB;IAClB,QAAQ,EAAE,UAAU,EAAE,oBAAoB;IAE1C,uBAAuB;IACvB,QAAQ,EAAE,UAAU,EAAE,IAAI;IAC1B,IAAI,EAAE,MAAM,EAAE,IAAI;IAClB,KAAK,EAAE,OAAO,EAAE,IAAI;IACpB,IAAI,EAAE,MAAM,EAAE,IAAI;IAClB,KAAK,EAAE,OAAO,EAAE,IAAI;IACpB,OAAO,EAAE,SAAS,EAAE,IAAI;IAExB,aAAa;IACb,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,QAAQ,EAAE,UAAU,EAAE,IAAI;IAC1B,QAAQ,EAAE,UAAU,EAAE,IAAI;IAE1B,WAAW;IACX,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAEhB,cAAc;IACd,iBAAiB,EAAE,mBAAmB,EAAE,MAAM;IAE9C,UAAU;IACV,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,KAAK;CACF,CAAC"}