evg_observable 3.0.1 → 3.1.1

package/.claudeignore

@@ -0,0 +1,9 @@
+  .env
+  .env.*
+  *.pem
+  *.key
+  credentials.json
+  service-account*.json
+  **/secrets/**
+  .npmrc
+  .pypirc

package/README.md

@@ -1,4 +1,6 @@
 [![Socket Badge](https://socket.dev/api/badge/npm/package/evg_observable)](https://socket.dev/npm/package/evg_observable)
+<a href="https://www.npmjs.com/package/evg_observable"><img alt="npm version" src="https://img.shields.io/npm/v/evg_observable.svg?style=flat-square"></a>
+<a href="https://bundlephobia.com/result?p=evg_observable"><img alt="Bundle size" src="https://badgen.net/bundlephobia/min/evg_observable"></a>
 <h1 align=center style="color: saddlebrown">
 EVG Observable
 </h1>
@@ -20,6 +22,13 @@ EVG Observable - is a light library for simple use.
         - [pipe().once()](#pipeonce)
         - [pipe().unsubscribeBy()](#pipeunsubscribebycondition)
         - [pipe().and()](#pipeandcondition)
+        - [pipe().throttle()](#pipethrottlems)
+        - [pipe().debounce()](#pipedebouncems)
+        - [pipe().distinctUntilChanged()](#pipedistinctuntilchangedcomparator)
+        - [pipe().tap()](#pipetapfn)
+        - [pipe().take()](#pipetaken)
+        - [pipe().skip()](#pipeskipn)
+        - [pipe().scan()](#pipescankfn-seed)
         - [pipe().toJson()](#pipetojson)
         - [pipe().fromJson()](#pipefromjsonk)
         - [pipe().in()](#pipeink-v)
@@ -41,14 +50,26 @@ EVG Observable - is a light library for simple use.
 
 | Metric | EVG Observable | RxJS |
 |--------|----------------|------|
-| **Bundle size** | **7.2 kB** | 88 kB |
-| **Size advantage** | **12.2x smaller** | - |
-| **Operations** | ~40 | 100+ |
-| **Performance** | **2-7x faster** | baseline |
+| **Bundle size** | **9.4 kB** | 63.6 kB |
+| **Size advantage** | **6.8x smaller** | - |
+| **Operations** | ~43 | 100+ |
+| **Performance** | **2-6x faster** | baseline |
 
 ### Performance Comparison (Bundle vs Bundle)
 
-Benchmarked with minified bundles on Node.js v22.17.1 (v3.0.0 API, averaged over 3 clean runs):
+Benchmarked with minified bundles on Node.js v20.18.3 (v3.1.0 API):
+
+| Test | EVG Observable | RxJS | Advantage |
+|------|----------------|------|-----------|
+| Emit 100 values | 2,955K ops/sec | 508K ops/sec | **5.8x faster** |
+| Filter + transform | 615K ops/sec | 237K ops/sec | **2.6x faster** |
+| 10 subscribers | 21,881K ops/sec | 7,556K ops/sec | **2.9x faster** |
+| 100 subscribers | 2,284K ops/sec | 907K ops/sec | **2.5x faster** |
+| 1000 subscribers | 181K ops/sec | 81K ops/sec | **2.2x faster** |
+| Large payload | 1,455K ops/sec | 370K ops/sec | **3.9x faster** |
+
+<details>
+<summary>Previous results (v3.0.0 API, Node.js v22.17.1, averaged over 3 clean runs)</summary>
 
 | Test | EVG Observable | RxJS | Advantage |
 |------|----------------|------|-----------|
@@ -60,20 +81,6 @@ Benchmarked with minified bundles on Node.js v22.17.1 (v3.0.0 API, averaged over
 | Batch emission - of(100) | 906K ops/sec | 176K ops/sec | **5.1x faster** |
 | 5 chained filters | 19K ops/sec | 9K ops/sec | **2.1x faster** |
 | Large payload | 879K ops/sec | 184K ops/sec | **4.8x faster** |
-
-<details>
-<summary>Previous results (v2.x API, measured in different conditions)</summary>
-
-| Test | EVG Observable | RxJS | Advantage |
-|------|----------------|------|-----------|
-| Emit 100 values | 1,548K ops/sec | 240K ops/sec | **6.4x faster** |
-| Filter + transform | 353K ops/sec | 164K ops/sec | **2.1x faster** |
-| 10 subscribers | 9,078K ops/sec | 2,900K ops/sec | **3.1x faster** |
-| 100 subscribers | 1,245K ops/sec | 336K ops/sec | **3.7x faster** |
-| 1000 subscribers | 122K ops/sec | 33K ops/sec | **3.7x faster** |
-| Large payload | 865K ops/sec | 199K ops/sec | **4.3x faster** |
-
-**Note**: v3.0.0 performance is equal or better than v2.x (emit: +7%, 10 subs: +10%). The API redesign with more flexible pipe system maintains excellent performance while providing enhanced functionality.
 </details>
 
 ### EVG Observable Advantages
@@ -90,7 +97,7 @@ Benchmarked with minified bundles on Node.js v22.17.1 (v3.0.0 API, averaged over
 
 ### When to use RxJS instead
 
-RxJS is better when you need specialized operators like `debounceTime`, `throttleTime`, `switchMap`, `mergeMap`, `combineLatest`, `withLatestFrom`, or schedulers for async control.
+RxJS is better when you need specialized operators like `switchMap`, `mergeMap`, `combineLatest`, `withLatestFrom`, or schedulers for async control.
 
 **For 80% of reactive programming tasks, EVG Observable provides sufficient functionality with significant performance and size benefits.**
 
@@ -103,7 +110,7 @@ Comparison with lightweight libraries in the same weight category (observable-fn
 | Metric | EVG Observable | observable-fns |
 |--------|----------------|----------------|
 | **Weekly downloads** | Growing | 67K |
-| **Bundle size (minified)** | 7.2 kB | 10.8 kB |
+| **Bundle size (minified)** | 9.4 kB | 9.9 kB |
 | **Implementation** | Original architecture | zen-observable re-implementation |
 | **Dependencies** | 0 | 0 |
 | **Architecture** | True hot observables | Cold observables (zen-observable API) |
@@ -334,6 +341,269 @@ observable$.next({message: "some message3", isNeedUnsubscribe: true});
 
 Observable will send a value to the listener only if condition returns "true". There is no automatic unsubscription.
 
+### pipe().throttle(ms)
+
+Throttle emissions using leading-edge strategy. The first value passes immediately; subsequent values within the cooldown interval are silently dropped.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<string>('');
+const received: string[] = [];
+
+observable$
+    .pipe()
+    .throttle(300)  // Only allow one value per 300ms
+    .subscribe((value: string) => received.push(value));
+
+observable$.next("first");   // passes immediately
+observable$.next("second");  // dropped (within 300ms)
+observable$.next("third");   // dropped (within 300ms)
+// After 300ms...
+observable$.next("fourth");  // passes (interval expired)
+```
+
+Throttle can be combined with other pipe operators:
+
+```ts
+observable$
+    .pipe()
+    .and(str => str.length > 1)    // filter short strings
+    .throttle(500)                  // throttle remaining values
+    .map<number>(str => str.length) // transform to length
+    .subscribe(listener);
+```
+
+### pipe().debounce(ms)
+
+Debounce emissions using trailing-edge strategy. Each new value resets the timer. The value is emitted after `ms` milliseconds of silence (no new values).
+
+```ts
+import {Observable} from "evg_observable";
+
+const search$ = new Observable<string>('');
+const results: string[] = [];
+
+search$
+    .pipe()
+    .debounce(300)  // Wait 300ms of silence before emitting
+    .subscribe((value: string) => results.push(value));
+
+search$.next("h");      // timer starts
+search$.next("he");     // timer resets
+search$.next("hello");  // timer resets
+// After 300ms of silence → "hello" is emitted
+```
+
+Debounce can be combined with other pipe operators:
+
+```ts
+observable$
+    .pipe()
+    .and(str => str.length > 2)    // filter short strings first
+    .debounce(200)                  // debounce remaining values
+    .map<number>(str => str.length) // transform to length
+    .subscribe(listener);
+```
+
+### pipe().distinctUntilChanged(comparator?)
+
+Suppresses consecutive duplicate values. A value is emitted only when it differs from the previously emitted value. The first value always passes through.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<number>(0);
+const results: number[] = [];
+
+observable$
+    .pipe()
+    .distinctUntilChanged()
+    .subscribe((value: number) => results.push(value));
+
+observable$.next(1);  // emitted (first value)
+observable$.next(1);  // suppressed (same as previous)
+observable$.next(2);  // emitted (different)
+observable$.next(2);  // suppressed (same as previous)
+observable$.next(1);  // emitted (different from 2)
+// results: [1, 2, 1]
+```
+
+With custom comparator for objects:
+
+```ts
+const users$ = new Observable<{id: number; name: string}>({id: 0, name: ''});
+
+users$
+    .pipe()
+    .distinctUntilChanged((prev, curr) => prev.id === curr.id)
+    .subscribe(user => console.log(user.name));
+
+users$.next({id: 1, name: 'Alice'});         // emitted
+users$.next({id: 1, name: 'Alice Updated'}); // suppressed (same id)
+users$.next({id: 2, name: 'Bob'});           // emitted
+```
+
+### pipe().tap(fn)
+
+Executes a side-effect function on the current value without modifying it. The value passes through unchanged to the next operator. Useful for logging, debugging, or triggering external actions mid-pipeline.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<number>(0);
+
+observable$
+    .pipe()
+    .tap(value => console.log('before filter:', value))
+    .and(value => value > 0)
+    .tap(value => console.log('after filter:', value))
+    .map<string>(value => `Result: ${value}`)
+    .subscribe(result => console.log(result));
+
+observable$.next(5);
+// before filter: 5
+// after filter: 5
+// Result: 5
+
+observable$.next(-1);
+// before filter: -1
+// (filtered out by .and(), tap after filter is not called)
+```
+
+#### Global debug flag pattern
+
+Use a debug flag to enable/disable all taps at once — zero runtime cost when disabled:
+
+```ts
+const DEBUG = true; // set to false in production
+
+const observable$ = new Observable<number>(0);
+
+observable$
+    .pipe()
+    .tap(value => DEBUG && console.log('[filter-in]:', value))
+    .and(value => value > 0)
+    .tap(value => DEBUG && console.log('[filter-out]:', value))
+    .map<number>(value => value * 2)
+    .tap(value => DEBUG && console.log('[mapped]:', value))
+    .subscribe(listener);
+
+observable$.next(5);
+// DEBUG=true:  [filter-in]: 5 → [filter-out]: 5 → [mapped]: 10
+// DEBUG=false: (nothing logged, V8 optimizes `false && ...` to no-op)
+```
+
+You can also use named taps for clarity in complex pipelines:
+
+```ts
+const tap_log = (name: string) => (value: any) =>
+    DEBUG && console.log(`[${name}]:`, value);
+
+observable$
+    .pipe()
+    .tap(tap_log('raw'))
+    .and(value => value > 0)
+    .tap(tap_log('filtered'))
+    .distinctUntilChanged()
+    .tap(tap_log('unique'))
+    .subscribe(listener);
+```
+
+### pipe().take(n)
+
+Passes the first N values through the pipe, then automatically unsubscribes. Generalization of `once()` — `once()` is equivalent to `take(1)`.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<string>('');
+const received: string[] = [];
+
+observable$
+    .pipe()
+    .take(3)
+    .subscribe((value: string) => received.push(value));
+
+observable$.next("a");  // received: ["a"]
+observable$.next("b");  // received: ["a", "b"]
+observable$.next("c");  // received: ["a", "b", "c"] — auto-unsubscribed
+observable$.next("d");  // not received
+```
+
+Combine with filters and transforms:
+
+```ts
+observable$
+    .pipe()
+    .and(str => str.length > 2)    // filter short strings
+    .take(2)                        // take first 2 that pass
+    .subscribe(listener);
+```
+
+### pipe().skip(n)
+
+Ignores the first N values in the pipe, then passes all subsequent values through. Mirror of `take(n)`.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<string>('');
+const received: string[] = [];
+
+observable$
+    .pipe()
+    .skip(2)
+    .subscribe((value: string) => received.push(value));
+
+observable$.next("a");  // skipped
+observable$.next("b");  // skipped
+observable$.next("c");  // received: ["c"]
+observable$.next("d");  // received: ["c", "d"]
+```
+
+Combine skip + take for window slicing:
+
+```ts
+observable$
+    .pipe()
+    .skip(2)    // skip first 2
+    .take(3)    // take next 3, then unsubscribe
+    .subscribe(listener);
+```
+
+### pipe().scan&lt;K&gt;(fn, seed)
+
+Accumulator operator — each value passes through a reducer function, the accumulated result is emitted. Like `Array.reduce()` for streams.
+
+```ts
+import {Observable} from "evg_observable";
+
+const observable$ = new Observable<number>(0);
+const sums: number[] = [];
+
+observable$
+    .pipe()
+    .scan<number>((acc, val) => acc + val, 0)
+    .subscribe((sum: number) => sums.push(sum));
+
+observable$.next(1);   // sums: [1]
+observable$.next(2);   // sums: [1, 3]
+observable$.next(3);   // sums: [1, 3, 6]
+```
+
+Type-changing scan (string → number):
+
+```ts
+const observable$ = new Observable<string>('');
+
+observable$
+    .pipe()
+    .scan<number>((acc, str) => acc + str.length, 0)
+    .and(total => total > 5)
+    .subscribe(total => console.log('Total chars:', total));
+```
+
 ### pipe().toJson()
 
 To convert the observable's data to JSON format, you can use the serialize method. This method turns the observer's
@@ -805,7 +1075,14 @@ observable$.next(-1);  // Listener 1 throws, listener 2 still receives
 | `.choice()`                          | SwitchCase object                      | transitions the pipe into switch-case mode. In this mode, only the first condition that returns a positive result is triggered, and all others are ignored. This allows you to handle multiple cases more conveniently. |
 | `.or(*condition)`                  | PipeCase object                        | Adds a condition to the chain of cases. The entire chain operates on the principle of "OR". This is different from other pipe methods which, when chained, operate on the principle of "AND".                           |
 | `.anyOf(*conditions)`            | PipeCase object                        | This method allows you to add a group of conditions for filtering cases data in the pipeline chain.                                                                                                                     |
+| `.throttle(ms: number)`              | pipe object                            | Throttles emissions using leading-edge strategy. First value passes immediately, subsequent values within `ms` interval are dropped.                                                                                    |
+| `.debounce(ms: number)`              | pipe object                            | Debounces emissions using trailing-edge strategy. Each new value resets the timer. Emits after `ms` milliseconds of silence.                                                                                            |
+| `.distinctUntilChanged(comparator?)` | pipe object                            | Suppresses consecutive duplicate values. Optional `comparator(prev, curr) => boolean` for custom equality. Defaults to `===`.                                                                                          |
+| `.tap(fn: ICallback<T>)`            | pipe object                            | Executes a side-effect function without modifying the value. The value passes through unchanged.                                                                                                                        |
+| `.take(n: number)`                   | pipe object                            | Passes the first N values, then auto-unsubscribes. Generalization of `once()`.                                                                                                                                          |
+| `.skip(n: number)`                   | pipe object                            | Ignores the first N values, then passes all subsequent values through. Mirror of `take()`.                                                                                                                              |
 | `.map<K>(transform: ICallback<T>)`  | Observable instance with new data type | This method allows transforming payload data in the pipe chain by applying user callback function. `transform` should be a function that takes the current data and returns transformed data of possibly another type.  |
+| `.scan<K>(fn, seed)`                | pipe object with new type K            | Accumulator — each value passes through reducer `fn(acc, val) => newAcc`, emits accumulated result. Like `Array.reduce()` for streams.                                                                                  |
 | `.toJson()`                       | pipe object                            | Converts the observers data into a JSON string.                                                                                                                                                                         |
 | `.fromJson<K>()`                  | pipe object                            | Converts a JSON string into an object of type K.                                                                                                                                                                        |
 | `.of<K, V>(transform?: ICallback<K>)`| pipe object                            | Iterates over array elements. For each element, emits it to subscribers. Optional transform function processes each element before emission.                                                                             |

package/package.json

@@ -1,26 +1,43 @@
 {
   "name": "evg_observable",
-  "version": "3.0.1",
-  "description": "Alternative fast and light library version - observable.",
-  "main": "src/outLib/index.js",
-  "types": "src/outLib/index.d.ts",
+  "version": "3.1.1",
+  "description": "Lightweight reactive Observable library (zero dependencies) — 2-7x faster than RxJS, 1.5-3x faster than observable-fns. Pipe operators: throttle, debounce, distinctUntilChanged, map, tap. Original hot-observable architecture, not a fork or wrapper.",
+  "main": "./src/outLib/index.js",
+  "module": "./src/outLib-esm/index.mjs",
+  "types": "./src/outLib/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./src/outLib/index.d.ts",
+        "default": "./src/outLib-esm/index.mjs"
+      },
+      "require": {
+        "types": "./src/outLib/index.d.ts",
+        "default": "./src/outLib/index.js"
+      }
+    }
+  },
   "directories": {
     "test": "test"
   },
   "scripts": {
     "test": "nyc ./node_modules/.bin/_mocha 'test/**/*.test.ts'",
     "remove": "rm -rf ./src/Libraries; rm -rf ./test; rm .mocharc.json; rm .nyrc.json; rm register.js; rm tsconfig.json",
