@rcrsr/rill 0.15.0 → 0.17.0

package/dist/ext/kv/index.d.ts

@@ -4,7 +4,7 @@
  * Provides key-value store operations with JSON persistence and schema validation.
  * Supports both open mode (any key/value) and declared mode (schema-defined keys only).
  */
-import type { ExtensionResult, ExtensionConfigSchema, ExtensionManifest } from '../../runtime/ext/extensions.js';
+import type { ExtensionFactoryResult, ExtensionConfigSchema, ExtensionManifest } from '../../runtime/ext/extensions.js';
 import { type SchemaEntry } from './store.js';
 /** Configuration for a single KV mount */
 export interface KvMountConfig {
@@ -51,7 +51,7 @@ export declare const configSchema: ExtensionConfigSchema;
  * Returns 11 functions: get, get_or, set, merge, delete, keys, has, clear, getAll, schema, mounts.
  *
  * @param config - Store configuration (mount-based or single-store)
- * @returns ExtensionResult with 11 KV functions and dispose handler
+ * @returns ExtensionFactoryResult with 11 KV functions and dispose handler
  * @throws RuntimeError if store file is corrupt (EC-25)
  *
  * @example
@@ -78,6 +78,5 @@ export declare const configSchema: ExtensionConfigSchema;
  * });
  * ```
  */
-export declare function createKvExtension(config: KvConfig): ExtensionResult;
+export declare function createKvExtension(config: KvConfig): ExtensionFactoryResult;
 export declare const extensionManifest: ExtensionManifest;
-//# sourceMappingURL=index.d.ts.map

package/dist/ext/kv/index.js

@@ -5,6 +5,7 @@
  * Supports both open mode (any key/value) and declared mode (schema-defined keys only).
  */
 import { RuntimeError } from '../../error-classes.js';
+import { toCallable } from '../../runtime/core/callable.js';
 import { isDict } from '../../runtime/core/callable.js';
 import { createStore } from './store.js';
 import { rillTypeToTypeValue, } from '../../runtime/core/values.js';
@@ -22,7 +23,7 @@ export const configSchema = {
  * Returns 11 functions: get, get_or, set, merge, delete, keys, has, clear, getAll, schema, mounts.
  *
  * @param config - Store configuration (mount-based or single-store)
- * @returns ExtensionResult with 11 KV functions and dispose handler
+ * @returns ExtensionFactoryResult with 11 KV functions and dispose handler
  * @throws RuntimeError if store file is corrupt (EC-25)
  *
  * @example
@@ -112,8 +113,8 @@ export function createKvExtension(config) {
      * Returns empty string for missing keys in open mode.
      */
     const get = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
+        const mountName = args['mount'];
+        const key = args['key'];
         const store = await getStore(mountName);
         const value = store.get(key);
         // In rill, functions cannot return undefined - return empty string for missing keys in open mode
@@ -125,9 +126,9 @@ export function createKvExtension(config) {
      * Never throws for missing keys (unlike get in declared mode).
      */
     const get_or = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
-        const fallback = args[2];
+        const mountName = args['mount'];
+        const key = args['key'];
+        const fallback = args['fallback'];
         const store = await getStore(mountName);
         // Check if key exists using has() to avoid schema validation errors
         if (store.has(key)) {
@@ -141,9 +142,9 @@ export function createKvExtension(config) {
      * IR-16, EC-20-24
      */
     const set = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
-        const value = args[2];
+        const mountName = args['mount'];
+        const key = args['key'];
+        const value = args['value'];
         const store = await getStore(mountName);
         await store.set(key, value);
         return true;
@@ -153,9 +154,9 @@ export function createKvExtension(config) {
      * IR-4, EC-5, EC-6
      */
     const merge = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
-        const partial = args[2];
+        const mountName = args['mount'];
+        const key = args['key'];
+        const partial = args['partial'];
         const store = await getStore(mountName);
         // Get current value
         const currentValue = store.get(key);
@@ -177,8 +178,8 @@ export function createKvExtension(config) {
      * IR-17
      */
     const deleteKey = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
+        const mountName = args['mount'];
+        const key = args['key'];
         const store = await getStore(mountName);
         return store.delete(key);
     };
@@ -187,7 +188,7 @@ export function createKvExtension(config) {
      * IR-6
      */
     const keys = async (args) => {
-        const mountName = args[0];
+        const mountName = args['mount'];
         const store = await getStore(mountName);
         return store.keys();
     };
@@ -196,8 +197,8 @@ export function createKvExtension(config) {
      * IR-7
      */
     const has = async (args) => {
-        const mountName = args[0];
-        const key = args[1];
+        const mountName = args['mount'];
+        const key = args['key'];
         const store = await getStore(mountName);
         return store.has(key);
     };
@@ -206,7 +207,7 @@ export function createKvExtension(config) {
      * IR-8
      */
     const clear = async (args) => {
-        const mountName = args[0];
+        const mountName = args['mount'];
         const store = await getStore(mountName);
         store.clear();
         return true;
@@ -216,7 +217,7 @@ export function createKvExtension(config) {
      * IR-9
      */
     const getAll = async (args) => {
-        const mountName = args[0];
+        const mountName = args['mount'];
         const store = await getStore(mountName);
         return store.getAll();
     };
@@ -225,7 +226,7 @@ export function createKvExtension(config) {
      * IR-10
      */
     const schema = async (args) => {
-        const mountName = args[0];
+        const mountName = args['mount'];
         const mountConfig = mounts[mountName];
         if (!mountConfig) {
             throw new RuntimeError('RILL-R004', `Mount '${mountName}' not found`, undefined, { mountName, availableMounts: Object.keys(mounts) });
@@ -279,204 +280,205 @@ export function createKvExtension(config) {
     // ============================================================
     // EXTENSION RESULT
     // ============================================================
-    const result = {
-        get: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
+    return {
+        value: {
+            get: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to retrieve' },
+                    },
+                ],
+                fn: get,
+                annotations: { description: 'Get value or schema default' },
+                returnType: rillTypeToTypeValue({ kind: 'any' }),
+            }),
+            get_or: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to retrieve' },
+                    },
+                    {
+                        name: 'fallback',
+                        type: { kind: 'any' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Fallback value if key missing' },
+                    },
+                ],
+                fn: get_or,
+                annotations: {
+                    description: 'Get value or return fallback if key missing',
                 },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to retrieve' },
+                returnType: rillTypeToTypeValue({ kind: 'any' }),
+            }),
+            set: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to set' },
+                    },
+                    {
+                        name: 'value',
+                        type: { kind: 'any' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Value to store' },
+                    },
+                ],
+                fn: set,
+                annotations: { description: 'Set value with validation' },
+                returnType: rillTypeToTypeValue({ kind: 'bool' }),
+            }),
+            merge: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to merge into' },
+                    },
+                    {
+                        name: 'partial',
+                        type: { kind: 'dict' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Partial dict to merge' },
+                    },
+                ],
+                fn: merge,
+                annotations: {
+                    description: 'Merge partial dict into existing dict value',
                 },
-            ],
-            fn: get,
-            annotations: { description: 'Get value or schema default' },
-            returnType: rillTypeToTypeValue({ type: 'any' }),
-        },
-        get_or: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to retrieve' },
-                },
-                {
-                    name: 'fallback',
-                    type: { type: 'any' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Fallback value if key missing' },
-                },
-            ],
-            fn: get_or,
-            annotations: {
-                description: 'Get value or return fallback if key missing',
-            },
-            returnType: rillTypeToTypeValue({ type: 'any' }),
-        },
-        set: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to set' },
-                },
-                {
-                    name: 'value',
-                    type: { type: 'any' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Value to store' },
-                },
-            ],
-            fn: set,
-            annotations: { description: 'Set value with validation' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        merge: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to merge into' },
-                },
-                {
-                    name: 'partial',
-                    type: { type: 'dict' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Partial dict to merge' },
-                },
-            ],
-            fn: merge,
-            annotations: {
-                description: 'Merge partial dict into existing dict value',
-            },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        delete: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to delete' },
-                },
-            ],
-            fn: deleteKey,
-            annotations: { description: 'Delete key' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        keys: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: keys,
-            annotations: { description: 'Get all keys in mount' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
-        },
-        has: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to check' },
-                },
-            ],
-            fn: has,
-            annotations: { description: 'Check key existence' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        clear: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: clear,
-            annotations: { description: 'Clear all keys in mount' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        getAll: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: getAll,
-            annotations: { description: 'Get all entries as dict' },
-            returnType: rillTypeToTypeValue({ type: 'dict' }),
-        },
-        schema: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: schema,
-            annotations: { description: 'Get schema information' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
-        },
-        mounts: {
-            params: [],
-            fn: mountsList,
-            annotations: { description: 'Get list of mount metadata' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
+                returnType: rillTypeToTypeValue({ kind: 'bool' }),
+            }),
+            delete: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to delete' },
+                    },
+                ],
+                fn: deleteKey,
+                annotations: { description: 'Delete key' },
+                returnType: rillTypeToTypeValue({ kind: 'bool' }),
+            }),
+            keys: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: keys,
+                annotations: { description: 'Get all keys in mount' },
+                returnType: rillTypeToTypeValue({ kind: 'list' }),
+            }),
+            has: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to check' },
+                    },
+                ],
+                fn: has,
+                annotations: { description: 'Check key existence' },
+                returnType: rillTypeToTypeValue({ kind: 'bool' }),
+            }),
+            clear: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: clear,
+                annotations: { description: 'Clear all keys in mount' },
+                returnType: rillTypeToTypeValue({ kind: 'bool' }),
+            }),
+            getAll: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: getAll,
+                annotations: { description: 'Get all entries as dict' },
+                returnType: rillTypeToTypeValue({ kind: 'dict' }),
+            }),
+            schema: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: schema,
+                annotations: { description: 'Get schema information' },
+                returnType: rillTypeToTypeValue({ kind: 'list' }),
+            }),
+            mounts: toCallable({
+                params: [],
+                fn: mountsList,
+                annotations: { description: 'Get list of mount metadata' },
+                returnType: rillTypeToTypeValue({ kind: 'list' }),
+            }),
         },
+        dispose,
     };
-    result.dispose = dispose;
-    return result;
 }
 // ============================================================
 // MANIFEST
@@ -485,4 +487,3 @@ export const extensionManifest = {
     factory: createKvExtension,
     configSchema,
 };
-//# sourceMappingURL=index.js.map

package/dist/ext/kv/store.d.ts

@@ -47,4 +47,3 @@ export declare function createStore(config: StoreConfig): Promise<{
     getAll: () => Record<string, RillValue>;
     flush: () => Promise<void>;
 }>;
-//# sourceMappingURL=store.d.ts.map

package/dist/ext/kv/store.js

@@ -7,6 +7,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { RuntimeError } from '../../error-classes.js';
+import { deserializeValue } from '../../runtime/core/type-registrations.js';
 // ============================================================
 // STORE IMPLEMENTATION
 // ============================================================
@@ -52,7 +53,7 @@ export async function createStore(config) {
             // Load declared keys with defaults, validate existing values
             for (const [key, schemaEntry] of Object.entries(schema)) {
                 if (key in parsed) {
-                    const value = parsed[key];
+                    const value = deserializeValue(parsed[key], schemaEntry.type);
                     validateType(key, value, schemaEntry.type, storePath);
                     data.set(key, value);
                 }
@@ -267,4 +268,3 @@ export async function createStore(config) {
         flush,
     };
 }
-//# sourceMappingURL=store.js.map

package/dist/ext-parse-bridge.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge for runtime/ext modules that need parse().
+ *
+ * Import boundary note (§NOD.2.1):
+ * - This file lives at src/ level (not in runtime/), so it may import
+ *   from the parser barrel.
+ * - runtime/ext/test-context.ts imports from this file
+ *   (../../ext-parse-bridge.js), which is NOT in parser/* — boundary preserved.
+ */
+export { parse as parseSource } from './parser/index.js';

package/dist/ext-parse-bridge.js

@@ -0,0 +1,10 @@
+/**
+ * Bridge for runtime/ext modules that need parse().
+ *
+ * Import boundary note (§NOD.2.1):
+ * - This file lives at src/ level (not in runtime/), so it may import
+ *   from the parser barrel.
+ * - runtime/ext/test-context.ts imports from this file
+ *   (../../ext-parse-bridge.js), which is NOT in parser/* — boundary preserved.
+ */
+export { parse as parseSource } from './parser/index.js';