@rcrsr/rill 0.4.4 → 0.5.0

package/docs/99_llm-reference.txt

@@ -106,6 +106,12 @@ CRITICAL DIFFERENCES FROM MAINSTREAM LANGUAGES
    Wrong: 0 ? "yes" ! "no"
    Right: (0 == 0) ? "yes" ! "no"
 
+   Negation (!) also requires boolean:
+   Right: !true                          # false
+   Right: "hello" -> .empty -> (!$)      # true (negates boolean from .empty)
+   Wrong: !"hello"                       # ERROR: Negation requires boolean, got string
+   Wrong: !0                             # ERROR: Negation requires boolean, got number
+
 4. VARIABLES LOCK TO FIRST TYPE
    "hello" :> $x
    42 :> $x        # ERROR: cannot assign number to string variable
@@ -146,6 +152,8 @@ Dicts:         [name: "alice", age: 30]    # identifier keys
                [1: "one", 2: "two"]        # number keys (incl. negative: [-1: "neg"])
                [true: "yes", false: "no"]  # boolean keys
                [["a", "b"]: 1]             # multi-key: [a: 1, b: 1]
+               [$keyVar: value]            # variable key (must eval to string)
+               [($expr): value]            # computed key (must eval to string)
 Tuples:        *[1, 2, 3]              # for argument unpacking
 Closures:      |x|($x + 1)             # like lambda/arrow functions
 Type annot:    "hi" :> $x:string       # lock type on capture
@@ -204,6 +212,13 @@ Error (halt execution immediately with message):
   "Operation failed" -> error            # piped form (must be string)
   error "Status: {$code}"               # interpolation works
 
+Pass (returns $ unchanged, explicit no-op):
+  cond ? pass ! "fallback"               # preserve $ when condition true
+  cond ? "value" ! pass                  # preserve $ when condition false
+  "data" -> { [status: pass] }           # include $ in dict: [status: "data"]
+  [1, -2, 3] -> map { ($ > 0) ? pass ! 0 }  # [1, 0, 3]
+  Note: pass requires pipe context. Using pass without $ throws error.
+
 LOOP STATE PATTERNS (CRITICAL)
 ------------------------------
 Rill loops CANNOT modify outer variables. All state must flow through $ or $@.
@@ -334,7 +349,11 @@ $data.($i + 1)                        # computed key
 $data.(a || b)                        # try keys left-to-right
 $data.field ?? "default"              # default if missing
 $data.?field                          # existence check (boolean)
+$data.?$keyVar                        # variable existence check
+$data.?($expr)                        # computed existence check
 $data.?field&string                   # existence AND type check
+$data.?$key&number                    # variable existence + type check
+$data.?($a -> "{$}_b")&list           # computed existence + type check
 
 DISPATCH OPERATORS
 ------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rcrsr/rill",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "Rill - An embeddable scripting language for orchestrating LLM workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,9 @@
     "access": "public"
   },
   "scripts": {
-    "prebuild": "rm -f tsconfig.tsbuildinfo",
+    "generate-docs": "npx tsx scripts/generate-docs-bundle.ts",
+    "generate-version": "npx tsx scripts/generate-version.ts",
+    "prebuild": "rm -f tsconfig.tsbuildinfo && npm run generate-version && npm run generate-docs",
     "build": "tsc",
     "build:watch": "tsc --watch",
     "typecheck": "tsc --noEmit",