@rcrsr/rill 0.17.0 → 0.18.0

package/dist/runtime/ext/builtins.js

@@ -9,9 +9,11 @@
 import { callable, isCallable, isDict } from '../core/callable.js';
 import { RuntimeError } from '../../types.js';
 import { parseSignatureRegistration } from '../../signature-parser.js';
-import { anyTypeValue, deepEquals, formatValue, inferType, isEmpty, isRillIterator, isVector, rillTypeToTypeValue, serializeValue, } from '../core/values.js';
+import { deepEquals, formatValue, inferType, serializeValue, } from '../core/types/registrations.js';
+import { isIterator, isVector } from '../core/types/guards.js';
+import { anyTypeValue, isEmpty, structureToTypeValue } from '../core/values.js';
 import { invokeCallable } from '../core/eval/index.js';
-import { populateBuiltinMethods } from '../core/type-registrations.js';
+import { populateBuiltinMethods } from '../core/types/registrations.js';
 // ============================================================
 // ITERATOR HELPERS
 // ============================================================
@@ -109,7 +111,7 @@ export const BUILTIN_FUNCTIONS = {
                 annotations: {},
             },
         ],
-        returnType: rillTypeToTypeValue({ kind: 'string' }),
+        returnType: structureToTypeValue({ kind: 'string' }),
         fn: (args, _ctx, location) => {
             const value = args['value'] ?? null;
             try {
@@ -117,8 +119,7 @@ export const BUILTIN_FUNCTIONS = {
                 return JSON.stringify(jsonValue);
             }
             catch (err) {
-                if (err instanceof RuntimeError)
-                    throw err;
+                // Wrap serialization errors (RILL-R067 from protocol) as RILL-R004
                 if (err instanceof Error) {
                     throw new RuntimeError('RILL-R004', err.message, location);
                 }
@@ -143,7 +144,7 @@ export const BUILTIN_FUNCTIONS = {
                 annotations: {},
             },
         ],
-        returnType: rillTypeToTypeValue({ kind: 'list' }),
+        returnType: structureToTypeValue({ kind: 'list' }),
         fn: (args) => {
             const input = args['items'] ?? null;
             if (Array.isArray(input)) {
@@ -350,7 +351,7 @@ function buildMethodEntry(name, signature, method, skipReceiverValidation) {
             ? { description: parsed.description }
             : {},
         returnType: parsed.returnType !== undefined
-            ? rillTypeToTypeValue(parsed.returnType)
+            ? structureToTypeValue(parsed.returnType)
             : anyTypeValue,
         ...(skipReceiverValidation ? { skipReceiverValidation: true } : {}),
     };
@@ -415,7 +416,7 @@ const mTail = (receiver, _args, _ctx, location) => {
 };
 /** Get iterator at first position for any collection */
 const mFirst = (receiver, _args, _ctx, location) => {
-    if (isRillIterator(receiver))
+    if (isIterator(receiver))
         return receiver;
     if (Array.isArray(receiver))
         return makeListIterator(receiver, 0);

package/dist/runtime/ext/extensions.d.ts

@@ -1,6 +1,6 @@
 import type { ApplicationCallable } from '../core/callable.js';
-import type { ExtensionEvent, RuntimeCallbacks } from '../core/types.js';
-import type { RillValue } from '../core/values.js';
+import type { ExtensionEvent, RuntimeCallbacks } from '../core/types/runtime.js';
+import type { RillValue } from '../core/types/structures.js';
 /**
  * Minimal interface for extension event emission.
  * Allows emitExtensionEvent to accept any context with callbacks.

package/dist/runtime/ext/extensions.js

@@ -1,3 +1,4 @@
+import { RuntimeError } from '../../types.js';
 /**
  * Emit an extension event with auto-generated timestamp.
  * Adds ISO timestamp if event.timestamp is undefined, then calls onLogEvent callback.
@@ -26,7 +27,7 @@ export function emitExtensionEvent(ctx, event) {
     if (!event['event'] ||
         typeof event['event'] !== 'string' ||
         event['event'].trim() === '') {
-        throw new Error('Event must include non-empty event field');
+        throw new RuntimeError('RILL-R075', 'Event must include non-empty event field');
     }
     // IC-2: Guard for callbacks property (graceful degradation)
     if ('callbacks' in ctx && ctx.callbacks) {

package/dist/runtime/ext/test-context.d.ts

@@ -4,8 +4,8 @@
  * Creates a pre-wired RuntimeContext from extension value maps.
  * Designed for testing and lightweight embedding without rill-config.
  */
-import type { RuntimeContext } from '../core/types.js';
-import { type RillValue } from '../core/values.js';
+import type { RuntimeContext } from '../core/types/runtime.js';
+import type { RillValue } from '../core/types/structures.js';
 /**
  * Error thrown when extension binding generation fails.
  * Mirrors the ExtensionBindingError in rill-config for core-only usage.

package/dist/runtime/ext/test-context.js

@@ -8,7 +8,8 @@ import { parseSource } from '../../ext-parse-bridge.js';
 import { createRuntimeContext } from '../core/context.js';
 import { extResolver } from '../core/resolvers.js';
 import { isCallable } from '../core/callable.js';
-import { formatStructure } from '../core/values.js';
+import { formatStructure } from '../core/types/operations.js';
+import { RuntimeError } from '../../types.js';
 // ============================================================
 // ERROR CLASS
 // ============================================================
@@ -109,7 +110,7 @@ function createExtModuleResolver(bindingSource) {
         if (resource === 'ext') {
             return { kind: 'source', text: bindingSource, sourceId: 'module:ext' };
         }
-        throw new Error(`Unknown module '${resource}'`);
+        throw new RuntimeError('RILL-R076', `Unknown module '${resource}'`);
     };
 }
 // ============================================================

package/dist/runtime/index.d.ts

@@ -16,29 +16,14 @@
  * - ext/: Self-contained extensions
  *   - builtins.ts: Built-in functions and methods
  */
-export type { CaptureEvent, ErrorEvent, ExecutionResult, ExecutionStepper, HostCallEvent, FunctionReturnEvent, ObservabilityCallbacks, ResolverResult, RuntimeCallbacks, RuntimeContext, RuntimeOptions, SchemeResolver, StepEndEvent, StepResult, StepStartEvent, } from './core/types.js';
-export type { ApplicationCallable, CallableFn, RillCallable, RillFunction, RillParam, RuntimeCallable, ScriptCallable, } from './core/callable.js';
-export { callable, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, toCallable, } from './core/callable.js';
-export type { NativeArray, NativePlainObject, NativeResult, NativeValue, RillFieldDef, RillIterator, RillTuple, RillTypeValue, RillValue, RillVector, TypeStructure, } from './core/values.js';
-/** @deprecated Use TypeStructure instead. Will be removed in the next major version. */
-export type { RillType } from './core/values.js';
-export type { TypeDefinition, TypeProtocol, } from './core/type-registrations.js';
-export { anyTypeValue, commonType, createTuple, createVector, formatStructure, inferElementType, inferStructure, inferType, isIterator, isTuple, isTypeValue, isVector, isReservedMethod, paramToFieldDef, structureToTypeValue, RESERVED_DICT_METHODS, structureEquals, structureMatches, toNative, } from './core/values.js';
-/** @deprecated Use formatStructure instead. */
-export { formatStructuralType } from './core/values.js';
-/** @deprecated Use inferStructure instead. */
-export { inferStructuralType } from './core/values.js';
-/** @deprecated Use isIterator instead. */
-export { isRillIterator } from './core/values.js';
-/** @deprecated Use structureToTypeValue instead. */
-export { rillTypeToTypeValue } from './core/values.js';
-/** @deprecated Use structureEquals instead. */
-export { structuralTypeEquals } from './core/values.js';
-/** @deprecated Use structureMatches instead. */
-export { structuralTypeMatches } from './core/values.js';
+export type { CaptureEvent, ErrorEvent, ExecutionResult, ExecutionStepper, ExtensionEvent, FieldComparisonCallbacks, FunctionReturnEvent, HostCallEvent, NativeArray, NativePlainObject, NativeValue, ObservabilityCallbacks, ResolverResult, RillFieldDef, RillIterator, RillStream, RillTuple, RillTypeValue, RillValue, RillVector, RuntimeCallbacks, RuntimeContext, RuntimeOptions, SchemeResolver, StepEndEvent, StepResult, StepStartEvent, TypeDefinition, TypeProtocol, TypeStructure, } from './core/types/index.js';
+export type { ApplicationCallable, CallableFn, MarshalOptions, RillCallable, RillFunction, RillParam, RuntimeCallable, ScriptCallable, } from './core/callable.js';
+export { callable, hydrateFieldDefaults, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, marshalArgs, toCallable, } from './core/callable.js';
+export type { NativeResult } from './core/values.js';
+export { BUILT_IN_TYPES, commonType, compareStructuredFields, copyValue, createOrdered, createRillStream, createTuple, createVector, deepEquals, deserializeValue, formatRillLiteral, formatStructure, formatValue, inferElementType, inferStructure, inferType, isIterator, isRillStream, isStream, isTuple, isTypeValue, isVector, paramToFieldDef, serializeValue, structureEquals, structureMatches, } from './core/types/index.js';
+export { anyTypeValue, isEmpty, isReservedMethod, isTruthy, RESERVED_DICT_METHODS, structureToTypeValue, toNative, } from './core/values.js';
 export { buildFieldDescriptor } from './core/field-descriptor.js';
-export { BreakSignal, ReturnSignal } from './core/signals.js';
-export type { ExtensionEvent } from './core/types.js';
+export { BreakSignal, ReturnSignal, YieldSignal } from './core/signals.js';
 export type { ConfigFieldDescriptor, ExtensionConfigSchema, ExtensionFactory, ExtensionFactoryResult, ExtensionManifest, FsExtensionContract, KvExtensionContract, } from './ext/extensions.js';
 export type { SchemaEntry } from '../ext/kv/index.js';
 export { emitExtensionEvent } from './ext/extensions.js';
@@ -49,6 +34,7 @@ export type { CallFrame } from '../types.js';
 export { getCallStack, pushCallFrame, popCallFrame } from './core/context.js';
 export { createStepper, execute } from './core/execute.js';
 export { invokeCallable } from './core/eval/index.js';
+export { BUILTIN_METHODS } from './ext/builtins.js';
 export type { DocumentationCoverageResult, FunctionMetadata, ParamMetadata, } from './core/introspection.js';
 export { generateManifest, getDocumentationCoverage, getFunctions, getLanguageReference, } from './core/introspection.js';
 export type { VersionInfo } from '../generated/version-data.js';

package/dist/runtime/index.js

@@ -16,26 +16,16 @@
  * - ext/: Self-contained extensions
  *   - builtins.ts: Built-in functions and methods
  */
-export { callable, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, toCallable, } from './core/callable.js';
-export { anyTypeValue, commonType, createTuple, createVector, formatStructure, inferElementType, inferStructure, inferType, isIterator, isTuple, isTypeValue, isVector, isReservedMethod, paramToFieldDef, structureToTypeValue, RESERVED_DICT_METHODS, structureEquals, structureMatches, toNative, } from './core/values.js';
-// Deprecated aliases — old names kept for one release
-/** @deprecated Use formatStructure instead. */
-export { formatStructuralType } from './core/values.js';
-/** @deprecated Use inferStructure instead. */
-export { inferStructuralType } from './core/values.js';
-/** @deprecated Use isIterator instead. */
-export { isRillIterator } from './core/values.js';
-/** @deprecated Use structureToTypeValue instead. */
-export { rillTypeToTypeValue } from './core/values.js';
-/** @deprecated Use structureEquals instead. */
-export { structuralTypeEquals } from './core/values.js';
-/** @deprecated Use structureMatches instead. */
-export { structuralTypeMatches } from './core/values.js';
+export { callable, hydrateFieldDefaults, isApplicationCallable, isCallable, isDict, isRuntimeCallable, isScriptCallable, marshalArgs, toCallable, } from './core/callable.js';
+// Extracted to types/ sub-modules (via barrel)
+export { BUILT_IN_TYPES, commonType, compareStructuredFields, copyValue, createOrdered, createRillStream, createTuple, createVector, deepEquals, deserializeValue, formatRillLiteral, formatStructure, formatValue, inferElementType, inferStructure, inferType, isIterator, isRillStream, isStream, isTuple, isTypeValue, isVector, paramToFieldDef, serializeValue, structureEquals, structureMatches, } from './core/types/index.js';
+// Remain in values.ts
+export { anyTypeValue, isEmpty, isReservedMethod, isTruthy, RESERVED_DICT_METHODS, structureToTypeValue, toNative, } from './core/values.js';
 export { buildFieldDescriptor } from './core/field-descriptor.js';
 // ============================================================
 // CONTROL FLOW SIGNALS
 // ============================================================
-export { BreakSignal, ReturnSignal } from './core/signals.js';
+export { BreakSignal, ReturnSignal, YieldSignal } from './core/signals.js';
 export { emitExtensionEvent } from './ext/extensions.js';
 // ============================================================
 // BUILT-IN RESOLVERS
@@ -55,5 +45,9 @@ export { createStepper, execute } from './core/execute.js';
 // CALLABLE INVOCATION
 // ============================================================
 export { invokeCallable } from './core/eval/index.js';
+// ============================================================
+// BUILT-IN METHODS
+// ============================================================
+export { BUILTIN_METHODS } from './ext/builtins.js';
 export { generateManifest, getDocumentationCoverage, getFunctions, getLanguageReference, } from './core/introspection.js';
 export { VERSION, VERSION_INFO } from '../generated/version-data.js';

package/dist/signature-parser.d.ts

@@ -12,7 +12,7 @@
  *   which is NOT in parser/* or lexer/* — boundary preserved.
  */
 import type { RillParam } from './runtime/core/callable.js';
-import type { TypeStructure } from './runtime/core/values.js';
+import type { TypeStructure } from './runtime/core/types/structures.js';
 /**
  * Result of parsing a signature string at registration time.
  */

package/dist/token-types.d.ts

@@ -53,6 +53,7 @@ export declare const TOKEN_TYPES: {
     readonly CONVERT: "CONVERT";
     readonly BREAK: "BREAK";
     readonly RETURN: "RETURN";
+    readonly YIELD: "YIELD";
     readonly PASS: "PASS";
     readonly ASSERT: "ASSERT";
     readonly ERROR: "ERROR";

package/dist/token-types.js

@@ -70,6 +70,7 @@ export const TOKEN_TYPES = {
     // Keywords
     BREAK: 'BREAK',
     RETURN: 'RETURN',
+    YIELD: 'YIELD',
     PASS: 'PASS',
     ASSERT: 'ASSERT',
     ERROR: 'ERROR',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Scripting designed for machine-generated code",
   "license": "MIT",
   "author": "Andre Bremer",