-    "build": "tsc --declaration; npm run remove",
+    "build": "tsc --declaration && npm run build:esm && npm run remove",
+    "build:esm": "esbuild src/Libraries/Observables/index.ts --bundle --format=esm --minify --outfile=src/outLib-esm/index.mjs",
     "benchmark": "ts-node benchmarks/benchmark.ts",
     "benchmark:comparison": "ts-node benchmarks/benchmark-comparison.ts",
     "benchmark:competitors": "ts-node benchmarks/benchmark-competitors.ts",
     "benchmark:browser": "ts-node benchmarks/benchmark-browser-bundle.ts",
+    "benchmark:esm": "ts-node benchmarks/benchmark-esm-bundle.ts",
     "benchmark:bundles": "ts-node benchmarks/benchmark-bundles.ts",
     "benchmark:patterns": "ts-node benchmarks/benchmark-subscription-patterns.ts",
     "benchmark:patterns-edge": "ts-node benchmarks/benchmark-patterns-edge-cases.ts",
     "benchmark:patterns-clean": "ts-node benchmarks/benchmark-patterns-clean.ts",
     "benchmark:patterns-final": "ts-node benchmarks/benchmark-patterns-fixed.ts",
-    "benchmark:patterns-vs-competitors": "ts-node benchmarks/benchmark-patterns-vs-competitors.ts"
+    "benchmark:patterns-vs-competitors": "ts-node benchmarks/benchmark-patterns-vs-competitors.ts",
+    "bundle": "esbuild src/browser-entry.ts --bundle --minify --format=iife --outfile=repo/evg_observable.js",
+    "bundle:watch": "esbuild src/browser-entry.ts --bundle --minify --format=iife --outfile=repo/evg_observable.js --watch"
   },
   "repository": {
     "type": "git",
@@ -38,6 +55,7 @@
     "@types/chai": "^4.3.4",
     "benchmark": "^2.1.4",
     "chai": "^4.3.7",
+    "esbuild": "^0.27.4",
     "microtime": "^3.1.1",
     "mocha": "^11.7.5",
     "nyc": "^17.1.0",
@@ -47,17 +65,23 @@
     "typescript": "^5.4.5"
   },
   "keywords": [
-    "EVG Observable",
-    "evg_observable",
-    "Observable",
-    "Ordered observable",
-    "Light observable",
-    "Collector",
-    "Type script",
-    "TypeScript",
-    "TS",
-    "Java script",
-    "JavaScript",
-    "JS"
+    "observable",
+    "reactive",
+    "event-emitter",
+    "rxjs-alternative",
+    "lightweight",
+    "pub-sub",
+    "subscribe",
+    "pipe",
+    "filter",
+    "map",
+    "throttle",
+    "debounce",
+    "distinctUntilChanged",
+    "tap",
+    "state-management",
+    "event-stream",
+    "typescript",
+    "zero-dependencies"
   ]
 }

package/repo/evg_observable.js

@@ -1 +1 @@
-(()=>{"use strict";function s(s,r){return s.order>r.order?1:s.order<r.order?-1:0}function r(s,r){return s.order>r.order?-1:s.order<r.order?1:0}function e(s,r){const e=s.indexOf(r);return-1!==e&&(s.splice(e,1),!0)}function i(s){return"next"in s?r=>s.next(r):s}class t{pipe;counter;constructor(s){this.pipe=s,this.counter=s.chain.length?s.chain.length:0}or(s){this.counter++;const r=this.counter,e=this.pipe.chain;return e.push(i=>{i.isAvailable=!0,s(i.payload)&&(i.isBreak=!0),r!==e.length||i.isBreak||(i.isAvailable=!1)}),this}anyOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.or(s[r]);return this}}class n{chain=[];flow={isBreak:!1,isUnsubscribe:!1,isAvailable:!1,payload:null};push(s){return this.chain.push(s),this}once(){return this.push(s=>{this.listener(s.payload),s.isUnsubscribe=!0})}unsubscribeBy(s){return this.push(r=>{r.isAvailable=!0,s(r.payload)&&(r.isUnsubscribe=!0)})}and(s){return this.push(r=>s(r.payload)&&(r.isAvailable=!0))}allOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.and(s[r]);return this}choice(){return new h(this)}map(s){return this.push(r=>{r.payload=s(r.payload),r.isAvailable=!0})}toJson(){return this.push(s=>{s.payload=JSON.stringify(s.payload),s.isAvailable=!0})}fromJson(){return this.push(s=>{s.payload=JSON.parse(s.payload),s.isAvailable=!0})}group(){return this}processChain(s){const r=this.chain,e=this.flow,i=r.length;for(let s=0;s<i;s++){if(e.isUnsubscribe=!1,e.isAvailable=!1,r[s](e),e.isUnsubscribe)return this.unsubscribe();if(!e.isAvailable)return;if(e.isBreak)break}return s(e.payload)}}class h extends t{subscribe(s,r){return this.pipe.subscribe(s,r)}group(){return this.pipe}}class l extends n{observer;listener;errorHandler=(s,r)=>{console.log(`(Unit of SubscribeObject).send(${s}) ERROR:`,r)};_order=0;paused=!1;piped=!1;listeners;errorHandlers;constructor(s,r){super(),this.observer=s,this.piped=!!r}subscribe(s,r){return this.listener=function(s){if(Array.isArray(s)){const r=[];for(let e=0;e<s.length;e++)r.push(i(s[e]));return s=>{for(let e=0;e<r.length;e++)r[e](s)}}return i(s)}(s),r&&(this.errorHandler=r),this}add(s,r){if(this.listeners||(this.listeners=[],this.errorHandlers=[]),Array.isArray(s))for(let e=0;e<s.length;e++){this.listeners.push(s[e]);const i=r&&Array.isArray(r)?r[e]??this.errorHandler:r||this.errorHandler;this.errorHandlers.push(i)}else{this.listeners.push(s);const e=r&&!Array.isArray(r)?r:this.errorHandler;this.errorHandlers.push(e)}return this}unsubscribe(){this.observer&&(this.observer.unSubscribe(this),this.observer=null,this.listener=null,this.chain.length=0)}send(s){const r=this.listener,e=this.listeners&&this.listeners.length>0;if(r||e){if(this.observer&&!this.paused)if(this.piped)try{if(this.flow.payload=s,this.flow.isBreak=!1,r)this.processChain(r);else{const s=this.chain,r=this.flow,e=s.length;r.isAvailable=0===e;for(let i=0;i<e;i++){if(r.isUnsubscribe=!1,r.isAvailable=!1,s[i](r),r.isUnsubscribe)return void this.unsubscribe();if(!r.isAvailable)return;if(r.isBreak)break}}if(e){const s=this.flow.payload;for(let r=0;r<this.listeners.length;r++)try{this.listeners[r](s)}catch(e){this.errorHandlers[r](s,e)}}}catch(r){this.errorHandler(s,r)}else{if(r)try{r(s)}catch(r){this.errorHandler(s,r)}if(e)for(let r=0;r<this.listeners.length;r++)try{this.listeners[r](s)}catch(e){this.errorHandlers[r](s,e)}}}else this.unsubscribe()}resume(){this.paused=!1}pause(){this.paused=!0}get order(){return this._order}set order(s){this._order=s}}class a{chain=[];flow={isBreak:!1,isAvailable:!1,payload:null};response={isOK:!1,payload:void 0};errHandler;get isEmpty(){return!this.chain.length}push(s){return this.chain.push(s),this}and(s){return this.push(r=>s(r.payload)&&(r.isAvailable=!0))}allOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.and(s[r]);return this}choice(){return new o(this)}processChain(s){const r=this.chain,e=this.flow,i=this.response;i.isOK=!1,i.payload=void 0,e.payload=s,e.isBreak=!1;try{const s=r.length;for(let t=0;t<s;t++){if(e.isAvailable=!1,r[t](e),!e.isAvailable)return i;if(e.isBreak)break}}catch(s){return this.errHandler?this.errHandler(s,"Filter.processChain ERROR:"):console.log("Filter.processChain ERROR:",s),i}return i.isOK=!0,i.payload=e.payload,i}addErrorHandler(s){this.errHandler=s}}class o extends t{}class u{subs=[];enabled=!0;killed=!1;process=!1;trash=[];filters=new a;_value;constructor(s){this._value=s}addFilter(s){return s&&this.filters.addErrorHandler(s),this.filters}disable(){this.enabled=!1}enable(){this.enabled=!0}get isEnable(){return this.enabled}next(s){if(this.killed)return;if(!this.enabled)return;if(!this.subs.length)return;if(!this.filters.isEmpty&&!this.filters.processChain(s).isOK)return;this.process=!0,this._value=s;const r=this.subs,e=r.length;for(let i=0;i<e;i++)r[i].send(s);this.process=!1,this.trash.length&&this.clearTrash()}of(s){if(!this.killed&&this.enabled)for(let r=0;r<s.length;r++)this.next(s[r])}in(s){if(!this.killed&&this.enabled)for(const r in s)Object.hasOwn(s,r)&&this.next([r,s[r]])}clearTrash(){const s=this.trash.length;for(let r=0;r<s;r++)this.unSubscribe(this.trash[r]);this.trash.length=0}unSubscribe(s){this.killed||(this.process&&s?this.trash.push(s):this.subs&&e(this.subs,s))}destroy(){if(!this.killed){if(this.killed=!0,!this.process)return this._value=null,void(this.subs.length=0);Promise.resolve().then(()=>{this._value=null,this.subs.length=0})}}unsubscribeAll(){if(!this.killed){if(this.process){const s=this.subs;for(let r=0;r<s.length;r++)this.trash.push(s[r]);return}this.subs.length=0}}getValue(){if(!this.killed)return this._value}size(){return this.killed?0:this.subs.length}subscribe(s,r){if(this.killed)return;if(!this.isListener(s))return;const e=new l(this,!1);return this.addObserver(e,s,r),e}addObserver(s,r,e){s.subscribe(r,e),this.subs.push(s)}isListener(s){return!this.killed&&!!s}pipe(){if(this.killed)return;const s=new l(this,!0);return this.subs.push(s),s}get isDestroyed(){return this.killed}}class d extends l{constructor(s,r){super(s,r)}get order(){return this._order}set order(s){!this.observer||this.observer&&this.observer.isDestroyed?this._order=void 0:(this._order=s,this.observer.sortByOrder())}subscribe(s,r){return super.subscribe(s,r),this}once(){return super.once()}}const c=window;c.Observable=u,c.Collector=class{arr=[];killed=!1;collect(...s){this.killed||this.arr.push(...s)}unsubscribe(s){this.killed||(s?.unsubscribe(),e(this.arr,s))}unsubscribeAll(){if(this.killed)return;const s=this.arr;for(let r=0;r<s.length;r++)s[r].unsubscribe();s.length=0}size(){return this.killed?0:this.arr.length}destroy(){this.unsubscribeAll(),this.arr.length=0,this.arr=0,this.killed=!0}get isDestroyed(){return this.killed}},c.OrderedObservable=class extends u{sortDirection=s;ascendingSort(){return this.sortDirection=s,this.sortByOrder()}descendingSort(){return this.sortDirection=r,this.sortByOrder()}sortByOrder(){return!this.killed&&(this.subs.sort(this.sortDirection),!0)}subscribe(s,r){if(!this.isListener(s))return;const e=new d(this,!1);return this.addObserver(e,s,r),e}pipe(){if(this.killed)return;const s=new d(this,!0);return this.subs.push(s),s}unSubscribe(s){this.killed||(this.process&&s?this.trash.push(s):this.subs&&e(this.subs,s))}}})();
+"use strict";(()=>{function y(t,e){return t.order>e.order?1:t.order<e.order?-1:0}function v(t,e){return t.order>e.order?-1:t.order<e.order?1:0}function o(t,e){let r=t.indexOf(e);return r===-1?!1:(t.splice(r,1),!0)}function O(t){if(Array.isArray(t)){let e=t.length,r=new Array(e);for(let i=0;i<e;i++)r[i]=k(t[i]);return i=>{for(let s=0;s<e;s++)r[s](i)}}return k(t)}function k(t){return"next"in t?e=>t.next(e):t}var c=class{pipe;counter;constructor(e){this.pipe=e,this.counter=e.chain.length?e.chain.length:0}or(e){this.counter++;let r=this.counter,i=this.pipe.chain;return i.push(s=>{s.isAvailable=!0,e(s.payload)&&(s.isBreak=!0),r===i.length&&!s.isBreak&&(s.isAvailable=!1)}),this}anyOf(e){if(!Array.isArray(e))return this;for(let r=0;r<e.length;r++)this.or(e[r]);return this}};var I=class{chain=[];flow={isBreak:!1,isUnsubscribe:!1,isAvailable:!1,debounceMs:0,debounceTimer:0,debounceValue:void 0,debounceIndex:0,payload:null};push(e){return this.chain.push(e),this}once(){return this.push(e=>{this.listener(e.payload),e.isUnsubscribe=!0})}take(e){e<0&&(e=0);let r=0;return this.push(i=>{if(r>=e){i.isUnsubscribe=!0;return}r++,this.listener(i.payload),r>=e&&(i.isUnsubscribe=!0)})}skip(e){e<0&&(e=0);let r=0;return this.push(i=>{if(r<e){r++;return}i.isAvailable=!0})}unsubscribeBy(e){return this.push(r=>{r.isAvailable=!0,e(r.payload)&&(r.isUnsubscribe=!0)})}and(e){return this.push(r=>e(r.payload)&&(r.isAvailable=!0))}allOf(e){if(!Array.isArray(e))return this;for(let r=0;r<e.length;r++)this.and(e[r]);return this}choice(){return new T(this)}map(e){return this.push(r=>{r.payload=e(r.payload),r.isAvailable=!0})}scan(e,r){let i=r;return this.push(s=>{i=e(i,s.payload),s.payload=i,s.isAvailable=!0})}tap(e){return this.push(r=>{e(r.payload),r.isAvailable=!0})}throttle(e){let r=0;return this.push(i=>{let s=Date.now();s-r>=e&&(r=s,i.isAvailable=!0)})}debounce(e){return this.push(r=>{r.isAvailable=!0,r.debounceMs=e})}distinctUntilChanged(e){let r=!1,i;return this.push(s=>{let n=s.payload;r&&(e?e(i,n):i===n)||(r=!0,i=n,s.isAvailable=!0)})}toJson(){return this.push(e=>{e.payload=JSON.stringify(e.payload),e.isAvailable=!0})}fromJson(){return this.push(e=>{e.payload=JSON.parse(e.payload),e.isAvailable=!0})}group(){return this}processChain(e){let r=this.chain,i=this.flow,s=r.length;for(let n=0;n<s;n++){if(i.isUnsubscribe=!1,i.isAvailable=!1,i.debounceMs=0,r[n](i),i.isUnsubscribe)return this.unsubscribe();if(i.debounceMs>0){i.debounceValue=i.payload,i.debounceIndex=n+1;let l=()=>{i.debounceTimer=0,i.payload=i.debounceValue,i.isBreak=!1;for(let a=i.debounceIndex;a<s;a++){if(i.isUnsubscribe=!1,i.isAvailable=!1,i.debounceMs=0,r[a](i),i.isUnsubscribe)return this.unsubscribe();if(i.debounceMs>0){i.debounceValue=i.payload,i.debounceIndex=a+1,clearTimeout(i.debounceTimer),i.debounceTimer=setTimeout(l,i.debounceMs);return}if(!i.isAvailable)return;if(i.isBreak)break}e&&e(i.payload)};clearTimeout(i.debounceTimer),i.debounceTimer=setTimeout(l,i.debounceMs);return}if(!i.isAvailable)return;if(i.isBreak)break}i.isAvailable=!0,e&&e(i.payload)}},T=class extends c{subscribe(e,r){return this.pipe.subscribe(e,r)}group(){return this.pipe}};var u=class extends I{observer;listener;errorHandler=(e,r)=>{console.log(`(Unit of SubscribeObject).send(${e}) ERROR:`,r)};_order=0;paused=!1;piped=!1;listeners;errorHandlers;constructor(e,r){super(),this.observer=e,this.piped=!!r}subscribe(e,r){return this.listener=O(e),r&&(this.errorHandler=r),this}add(e,r){if(this.listeners||(this.listeners=[],this.errorHandlers=[]),Array.isArray(e))for(let i=0;i<e.length;i++){this.listeners.push(e[i]);let s=r&&Array.isArray(r)?r[i]??this.errorHandler:r||this.errorHandler;this.errorHandlers.push(s)}else{this.listeners.push(e);let i=r&&!Array.isArray(r)?r:this.errorHandler;this.errorHandlers.push(i)}return this}unsubscribe(){this.observer&&(clearTimeout(this.flow.debounceTimer),this.observer.unSubscribe(this),this.observer=null,this.listener=null,this.chain.length=0)}send(e){let r=this.listener,i=this.listeners&&this.listeners.length>0;if(!r&&!i){this.unsubscribe();return}if(!(!this.observer||this.paused)){if(!this.piped){if(r)try{r(e)}catch(s){this.errorHandler(e,s)}return}try{if(this.flow.payload=e,this.flow.isBreak=!1,i){let s=this.listeners,n=this.errorHandlers;this.processChain(l=>{r&&r(l);for(let a=0;a<s.length;a++)try{s[a](l)}catch(C){n[a](l,C)}})}else this.processChain(r)}catch(s){this.errorHandler(e,s)}}}resume(){this.paused=!1}pause(){this.paused=!0}get order(){return this._order}set order(e){this._order=e}};var f=class{chain=[];flow={isBreak:!1,isAvailable:!1,payload:null};response={isOK:!1,payload:void 0};errHandler;get isEmpty(){return!this.chain.length}push(e){return this.chain.push(e),this}and(e){return this.push(r=>e(r.payload)&&(r.isAvailable=!0))}allOf(e){if(!Array.isArray(e))return this;for(let r=0;r<e.length;r++)this.and(e[r]);return this}choice(){return new m(this)}processChain(e){let r=this.chain,i=this.flow,s=this.response;s.isOK=!1,s.payload=void 0,i.payload=e,i.isBreak=!1;try{let n=r.length;for(let l=0;l<n;l++){if(i.isAvailable=!1,r[l](i),!i.isAvailable)return s;if(i.isBreak)break}}catch(n){return this.errHandler?this.errHandler(n,"Filter.processChain ERROR:"):console.log("Filter.processChain ERROR:",n),s}return s.isOK=!0,s.payload=i.payload,s}addErrorHandler(e){this.errHandler=e}},m=class extends c{};var b=class{subs=[];enabled=!0;killed=!1;process=!1;trash=[];filters=new f;_value;constructor(e){this._value=e}addFilter(e){return e&&this.filters.addErrorHandler(e),this.filters}disable(){this.enabled=!1}enable(){this.enabled=!0}get isEnable(){return this.enabled}next(e){if(this.killed||!this.enabled||!this.subs.length||!this.filters.isEmpty&&!this.filters.processChain(e).isOK)return;this.process=!0,this._value=e;let r=this.subs,i=r.length;for(let s=0;s<i;s++)r[s].send(e);this.process=!1,this.trash.length&&this.clearTrash()}of(e){if(!this.killed&&this.enabled)for(let r=0;r<e.length;r++)this.next(e[r])}in(e){if(!this.killed&&this.enabled)for(let r in e)Object.hasOwn(e,r)&&this.next([r,e[r]])}clearTrash(){let e=this.trash.length;for(let r=0;r<e;r++)this.unSubscribe(this.trash[r]);this.trash.length=0}unSubscribe(e){if(!this.killed){if(this.process&&e){this.trash.push(e);return}this.subs&&o(this.subs,e)}}destroy(){if(!this.killed){if(this.killed=!0,!this.process){this.clearDebounceTimers(),this._value=null,this.subs.length=0;return}Promise.resolve().then(()=>{this.clearDebounceTimers(),this._value=null,this.subs.length=0})}}unsubscribeAll(){if(!this.killed){if(this.process){this.clearDebounceTimers();let e=this.subs;for(let r=0;r<e.length;r++)this.trash.push(e[r]);return}this.clearDebounceTimers(),this.subs.length=0}}clearDebounceTimers(){let e=this.subs;for(let r=0;r<e.length;r++)clearTimeout(e[r].flow.debounceTimer)}getValue(){if(!this.killed)return this._value}size(){return this.killed?0:this.subs.length}subscribe(e,r){if(this.killed||!this.isListener(e))return;let i=new u(this,!1);return this.addObserver(i,e,r),i}addObserver(e,r,i){e.subscribe(r,i),this.subs.push(e)}isListener(e){return this.killed?!1:!!e}pipe(){if(this.killed)return;let e=new u(this,!0);return this.subs.push(e),e}get isDestroyed(){return this.killed}};var d=class extends u{constructor(e,r){super(e,r)}get order(){return this._order}set order(e){if(!this.observer||this.observer&&this.observer.isDestroyed){this._order=void 0;return}this._order=e,this.observer.sortByOrder()}subscribe(e,r){return super.subscribe(e,r),this}once(){return super.once()}take(e){return super.take(e)}skip(e){return super.skip(e)}scan(e,r){return super.scan(e,r)}};var h=class extends b{sortDirection=y;ascendingSort(){return this.sortDirection=y,this.sortByOrder()}descendingSort(){return this.sortDirection=v,this.sortByOrder()}sortByOrder(){return this.killed?!1:(this.subs.sort(this.sortDirection),!0)}subscribe(e,r){if(!this.isListener(e))return;let i=new d(this,!1);return this.addObserver(i,e,r),i}pipe(){if(this.killed)return;let e=new d(this,!0);return this.subs.push(e),e}unSubscribe(e){if(!this.killed){if(this.process&&e){this.trash.push(e);return}this.subs&&o(this.subs,e)}}};var p=class{arr=[];killed=!1;collect(...e){this.killed||this.arr.push(...e)}unsubscribe(e){this.killed||(e?.unsubscribe(),o(this.arr,e))}unsubscribeAll(){if(this.killed)return;let e=this.arr;for(let r=0;r<e.length;r++)e[r].unsubscribe();e.length=0}size(){return this.killed?0:this.arr.length}destroy(){this.unsubscribeAll(),this.arr.length=0,this.arr=0,this.killed=!0}get isDestroyed(){return this.killed}};var S=window;S.Observable=b;S.OrderedObservable=h;S.Collector=p;})();

package/repo/evg_observable.old.js

@@ -0,0 +1 @@
+(()=>{"use strict";function s(s,r){return s.order>r.order?1:s.order<r.order?-1:0}function r(s,r){return s.order>r.order?-1:s.order<r.order?1:0}function e(s,r){const e=s.indexOf(r);return-1!==e&&(s.splice(e,1),!0)}function i(s){return"next"in s?r=>s.next(r):s}class t{pipe;counter;constructor(s){this.pipe=s,this.counter=s.chain.length?s.chain.length:0}or(s){this.counter++;const r=this.counter,e=this.pipe.chain;return e.push(i=>{i.isAvailable=!0,s(i.payload)&&(i.isBreak=!0),r!==e.length||i.isBreak||(i.isAvailable=!1)}),this}anyOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.or(s[r]);return this}}class n{chain=[];flow={isBreak:!1,isUnsubscribe:!1,isAvailable:!1,payload:null};push(s){return this.chain.push(s),this}once(){return this.push(s=>{this.listener(s.payload),s.isUnsubscribe=!0})}unsubscribeBy(s){return this.push(r=>{r.isAvailable=!0,s(r.payload)&&(r.isUnsubscribe=!0)})}and(s){return this.push(r=>s(r.payload)&&(r.isAvailable=!0))}allOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.and(s[r]);return this}choice(){return new h(this)}map(s){return this.push(r=>{r.payload=s(r.payload),r.isAvailable=!0})}toJson(){return this.push(s=>{s.payload=JSON.stringify(s.payload),s.isAvailable=!0})}fromJson(){return this.push(s=>{s.payload=JSON.parse(s.payload),s.isAvailable=!0})}group(){return this}processChain(s){const r=this.chain,e=this.flow,i=r.length;for(let s=0;s<i;s++){if(e.isUnsubscribe=!1,e.isAvailable=!1,r[s](e),e.isUnsubscribe)return this.unsubscribe();if(!e.isAvailable)return;if(e.isBreak)break}return s(e.payload)}}class h extends t{subscribe(s,r){return this.pipe.subscribe(s,r)}group(){return this.pipe}}class l extends n{observer;listener;errorHandler=(s,r)=>{console.log(`(Unit of SubscribeObject).send(${s}) ERROR:`,r)};_order=0;paused=!1;piped=!1;listeners;errorHandlers;constructor(s,r){super(),this.observer=s,this.piped=!!r}subscribe(s,r){return this.listener=function(s){if(Array.isArray(s)){const r=[];for(let e=0;e<s.length;e++)r.push(i(s[e]));return s=>{for(let e=0;e<r.length;e++)r[e](s)}}return i(s)}(s),r&&(this.errorHandler=r),this}add(s,r){if(this.listeners||(this.listeners=[],this.errorHandlers=[]),Array.isArray(s))for(let e=0;e<s.length;e++){this.listeners.push(s[e]);const i=r&&Array.isArray(r)?r[e]??this.errorHandler:r||this.errorHandler;this.errorHandlers.push(i)}else{this.listeners.push(s);const e=r&&!Array.isArray(r)?r:this.errorHandler;this.errorHandlers.push(e)}return this}unsubscribe(){this.observer&&(this.observer.unSubscribe(this),this.observer=null,this.listener=null,this.chain.length=0)}send(s){const r=this.listener,e=this.listeners&&this.listeners.length>0;if(r||e){if(this.observer&&!this.paused)if(this.piped)try{if(this.flow.payload=s,this.flow.isBreak=!1,r)this.processChain(r);else{const s=this.chain,r=this.flow,e=s.length;r.isAvailable=0===e;for(let i=0;i<e;i++){if(r.isUnsubscribe=!1,r.isAvailable=!1,s[i](r),r.isUnsubscribe)return void this.unsubscribe();if(!r.isAvailable)return;if(r.isBreak)break}}if(e){const s=this.flow.payload;for(let r=0;r<this.listeners.length;r++)try{this.listeners[r](s)}catch(e){this.errorHandlers[r](s,e)}}}catch(r){this.errorHandler(s,r)}else{if(r)try{r(s)}catch(r){this.errorHandler(s,r)}if(e)for(let r=0;r<this.listeners.length;r++)try{this.listeners[r](s)}catch(e){this.errorHandlers[r](s,e)}}}else this.unsubscribe()}resume(){this.paused=!1}pause(){this.paused=!0}get order(){return this._order}set order(s){this._order=s}}class a{chain=[];flow={isBreak:!1,isAvailable:!1,payload:null};response={isOK:!1,payload:void 0};errHandler;get isEmpty(){return!this.chain.length}push(s){return this.chain.push(s),this}and(s){return this.push(r=>s(r.payload)&&(r.isAvailable=!0))}allOf(s){if(!Array.isArray(s))return this;for(let r=0;r<s.length;r++)this.and(s[r]);return this}choice(){return new o(this)}processChain(s){const r=this.chain,e=this.flow,i=this.response;i.isOK=!1,i.payload=void 0,e.payload=s,e.isBreak=!1;try{const s=r.length;for(let t=0;t<s;t++){if(e.isAvailable=!1,r[t](e),!e.isAvailable)return i;if(e.isBreak)break}}catch(s){return this.errHandler?this.errHandler(s,"Filter.processChain ERROR:"):console.log("Filter.processChain ERROR:",s),i}return i.isOK=!0,i.payload=e.payload,i}addErrorHandler(s){this.errHandler=s}}class o extends t{}class u{subs=[];enabled=!0;killed=!1;process=!1;trash=[];filters=new a;_value;constructor(s){this._value=s}addFilter(s){return s&&this.filters.addErrorHandler(s),this.filters}disable(){this.enabled=!1}enable(){this.enabled=!0}get isEnable(){return this.enabled}next(s){if(this.killed)return;if(!this.enabled)return;if(!this.subs.length)return;if(!this.filters.isEmpty&&!this.filters.processChain(s).isOK)return;this.process=!0,this._value=s;const r=this.subs,e=r.length;for(let i=0;i<e;i++)r[i].send(s);this.process=!1,this.trash.length&&this.clearTrash()}of(s){if(!this.killed&&this.enabled)for(let r=0;r<s.length;r++)this.next(s[r])}in(s){if(!this.killed&&this.enabled)for(const r in s)Object.hasOwn(s,r)&&this.next([r,s[r]])}clearTrash(){const s=this.trash.length;for(let r=0;r<s;r++)this.unSubscribe(this.trash[r]);this.trash.length=0}unSubscribe(s){this.killed||(this.process&&s?this.trash.push(s):this.subs&&e(this.subs,s))}destroy(){if(!this.killed){if(this.killed=!0,!this.process)return this._value=null,void(this.subs.length=0);Promise.resolve().then(()=>{this._value=null,this.subs.length=0})}}unsubscribeAll(){if(!this.killed){if(this.process){const s=this.subs;for(let r=0;r<s.length;r++)this.trash.push(s[r]);return}this.subs.length=0}}getValue(){if(!this.killed)return this._value}size(){return this.killed?0:this.subs.length}subscribe(s,r){if(this.killed)return;if(!this.isListener(s))return;const e=new l(this,!1);return this.addObserver(e,s,r),e}addObserver(s,r,e){s.subscribe(r,e),this.subs.push(s)}isListener(s){return!this.killed&&!!s}pipe(){if(this.killed)return;const s=new l(this,!0);return this.subs.push(s),s}get isDestroyed(){return this.killed}}class d extends l{constructor(s,r){super(s,r)}get order(){return this._order}set order(s){!this.observer||this.observer&&this.observer.isDestroyed?this._order=void 0:(this._order=s,this.observer.sortByOrder())}subscribe(s,r){return super.subscribe(s,r),this}once(){return super.once()}}const c=window;c.Observable=u,c.Collector=class{arr=[];killed=!1;collect(...s){this.killed||this.arr.push(...s)}unsubscribe(s){this.killed||(s?.unsubscribe(),e(this.arr,s))}unsubscribeAll(){if(this.killed)return;const s=this.arr;for(let r=0;r<s.length;r++)s[r].unsubscribe();s.length=0}size(){return this.killed?0:this.arr.length}destroy(){this.unsubscribeAll(),this.arr.length=0,this.arr=0,this.killed=!0}get isDestroyed(){return this.killed}},c.OrderedObservable=class extends u{sortDirection=s;ascendingSort(){return this.sortDirection=s,this.sortByOrder()}descendingSort(){return this.sortDirection=r,this.sortByOrder()}sortByOrder(){return!this.killed&&(this.subs.sort(this.sortDirection),!0)}subscribe(s,r){if(!this.isListener(s))return;const e=new d(this,!1);return this.addObserver(e,s,r),e}pipe(){if(this.killed)return;const s=new d(this,!0);return this.subs.push(s),s}unSubscribe(s){this.killed||(this.process&&s?this.trash.push(s):this.subs&&e(this.subs,s))}}})();

package/scripts/README.md

@@ -0,0 +1,69 @@
+# Automation Scripts
+
+Scripts for automated code review and PR preparation using Claude Code in headless mode.
+
+## Prerequisites
+
+- Claude Code CLI installed (`npm install -g @anthropic-ai/claude-code`)
+- Authenticated Claude session (API key or OAuth)
+- Git repository with at least one base branch (`dev`, `stage`, `main`, or `master`)
+
+## Scripts
+
+### claude-review-files.sh
+
+Code review of current branch changes against a base branch.
+
+**What it checks:**
+- Correctness and edge cases
+- TypeScript type safety
+- Naming conventions (PascalCase, camelCase, `I` prefix, `$` suffix)
+- Code style (2-space indent, JSDoc)
+- Resource cleanup (destroy/unsubscribe)
+- Regression risk
+
+**When to use:** After finishing implementation, before creating a PR. Helps catch problems early.
+
+```bash
+./scripts/claude-review-files.sh          # auto-detect base branch
+./scripts/claude-review-files.sh dev      # review against dev
+```
+
+---
+
+### claude-pr-prep.sh
+
+Runs tests and generates a PR description from commit history and test results.
+
+**What it does:**
+1. Runs `npm test` and captures results
+2. Collects commit log between current and base branch
+3. Generates a structured PR description (Summary, Changes, Test plan)
+
+**When to use:** When the branch is ready for PR and you need a description.
+
+```bash
+./scripts/claude-pr-prep.sh              # auto-detect base branch
+./scripts/claude-pr-prep.sh dev          # prepare PR against dev
+```
+
+---
+
+### claude-full-check.sh
+
+Full pre-PR pipeline: runs review first, then PR preparation.
+
+**What it does:**
+1. Runs `claude-review-files.sh` — review code for issues
+2. Runs `claude-pr-prep.sh` — run tests and generate PR description
+
+**When to use:** Complete quality check before creating a PR. One command instead of two.
+
+```bash
+./scripts/claude-full-check.sh           # auto-detect base branch
+./scripts/claude-full-check.sh dev       # full check against dev
+```
+
+## Base Branch Detection
+
+All scripts auto-detect the base branch in this order: `dev` → `stage` → `main` → `master`. The first existing branch is used. You can override by passing the branch name as an argument.

package/scripts/claude-full-check.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+# scripts/claude-full-check.sh
+# Full pre-PR pipeline: review code, then prepare PR description.
+# Runs claude-review-files.sh first, then claude-pr-prep.sh.
+#
+# Usage:
+#   ./scripts/claude-full-check.sh          # auto-detect base branch
+#   ./scripts/claude-full-check.sh dev      # explicit base branch
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+BASE="${1:-}"
+
+echo "========================================="
+echo "  Step 1/2: Code Review"
+echo "========================================="
+echo ""
+
+"$SCRIPT_DIR/claude-review-files.sh" $BASE
+
+echo ""
+echo "========================================="
+echo "  Step 2/2: PR Preparation"
+echo "========================================="
+echo ""
+
+"$SCRIPT_DIR/claude-pr-prep.sh" $BASE
+
+echo ""
+echo "========================================="
+echo "  Done. Review the output above."
+echo "========================================="