@sola-air-ui/core 1.0.3 → 1.1.1

package/README.md

@@ -0,0 +1,48 @@
+# @sola-air-ui/core
+
+Zero-VDOM reactivity engine for [Sola AIR](https://sola-air.dev) — signals, derived values, effects, component lifecycle, and the `$intent` primitive. This is the runtime that compiled `.sola` components import; most apps won't call it directly (use `@sola-air-ui/compiler` or the `sola-air` meta-package instead), but it's published standalone for anyone embedding Sola-compiled output in a custom build pipeline.
+
+## Install
+
+```bash
+npm install @sola-air-ui/core
+```
+
+## What's in here
+
+- **Signals** — `createSignal`, `createDerived`, `createEffect`, `flushSync`
+- **Lifecycle** — `onMount`, `onDestroy`, `pushContext`/`popContext` (component-scoped mount/destroy queues)
+- **Data & intent** — `createData`, `createIntent`, `configureIntent` (ambient AI state resolution, with SSE streaming support)
+- **IIFE build** — `@sola-air-ui/core/iife` exports a pre-bundled `dist/sola-core.iife.js` for no-bundler environments (e.g. embedding in a CMS widget or a `<script>` tag), guarded so multiple copies on one page share a single instance via `window.SolaCore`.
+
+## Usage
+
+Compiled `.sola` output imports these directly:
+
+```js
+import { createSignal, createDerived, onMount } from '@sola-air-ui/core';
+
+const [count, setCount] = createSignal(0);
+const doubled = createDerived(() => count() * 2);
+
+onMount(() => {
+  console.log('mounted, doubled =', doubled());
+});
+```
+
+## Component lifecycle contract
+
+`pushContext()` / `popContext(ctx)` scope `onMount`/`onDestroy` callbacks to one component instance. If your own runtime code manually mounts nested components, always flush a component's mounts/destroys with the **specific context object** `pushContext()` returned for it — not by relying on whichever context happens to be globally "active":
+
+```js
+const ctx = pushContext();
+onMount(() => { /* ... */ });
+// ...build DOM, possibly mounting nested child components...
+__flush_mounts(ctx);   // pass ctx explicitly
+```
+
+This matters because a mounted child component's own context stays on the stack (it isn't popped until that child unmounts), so relying on implicit "current" context after nested mounts silently drops the parent's own mount callbacks. `@sola-air-ui/compiler`-generated code already does this correctly.
+
+## License
+
+MIT — see the [repo root](https://github.com/rbm3267/sola-air) for the full license and [changelog](https://github.com/rbm3267/sola-air/blob/main/CHANGELOG.md).

package/dist/sola-core.iife.js

@@ -40,6 +40,157 @@ var SolaCore = (() => {
     pushContext: () => pushContext,
     signalMesh: () => signalMesh
   });
+
+  // src/sentinel.js
+  var FIELD_BUFFER_MAX_EVENTS = 50;
+  var FIELD_BUFFER_WINDOW_MS = 6e4;
+  var FIELD_TEXT_PREVIEW_MAX_CHARS = 200;
+  function now() {
+    return typeof performance !== "undefined" ? performance.now() : Date.now();
+  }
+  var SolaSentinel = class {
+    constructor(name = "default", options = {}) {
+      this.name = name;
+      this.thresholdMs = options.thresholdMs || 600;
+      this.maxRageClicks = options.maxRageClicks || 3;
+      this.clickHistory = [];
+      this.subscribers = /* @__PURE__ */ new Set();
+      this.frictionEvents = [];
+      this.flowIndex = 99.8;
+      this.fieldHistory = [];
+      this.lastActivityAt = 0;
+      this.lastSuggestedAt = -Infinity;
+      this.idleThresholdMs = options.idleThresholdMs ?? 1500;
+      this.minSuggestIntervalMs = options.minSuggestIntervalMs ?? 8e3;
+      this.minEventsForSuggestion = options.minEventsForSuggestion ?? 2;
+    }
+    recordClick(actionId, target = "button") {
+      const ts = now();
+      this.clickHistory.push({ actionId, target, timestamp: ts });
+      this.clickHistory = this.clickHistory.filter((c) => ts - c.timestamp < 2e3);
+      const recent = this.clickHistory.filter((c) => c.actionId === actionId && ts - c.timestamp < this.thresholdMs);
+      if (recent.length >= this.maxRageClicks) {
+        this.triggerFrictionAlert({
+          type: "RAGE_CLICK",
+          actionId,
+          target,
+          count: recent.length,
+          timestamp: ts,
+          severity: "HIGH",
+          message: `Rage-click burst: ${recent.length} taps in ${Math.round(ts - recent[0].timestamp)}ms`
+        });
+      }
+    }
+    recordSignalDrop(topic, error) {
+      this.triggerFrictionAlert({
+        type: "SIGNAL_TIMEOUT",
+        topic,
+        error: error?.message || String(error),
+        timestamp: now(),
+        severity: "CRITICAL",
+        message: `Signal channel "${topic}" breached SLA timeout (504 Gateway Stall)`
+      });
+    }
+    triggerFrictionAlert(event) {
+      this.frictionEvents.unshift(event);
+      if (this.frictionEvents.length > 50) this.frictionEvents.pop();
+      this._recomputeFlowIndex(event.timestamp);
+      this.subscribers.forEach((cb) => {
+        try {
+          cb(event, this);
+        } catch (e) {
+          console.error(e);
+        }
+      });
+    }
+    onFriction(cb) {
+      this.subscribers.add(cb);
+      return () => this.subscribers.delete(cb);
+    }
+    // ─── Flow index ───
+    // A real computed score, not a fixed decrement: severity- and recency-weighted
+    // friction events, the share of field visits that were backtracks, plus how
+    // erratic the pacing between field events is (a proxy for hesitation).
+    _recomputeFlowIndex(ts = now()) {
+      let score = 99.8;
+      const recentFriction = this.frictionEvents.filter((e) => ts - e.timestamp < 12e4);
+      score -= recentFriction.reduce((sum, e) => {
+        const severityWeight = e.severity === "CRITICAL" ? 6 : e.severity === "HIGH" ? 3.8 : 2;
+        const recencyWeight = Math.max(0.3, 1 - (ts - e.timestamp) / 12e4);
+        return sum + severityWeight * recencyWeight;
+      }, 0);
+      const focusEvents = this.fieldHistory.filter((e) => e.type === "focus");
+      if (focusEvents.length > 0) {
+        const revisitRatio = focusEvents.filter((e) => e.revisit).length / focusEvents.length;
+        score -= revisitRatio * 15;
+      }
+      if (this.fieldHistory.length >= 3) {
+        const gaps = [];
+        for (let i = 1; i < this.fieldHistory.length; i++) {
+          gaps.push(this.fieldHistory[i].timestamp - this.fieldHistory[i - 1].timestamp);
+        }
+        const mean = gaps.reduce((a, b) => a + b, 0) / gaps.length;
+        const variance = gaps.reduce((sum, g) => sum + (g - mean) ** 2, 0) / gaps.length;
+        score -= Math.min(10, Math.sqrt(variance) / 500);
+      }
+      this.flowIndex = Math.max(0, Math.min(99.8, Number(score.toFixed(1))));
+      return this.flowIndex;
+    }
+    // ─── Ambient field observation ───
+    _pushFieldEvent(event) {
+      this.fieldHistory.push(event);
+      this.fieldHistory = this.fieldHistory.filter((e) => event.timestamp - e.timestamp < FIELD_BUFFER_WINDOW_MS).slice(-FIELD_BUFFER_MAX_EVENTS);
+      this.lastActivityAt = event.timestamp;
+      this._recomputeFlowIndex(event.timestamp);
+    }
+    recordFieldFocus(fieldId, ts = now()) {
+      const revisit = this.fieldHistory.some((e) => e.type === "blur" && e.fieldId === fieldId);
+      this._pushFieldEvent({ type: "focus", fieldId, revisit, timestamp: ts });
+      return revisit;
+    }
+    recordFieldBlur(fieldId, value, ts = now()) {
+      const text = String(value ?? "");
+      const preview = text.length > FIELD_TEXT_PREVIEW_MAX_CHARS ? text.slice(-FIELD_TEXT_PREVIEW_MAX_CHARS) : text;
+      this._pushFieldEvent({ type: "blur", fieldId, valuePreview: preview, valueLength: text.length, timestamp: ts });
+    }
+    // ─── Significance gate ───
+    // Fires at most once per `minSuggestIntervalMs`, only after `idleThresholdMs`
+    // of inactivity following new activity — never on every keystroke.
+    checkSignificance(ts = now()) {
+      if (this.fieldHistory.length < this.minEventsForSuggestion) return false;
+      if (this.lastActivityAt <= this.lastSuggestedAt) return false;
+      if (ts - this.lastActivityAt < this.idleThresholdMs) return false;
+      if (ts - this.lastSuggestedAt < this.minSuggestIntervalMs) return false;
+      this.lastSuggestedAt = ts;
+      return true;
+    }
+    // ─── Prompt builder ───
+    // Compact natural-language description of recent field activity, oldest first.
+    buildPrompt() {
+      if (this.fieldHistory.length === 0) return null;
+      const lines = this.fieldHistory.map((e) => {
+        if (e.type === "focus") {
+          return e.revisit ? `User returned to field "${e.fieldId}".` : `User focused field "${e.fieldId}".`;
+        }
+        if (e.valueLength === 0) return `User left field "${e.fieldId}" empty.`;
+        return `Field "${e.fieldId}" now contains: "${e.valuePreview}"`;
+      });
+      return [
+        "You are an ambient UX assistant embedded in a form.",
+        "Recent user activity, oldest first:",
+        ...lines,
+        "",
+        "Based only on this activity, suggest exactly one concise, specific next-step action the user might want.",
+        'Respond as compact JSON only: {"label": string (<=60 chars), "action": string (<=140 chars), "confidence": number 0-1}.',
+        'If nothing useful can be suggested, respond {"label": null}.'
+      ].join("\n");
+    }
+  };
+  function createSentinel(name, options) {
+    return new SolaSentinel(name, options);
+  }
+
+  // src/index.js
   var effectStack = [];
   var pendingEffects = /* @__PURE__ */ new Set();
   var isFlushing = false;
@@ -181,19 +332,19 @@ var SolaCore = (() => {
       activeContext.destroys.push(fn);
     }
   }
-  function __flush_mounts() {
-    if (activeContext && activeContext.mounts.length > 0) {
-      const cbs = [...activeContext.mounts];
-      activeContext.mounts = [];
+  function __flush_mounts(ctx = activeContext) {
+    if (ctx && ctx.mounts.length > 0) {
+      const cbs = [...ctx.mounts];
+      ctx.mounts = [];
       for (const cb of cbs) {
         cb();
       }
     }
   }
-  function __flush_destroys() {
-    if (activeContext && activeContext.destroys.length > 0) {
-      const cbs = [...activeContext.destroys];
-      activeContext.destroys = [];
+  function __flush_destroys(ctx = activeContext) {
+    if (ctx && ctx.destroys.length > 0) {
+      const cbs = [...ctx.destroys];
+      ctx.destroys = [];
       for (const cb of cbs) {
         cb();
       }
@@ -442,62 +593,5 @@ var SolaCore = (() => {
   };
   var signalMesh = new SignalMeshEngine();
   var createTopicSignal = (topic, initialVal) => signalMesh.topic(topic, initialVal);
-  var SolaSentinel = class {
-    constructor(name = "default", options = {}) {
-      this.name = name;
-      this.thresholdMs = options.thresholdMs || 600;
-      this.maxRageClicks = options.maxRageClicks || 3;
-      this.clickHistory = [];
-      this.subscribers = /* @__PURE__ */ new Set();
-      this.frictionEvents = [];
-      this.flowIndex = 99.8;
-    }
-    recordClick(actionId, target = "button") {
-      const now = typeof performance !== "undefined" ? performance.now() : Date.now();
-      this.clickHistory.push({ actionId, target, timestamp: now });
-      this.clickHistory = this.clickHistory.filter((c) => now - c.timestamp < 2e3);
-      const recent = this.clickHistory.filter((c) => c.actionId === actionId && now - c.timestamp < this.thresholdMs);
-      if (recent.length >= this.maxRageClicks) {
-        this.triggerFrictionAlert({
-          type: "RAGE_CLICK",
-          actionId,
-          target,
-          count: recent.length,
-          timestamp: now,
-          severity: "HIGH",
-          message: `Rage-click burst: ${recent.length} taps in ${Math.round(now - recent[0].timestamp)}ms`
-        });
-      }
-    }
-    recordSignalDrop(topic, error) {
-      this.triggerFrictionAlert({
-        type: "SIGNAL_TIMEOUT",
-        topic,
-        error: error?.message || String(error),
-        timestamp: typeof performance !== "undefined" ? performance.now() : Date.now(),
-        severity: "CRITICAL",
-        message: `Signal channel "${topic}" breached SLA timeout (504 Gateway Stall)`
-      });
-    }
-    triggerFrictionAlert(event) {
-      this.frictionEvents.unshift(event);
-      if (this.frictionEvents.length > 50) this.frictionEvents.pop();
-      this.flowIndex = Math.max(68.5, Number((this.flowIndex - 3.8).toFixed(1)));
-      this.subscribers.forEach((cb) => {
-        try {
-          cb(event, this);
-        } catch (e) {
-          console.error(e);
-        }
-      });
-    }
-    onFriction(cb) {
-      this.subscribers.add(cb);
-      return () => this.subscribers.delete(cb);
-    }
-  };
-  function createSentinel(name, options) {
-    return new SolaSentinel(name, options);
-  }
   return __toCommonJS(src_exports);
 })();

package/dist/sola-core.iife.min.js

@@ -1,3 +1,4 @@
 /* @sola-air-ui/core v1.0.2 | MIT */
-var SolaCore=(()=>{var v=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var $=(r,e)=>{for(var t in e)v(r,t,{get:e[t],enumerable:!0})},N=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of H(e))!R.call(r,s)&&s!==t&&v(r,s,{get:()=>e[s],enumerable:!(n=O(e,s))||n.enumerable});return r};var F=r=>N(v({},"__esModule",{value:!0}),r);var ee={};$(ee,{SolaSentinel:()=>S,__flush_destroys:()=>P,__flush_mounts:()=>J,configureData:()=>B,configureIntent:()=>z,createData:()=>X,createDerived:()=>L,createEffect:()=>M,createIntent:()=>U,createSentinel:()=>Z,createSignal:()=>b,createTopicSignal:()=>Y,flushSync:()=>D,onDestroy:()=>T,onMount:()=>G,popContext:()=>q,pushContext:()=>j,signalMesh:()=>_});var p=[],w=new Set,E=!1;function D(){for(;w.size>0;){let r=[...w];w.clear();for(let e of r)e.execute()}E=!1}function A(){E||(E=!0,queueMicrotask(D))}function b(r){let e=r,t=new Set;return[()=>{let o=p[p.length-1];return o&&(t.add(o),o.dependencies.add(t)),e},o=>{if(e!==o){e=o;for(let i of[...t])w.add(i);A()}}]}function M(r){let e={execute(){t(),p.push(e);try{r()}finally{p.pop()}},dependencies:new Set,cleanup:t};function t(){for(let n of e.dependencies)n.delete(e);e.dependencies.clear()}p.push(e);try{r()}finally{p.pop()}return t}function L(r){let e,t=!0,n=new Set,s=new Set,o={execute(){if(!t){t=!0;for(let c of[...n])w.add(c);A()}},dependencies:s,cleanup(){for(let c of s)c.delete(o);s.clear()}};return()=>{let c=p[p.length-1];if(c&&(n.add(c),c.dependencies.add(n)),t){o.cleanup(),s=new Set,o.dependencies=s,p.push(o);try{e=r()}finally{p.pop()}t=!1}return e}}var m=[],u=null;function j(){let r={mounts:[],destroys:[]};return m.push(r),u=r,r}function q(r){let e=m.lastIndexOf(r);e!==-1&&m.splice(e,1),u=m.length>0?m[m.length-1]:null}function G(r){u?u.mounts.push(r):r()}function T(r){u&&u.destroys.push(r)}function J(){if(u&&u.mounts.length>0){let r=[...u.mounts];u.mounts=[];for(let e of r)e()}}function P(){if(u&&u.destroys.length>0){let r=[...u.destroys];u.destroys=[];for(let e of r)e()}}var W={provider:"local",endpoint:"/api/intent",model:"gemini-2.5-flash",stream:!1},k={...W};function z(r){k={...k,...r}}async function K(r,e,t,n){let s=r.body.getReader(),o=new TextDecoder,i="";try{for(;;){let{done:c,value:f}=await s.read();if(c)break;i+=o.decode(f,{stream:!0});let a=i.split(`
-`);i=a.pop();for(let l of a){if(!l.startsWith("data: "))continue;let d=l.slice(6).trim();if(d==="[DONE]"){t();return}try{let g=JSON.parse(d),h=g.token??g.delta??g.content??"";h&&e(h)}catch{d&&e(d)}}}t()}catch(c){c.name!=="AbortError"&&n(c)}}function U(r,e={}){let t={...k,...e},[n,s]=b(e.initial??null),[o,i]=b(!1),[c,f]=b(null),a=null;T(()=>{a&&a.abort()}),M(()=>{let d=typeof r=="function"?r():r;if(!d)return;a&&a.abort(),a=new AbortController,s(null),f(null),i(!0);let g=JSON.stringify({messages:[{role:"user",content:d}],model:t.model,provider:t.provider,stream:t.stream});fetch(t.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:g,signal:a.signal}).then(h=>{if(!h.ok)throw new Error(`Intent failed: ${h.status}`);if(t.stream){let y="";return K(h,x=>{y+=x,s(y)},()=>i(!1),x=>{f(x.message),i(!1)})}return h.json().then(y=>{y?.components?.length>0?s(y.components[0]):y?.result!=null?s(y.result):s(y),i(!1)})}).catch(h=>{h.name!=="AbortError"&&(console.error("[Sola Intent Error]",h),f(h.message),i(!1))})});let l=n;return l.loading=o,l.error=c,l}var V={relayEndpoint:"http://localhost:4040/api/query",refresh:null},C={...V};function B(r){C={...C,...r}}function Q(r){if(!r)return null;let e=r.match(/^(\d+)(s|m|h)$/);if(!e)return null;let t=parseInt(e[1]);switch(e[2]){case"s":return t*1e3;case"m":return t*60*1e3;case"h":return t*3600*1e3}return null}function X(r,e={}){let t={...C,...e},[n,s]=b({loading:!0,data:null,error:null}),o=null,i=null;function c(){o&&o.abort(),o=new AbortController,s({loading:!0,data:n().data,error:null}),fetch(t.relayEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({source:r,query:t.query||null,filters:t.filters||null,sort:t.sort||null,limit:t.limit||null,offset:t.offset||null}),signal:o.signal}).then(l=>{if(!l.ok)throw new Error(`Data fetch failed: ${l.status}`);return l.json()}).then(l=>{s({loading:!1,data:l.rows||l,error:null})}).catch(l=>{l.name!=="AbortError"&&(console.error("[Sola Data Error]",l),s({loading:!1,data:null,error:l.message}))})}c();let f=Q(t.refresh);f&&(i=setInterval(c,f));let a=()=>n();return a.refetch=c,a.stop=()=>{i&&clearInterval(i),o&&o.abort()},a}var I=class{constructor(){this.topics=new Map,this.telemetrySubscribers=new Set,this.cycleStack=new Set}topic(e,t){if(!this.topics.has(e)){let[i,c]=b(t);this.topics.set(e,{read:i,write:c,value:t,subscribers:new Set})}let n=this.topics.get(e);return[()=>n.read(),(i,c="signal")=>{let f=typeof i=="function"?i(n.value):i;if(n.value===f)return;if(this.cycleStack.has(e)){console.warn(`[Sola Signal Mesh] Cycle detected on topic "${e}". Aborting cyclic dispatch.`);return}let a=n.value;n.value=f,n.write(f);let l={topic:e,value:f,prevValue:a,timestamp:typeof performance<"u"?performance.now():Date.now(),originWidgetId:c};this.telemetrySubscribers.forEach(d=>{try{d(l)}catch(g){console.error(g)}}),this.cycleStack.add(e);try{n.subscribers.forEach(d=>{try{d(f,l)}catch(g){console.error(g)}})}finally{this.cycleStack.delete(e)}}]}subscribe(e,t){this.topics.has(e)||this.topic(e,void 0);let n=this.topics.get(e);return n.subscribers.add(t),()=>n.subscribers.delete(t)}onTelemetry(e){return this.telemetrySubscribers.add(e),()=>this.telemetrySubscribers.delete(e)}},_=new I,Y=(r,e)=>_.topic(r,e),S=class{constructor(e="default",t={}){this.name=e,this.thresholdMs=t.thresholdMs||600,this.maxRageClicks=t.maxRageClicks||3,this.clickHistory=[],this.subscribers=new Set,this.frictionEvents=[],this.flowIndex=99.8}recordClick(e,t="button"){let n=typeof performance<"u"?performance.now():Date.now();this.clickHistory.push({actionId:e,target:t,timestamp:n}),this.clickHistory=this.clickHistory.filter(o=>n-o.timestamp<2e3);let s=this.clickHistory.filter(o=>o.actionId===e&&n-o.timestamp<this.thresholdMs);s.length>=this.maxRageClicks&&this.triggerFrictionAlert({type:"RAGE_CLICK",actionId:e,target:t,count:s.length,timestamp:n,severity:"HIGH",message:`Rage-click burst: ${s.length} taps in ${Math.round(n-s[0].timestamp)}ms`})}recordSignalDrop(e,t){this.triggerFrictionAlert({type:"SIGNAL_TIMEOUT",topic:e,error:t?.message||String(t),timestamp:typeof performance<"u"?performance.now():Date.now(),severity:"CRITICAL",message:`Signal channel "${e}" breached SLA timeout (504 Gateway Stall)`})}triggerFrictionAlert(e){this.frictionEvents.unshift(e),this.frictionEvents.length>50&&this.frictionEvents.pop(),this.flowIndex=Math.max(68.5,Number((this.flowIndex-3.8).toFixed(1))),this.subscribers.forEach(t=>{try{t(e,this)}catch(n){console.error(n)}})}onFriction(e){return this.subscribers.add(e),()=>this.subscribers.delete(e)}};function Z(r,e){return new S(r,e)}return F(ee);})();
+var SolaCore=(()=>{var I=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var N=(s,t)=>{for(var e in t)I(s,e,{get:t[e],enumerable:!0})},O=(s,t,e,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of L(t))!$.call(s,i)&&i!==e&&I(s,i,{get:()=>t[i],enumerable:!(n=R(t,i))||n.enumerable});return s};var W=s=>O(I({},"__esModule",{value:!0}),s);var et={};N(et,{SolaSentinel:()=>E,__flush_destroys:()=>j,__flush_mounts:()=>V,configureData:()=>Y,configureIntent:()=>G,createData:()=>Z,createDerived:()=>U,createEffect:()=>D,createIntent:()=>z,createSentinel:()=>C,createSignal:()=>S,createTopicSignal:()=>tt,flushSync:()=>M,onDestroy:()=>k,onMount:()=>B,popContext:()=>P,pushContext:()=>X,signalMesh:()=>T});function y(){return typeof performance<"u"?performance.now():Date.now()}var E=class{constructor(t="default",e={}){this.name=t,this.thresholdMs=e.thresholdMs||600,this.maxRageClicks=e.maxRageClicks||3,this.clickHistory=[],this.subscribers=new Set,this.frictionEvents=[],this.flowIndex=99.8,this.fieldHistory=[],this.lastActivityAt=0,this.lastSuggestedAt=-1/0,this.idleThresholdMs=e.idleThresholdMs??1500,this.minSuggestIntervalMs=e.minSuggestIntervalMs??8e3,this.minEventsForSuggestion=e.minEventsForSuggestion??2}recordClick(t,e="button"){let n=y();this.clickHistory.push({actionId:t,target:e,timestamp:n}),this.clickHistory=this.clickHistory.filter(r=>n-r.timestamp<2e3);let i=this.clickHistory.filter(r=>r.actionId===t&&n-r.timestamp<this.thresholdMs);i.length>=this.maxRageClicks&&this.triggerFrictionAlert({type:"RAGE_CLICK",actionId:t,target:e,count:i.length,timestamp:n,severity:"HIGH",message:`Rage-click burst: ${i.length} taps in ${Math.round(n-i[0].timestamp)}ms`})}recordSignalDrop(t,e){this.triggerFrictionAlert({type:"SIGNAL_TIMEOUT",topic:t,error:e?.message||String(e),timestamp:y(),severity:"CRITICAL",message:`Signal channel "${t}" breached SLA timeout (504 Gateway Stall)`})}triggerFrictionAlert(t){this.frictionEvents.unshift(t),this.frictionEvents.length>50&&this.frictionEvents.pop(),this._recomputeFlowIndex(t.timestamp),this.subscribers.forEach(e=>{try{e(t,this)}catch(n){console.error(n)}})}onFriction(t){return this.subscribers.add(t),()=>this.subscribers.delete(t)}_recomputeFlowIndex(t=y()){let e=99.8,n=this.frictionEvents.filter(r=>t-r.timestamp<12e4);e-=n.reduce((r,o)=>{let l=o.severity==="CRITICAL"?6:o.severity==="HIGH"?3.8:2,c=Math.max(.3,1-(t-o.timestamp)/12e4);return r+l*c},0);let i=this.fieldHistory.filter(r=>r.type==="focus");if(i.length>0){let r=i.filter(o=>o.revisit).length/i.length;e-=r*15}if(this.fieldHistory.length>=3){let r=[];for(let c=1;c<this.fieldHistory.length;c++)r.push(this.fieldHistory[c].timestamp-this.fieldHistory[c-1].timestamp);let o=r.reduce((c,u)=>c+u,0)/r.length,l=r.reduce((c,u)=>c+(u-o)**2,0)/r.length;e-=Math.min(10,Math.sqrt(l)/500)}return this.flowIndex=Math.max(0,Math.min(99.8,Number(e.toFixed(1)))),this.flowIndex}_pushFieldEvent(t){this.fieldHistory.push(t),this.fieldHistory=this.fieldHistory.filter(e=>t.timestamp-e.timestamp<6e4).slice(-50),this.lastActivityAt=t.timestamp,this._recomputeFlowIndex(t.timestamp)}recordFieldFocus(t,e=y()){let n=this.fieldHistory.some(i=>i.type==="blur"&&i.fieldId===t);return this._pushFieldEvent({type:"focus",fieldId:t,revisit:n,timestamp:e}),n}recordFieldBlur(t,e,n=y()){let i=String(e??""),r=i.length>200?i.slice(-200):i;this._pushFieldEvent({type:"blur",fieldId:t,valuePreview:r,valueLength:i.length,timestamp:n})}checkSignificance(t=y()){return this.fieldHistory.length<this.minEventsForSuggestion||this.lastActivityAt<=this.lastSuggestedAt||t-this.lastActivityAt<this.idleThresholdMs||t-this.lastSuggestedAt<this.minSuggestIntervalMs?!1:(this.lastSuggestedAt=t,!0)}buildPrompt(){return this.fieldHistory.length===0?null:["You are an ambient UX assistant embedded in a form.","Recent user activity, oldest first:",...this.fieldHistory.map(e=>e.type==="focus"?e.revisit?`User returned to field "${e.fieldId}".`:`User focused field "${e.fieldId}".`:e.valueLength===0?`User left field "${e.fieldId}" empty.`:`Field "${e.fieldId}" now contains: "${e.valuePreview}"`),"","Based only on this activity, suggest exactly one concise, specific next-step action the user might want.",'Respond as compact JSON only: {"label": string (<=60 chars), "action": string (<=140 chars), "confidence": number 0-1}.','If nothing useful can be suggested, respond {"label": null}.'].join(`
+`)}};function C(s,t){return new E(s,t)}var h=[],v=new Set,_=!1;function M(){for(;v.size>0;){let s=[...v];v.clear();for(let t of s)t.execute()}_=!1}function H(){_||(_=!0,queueMicrotask(M))}function S(s){let t=s,e=new Set;return[()=>{let r=h[h.length-1];return r&&(e.add(r),r.dependencies.add(e)),t},r=>{if(t!==r){t=r;for(let o of[...e])v.add(o);H()}}]}function D(s){let t={execute(){e(),h.push(t);try{s()}finally{h.pop()}},dependencies:new Set,cleanup:e};function e(){for(let n of t.dependencies)n.delete(t);t.dependencies.clear()}h.push(t);try{s()}finally{h.pop()}return e}function U(s){let t,e=!0,n=new Set,i=new Set,r={execute(){if(!e){e=!0;for(let l of[...n])v.add(l);H()}},dependencies:i,cleanup(){for(let l of i)l.delete(r);i.clear()}};return()=>{let l=h[h.length-1];if(l&&(n.add(l),l.dependencies.add(n)),e){r.cleanup(),i=new Set,r.dependencies=i,h.push(r);try{t=s()}finally{h.pop()}e=!1}return t}}var b=[],m=null;function X(){let s={mounts:[],destroys:[]};return b.push(s),m=s,s}function P(s){let t=b.lastIndexOf(s);t!==-1&&b.splice(t,1),m=b.length>0?b[b.length-1]:null}function B(s){m?m.mounts.push(s):s()}function k(s){m&&m.destroys.push(s)}function V(s=m){if(s&&s.mounts.length>0){let t=[...s.mounts];s.mounts=[];for(let e of t)e()}}function j(s=m){if(s&&s.destroys.length>0){let t=[...s.destroys];s.destroys=[];for(let e of t)e()}}var q={provider:"local",endpoint:"/api/intent",model:"gemini-2.5-flash",stream:!1},x={...q};function G(s){x={...x,...s}}async function J(s,t,e,n){let i=s.body.getReader(),r=new TextDecoder,o="";try{for(;;){let{done:l,value:c}=await i.read();if(l)break;o+=r.decode(c,{stream:!0});let u=o.split(`
+`);o=u.pop();for(let a of u){if(!a.startsWith("data: "))continue;let f=a.slice(6).trim();if(f==="[DONE]"){e();return}try{let p=JSON.parse(f),d=p.token??p.delta??p.content??"";d&&t(d)}catch{f&&t(f)}}}e()}catch(l){l.name!=="AbortError"&&n(l)}}function z(s,t={}){let e={...x,...t},[n,i]=S(t.initial??null),[r,o]=S(!1),[l,c]=S(null),u=null;k(()=>{u&&u.abort()}),D(()=>{let f=typeof s=="function"?s():s;if(!f)return;u&&u.abort(),u=new AbortController,i(null),c(null),o(!0);let p=JSON.stringify({messages:[{role:"user",content:f}],model:e.model,provider:e.provider,stream:e.stream});fetch(e.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:p,signal:u.signal}).then(d=>{if(!d.ok)throw new Error(`Intent failed: ${d.status}`);if(e.stream){let g="";return J(d,w=>{g+=w,i(g)},()=>o(!1),w=>{c(w.message),o(!1)})}return d.json().then(g=>{g?.components?.length>0?i(g.components[0]):g?.result!=null?i(g.result):i(g),o(!1)})}).catch(d=>{d.name!=="AbortError"&&(console.error("[Sola Intent Error]",d),c(d.message),o(!1))})});let a=n;return a.loading=r,a.error=l,a}var K={relayEndpoint:"http://localhost:4040/api/query",refresh:null},A={...K};function Y(s){A={...A,...s}}function Q(s){if(!s)return null;let t=s.match(/^(\d+)(s|m|h)$/);if(!t)return null;let e=parseInt(t[1]);switch(t[2]){case"s":return e*1e3;case"m":return e*60*1e3;case"h":return e*3600*1e3}return null}function Z(s,t={}){let e={...A,...t},[n,i]=S({loading:!0,data:null,error:null}),r=null,o=null;function l(){r&&r.abort(),r=new AbortController,i({loading:!0,data:n().data,error:null}),fetch(e.relayEndpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({source:s,query:e.query||null,filters:e.filters||null,sort:e.sort||null,limit:e.limit||null,offset:e.offset||null}),signal:r.signal}).then(a=>{if(!a.ok)throw new Error(`Data fetch failed: ${a.status}`);return a.json()}).then(a=>{i({loading:!1,data:a.rows||a,error:null})}).catch(a=>{a.name!=="AbortError"&&(console.error("[Sola Data Error]",a),i({loading:!1,data:null,error:a.message}))})}l();let c=Q(e.refresh);c&&(o=setInterval(l,c));let u=()=>n();return u.refetch=l,u.stop=()=>{o&&clearInterval(o),r&&r.abort()},u}var F=class{constructor(){this.topics=new Map,this.telemetrySubscribers=new Set,this.cycleStack=new Set}topic(t,e){if(!this.topics.has(t)){let[o,l]=S(e);this.topics.set(t,{read:o,write:l,value:e,subscribers:new Set})}let n=this.topics.get(t);return[()=>n.read(),(o,l="signal")=>{let c=typeof o=="function"?o(n.value):o;if(n.value===c)return;if(this.cycleStack.has(t)){console.warn(`[Sola Signal Mesh] Cycle detected on topic "${t}". Aborting cyclic dispatch.`);return}let u=n.value;n.value=c,n.write(c);let a={topic:t,value:c,prevValue:u,timestamp:typeof performance<"u"?performance.now():Date.now(),originWidgetId:l};this.telemetrySubscribers.forEach(f=>{try{f(a)}catch(p){console.error(p)}}),this.cycleStack.add(t);try{n.subscribers.forEach(f=>{try{f(c,a)}catch(p){console.error(p)}})}finally{this.cycleStack.delete(t)}}]}subscribe(t,e){this.topics.has(t)||this.topic(t,void 0);let n=this.topics.get(t);return n.subscribers.add(e),()=>n.subscribers.delete(e)}onTelemetry(t){return this.telemetrySubscribers.add(t),()=>this.telemetrySubscribers.delete(t)}},T=new F,tt=(s,t)=>T.topic(s,t);return W(et);})();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sola-air-ui/core",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "description": "Zero-VDOM reactivity engine — signals, effects, lifecycle, and intent primitives",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -178,22 +178,34 @@ export function onDestroy(fn) {
   }
 }
 
-// Called by compiled mount() function to flush instance mounts
-export function __flush_mounts() {
-  if (activeContext && activeContext.mounts.length > 0) {
-    const cbs = [...activeContext.mounts];
-    activeContext.mounts = [];
+// Called by compiled mount() function to flush instance mounts.
+//
+// Takes the specific context to flush (the one `pushContext()` returned for
+// THIS component instance) rather than trusting the module-global
+// `activeContext`. If a nested child component mounts during this
+// component's own DOM construction, the child's own pushContext() call
+// reassigns `activeContext` to the child's context and never pops it back
+// (a mounted child stays on the stack until it unmounts) — so by the time
+// the parent reaches its own flush call, `activeContext` no longer points
+// at the parent. Falls back to `activeContext` when called with no
+// argument, for compiled bundles built before this fix.
+export function __flush_mounts(ctx = activeContext) {
+  if (ctx && ctx.mounts.length > 0) {
+    const cbs = [...ctx.mounts];
+    ctx.mounts = [];
     for (const cb of cbs) {
       cb();
     }
   }
 }
 
-// Called when a component is torn down
-export function __flush_destroys() {
-  if (activeContext && activeContext.destroys.length > 0) {
-    const cbs = [...activeContext.destroys];
-    activeContext.destroys = [];
+// Called when a component is torn down. Same explicit-context fix as
+// __flush_mounts above — see that comment for why activeContext alone
+// isn't reliable once nested components are involved.
+export function __flush_destroys(ctx = activeContext) {
+  if (ctx && ctx.destroys.length > 0) {
+    const cbs = [...ctx.destroys];
+    ctx.destroys = [];
     for (const cb of cbs) {
       cb();
     }
@@ -476,65 +488,8 @@ class SignalMeshEngine {
 export const signalMesh = new SignalMeshEngine();
 export const createTopicSignal = (topic, initialVal) => signalMesh.topic(topic, initialVal);
 
-// ─── Sola Sentinel & Intent Telemetry Observer ───
-export class SolaSentinel {
-  constructor(name = 'default', options = {}) {
-    this.name = name;
-    this.thresholdMs = options.thresholdMs || 600;
-    this.maxRageClicks = options.maxRageClicks || 3;
-    this.clickHistory = [];
-    this.subscribers = new Set();
-    this.frictionEvents = [];
-    this.flowIndex = 99.8;
-  }
-
-  recordClick(actionId, target = 'button') {
-    const now = typeof performance !== 'undefined' ? performance.now() : Date.now();
-    this.clickHistory.push({ actionId, target, timestamp: now });
-    this.clickHistory = this.clickHistory.filter(c => now - c.timestamp < 2000);
-    
-    const recent = this.clickHistory.filter(c => c.actionId === actionId && now - c.timestamp < this.thresholdMs);
-    if (recent.length >= this.maxRageClicks) {
-      this.triggerFrictionAlert({
-        type: 'RAGE_CLICK',
-        actionId,
-        target,
-        count: recent.length,
-        timestamp: now,
-        severity: 'HIGH',
-        message: `Rage-click burst: ${recent.length} taps in ${Math.round(now - recent[0].timestamp)}ms`
-      });
-    }
-  }
-
-  recordSignalDrop(topic, error) {
-    this.triggerFrictionAlert({
-      type: 'SIGNAL_TIMEOUT',
-      topic,
-      error: error?.message || String(error),
-      timestamp: typeof performance !== 'undefined' ? performance.now() : Date.now(),
-      severity: 'CRITICAL',
-      message: `Signal channel "${topic}" breached SLA timeout (504 Gateway Stall)`
-    });
-  }
-
-  triggerFrictionAlert(event) {
-    this.frictionEvents.unshift(event);
-    if (this.frictionEvents.length > 50) this.frictionEvents.pop();
-    this.flowIndex = Math.max(68.5, Number((this.flowIndex - 3.8).toFixed(1)));
-    
-    this.subscribers.forEach(cb => {
-      try { cb(event, this); } catch(e) { console.error(e); }
-    });
-  }
-
-  onFriction(cb) {
-    this.subscribers.add(cb);
-    return () => this.subscribers.delete(cb);
-  }
-}
-
-export function createSentinel(name, options) {
-  return new SolaSentinel(name, options);
-}
+// ─── Sola Sentinel & Ambient Intent Telemetry Observer ───
+// Moved to sentinel.js — friction/rage-click detection, plus ambient
+// field-behavior capture, significance gating, and prompt building.
+export { SolaSentinel, createSentinel } from './sentinel.js';
 

package/src/sentinel.js

@@ -0,0 +1,179 @@
+// ─── Sola Sentinel & Ambient Intent Telemetry Observer ───
+// Rage-click / signal-drop friction detection, plus ambient field-level
+// behavior capture (focus, revisit, blur-with-value) feeding a debounced
+// significance gate and a prompt builder for $intent-driven suggestions.
+
+const FIELD_BUFFER_MAX_EVENTS = 50;
+const FIELD_BUFFER_WINDOW_MS = 60_000;
+const FIELD_TEXT_PREVIEW_MAX_CHARS = 200;
+
+function now() {
+  return typeof performance !== 'undefined' ? performance.now() : Date.now();
+}
+
+export class SolaSentinel {
+  constructor(name = 'default', options = {}) {
+    this.name = name;
+    this.thresholdMs = options.thresholdMs || 600;
+    this.maxRageClicks = options.maxRageClicks || 3;
+    this.clickHistory = [];
+    this.subscribers = new Set();
+    this.frictionEvents = [];
+    this.flowIndex = 99.8;
+
+    // Ambient field-behavior observation
+    this.fieldHistory = [];
+    this.lastActivityAt = 0;
+    this.lastSuggestedAt = -Infinity;
+    this.idleThresholdMs = options.idleThresholdMs ?? 1500;
+    this.minSuggestIntervalMs = options.minSuggestIntervalMs ?? 8000;
+    this.minEventsForSuggestion = options.minEventsForSuggestion ?? 2;
+  }
+
+  recordClick(actionId, target = 'button') {
+    const ts = now();
+    this.clickHistory.push({ actionId, target, timestamp: ts });
+    this.clickHistory = this.clickHistory.filter(c => ts - c.timestamp < 2000);
+
+    const recent = this.clickHistory.filter(c => c.actionId === actionId && ts - c.timestamp < this.thresholdMs);
+    if (recent.length >= this.maxRageClicks) {
+      this.triggerFrictionAlert({
+        type: 'RAGE_CLICK',
+        actionId,
+        target,
+        count: recent.length,
+        timestamp: ts,
+        severity: 'HIGH',
+        message: `Rage-click burst: ${recent.length} taps in ${Math.round(ts - recent[0].timestamp)}ms`
+      });
+    }
+  }
+
+  recordSignalDrop(topic, error) {
+    this.triggerFrictionAlert({
+      type: 'SIGNAL_TIMEOUT',
+      topic,
+      error: error?.message || String(error),
+      timestamp: now(),
+      severity: 'CRITICAL',
+      message: `Signal channel "${topic}" breached SLA timeout (504 Gateway Stall)`
+    });
+  }
+
+  triggerFrictionAlert(event) {
+    this.frictionEvents.unshift(event);
+    if (this.frictionEvents.length > 50) this.frictionEvents.pop();
+    this._recomputeFlowIndex(event.timestamp);
+
+    this.subscribers.forEach(cb => {
+      try { cb(event, this); } catch (e) { console.error(e); }
+    });
+  }
+
+  onFriction(cb) {
+    this.subscribers.add(cb);
+    return () => this.subscribers.delete(cb);
+  }
+
+  // ─── Flow index ───
+  // A real computed score, not a fixed decrement: severity- and recency-weighted
+  // friction events, the share of field visits that were backtracks, plus how
+  // erratic the pacing between field events is (a proxy for hesitation).
+  _recomputeFlowIndex(ts = now()) {
+    let score = 99.8;
+
+    const recentFriction = this.frictionEvents.filter(e => ts - e.timestamp < 120_000);
+    score -= recentFriction.reduce((sum, e) => {
+      const severityWeight = e.severity === 'CRITICAL' ? 6 : e.severity === 'HIGH' ? 3.8 : 2;
+      const recencyWeight = Math.max(0.3, 1 - (ts - e.timestamp) / 120_000);
+      return sum + severityWeight * recencyWeight;
+    }, 0);
+
+    const focusEvents = this.fieldHistory.filter(e => e.type === 'focus');
+    if (focusEvents.length > 0) {
+      const revisitRatio = focusEvents.filter(e => e.revisit).length / focusEvents.length;
+      score -= revisitRatio * 15;
+    }
+
+    if (this.fieldHistory.length >= 3) {
+      const gaps = [];
+      for (let i = 1; i < this.fieldHistory.length; i++) {
+        gaps.push(this.fieldHistory[i].timestamp - this.fieldHistory[i - 1].timestamp);
+      }
+      const mean = gaps.reduce((a, b) => a + b, 0) / gaps.length;
+      const variance = gaps.reduce((sum, g) => sum + (g - mean) ** 2, 0) / gaps.length;
+      score -= Math.min(10, Math.sqrt(variance) / 500);
+    }
+
+    this.flowIndex = Math.max(0, Math.min(99.8, Number(score.toFixed(1))));
+    return this.flowIndex;
+  }
+
+  // ─── Ambient field observation ───
+
+  _pushFieldEvent(event) {
+    this.fieldHistory.push(event);
+    this.fieldHistory = this.fieldHistory
+      .filter(e => event.timestamp - e.timestamp < FIELD_BUFFER_WINDOW_MS)
+      .slice(-FIELD_BUFFER_MAX_EVENTS);
+    this.lastActivityAt = event.timestamp;
+    this._recomputeFlowIndex(event.timestamp);
+  }
+
+  recordFieldFocus(fieldId, ts = now()) {
+    const revisit = this.fieldHistory.some(e => e.type === 'blur' && e.fieldId === fieldId);
+    this._pushFieldEvent({ type: 'focus', fieldId, revisit, timestamp: ts });
+    return revisit;
+  }
+
+  recordFieldBlur(fieldId, value, ts = now()) {
+    const text = String(value ?? '');
+    const preview = text.length > FIELD_TEXT_PREVIEW_MAX_CHARS
+      ? text.slice(-FIELD_TEXT_PREVIEW_MAX_CHARS)
+      : text;
+    this._pushFieldEvent({ type: 'blur', fieldId, valuePreview: preview, valueLength: text.length, timestamp: ts });
+  }
+
+  // ─── Significance gate ───
+  // Fires at most once per `minSuggestIntervalMs`, only after `idleThresholdMs`
+  // of inactivity following new activity — never on every keystroke.
+  checkSignificance(ts = now()) {
+    if (this.fieldHistory.length < this.minEventsForSuggestion) return false;
+    if (this.lastActivityAt <= this.lastSuggestedAt) return false;
+    if (ts - this.lastActivityAt < this.idleThresholdMs) return false;
+    if (ts - this.lastSuggestedAt < this.minSuggestIntervalMs) return false;
+
+    this.lastSuggestedAt = ts;
+    return true;
+  }
+
+  // ─── Prompt builder ───
+  // Compact natural-language description of recent field activity, oldest first.
+  buildPrompt() {
+    if (this.fieldHistory.length === 0) return null;
+
+    const lines = this.fieldHistory.map(e => {
+      if (e.type === 'focus') {
+        return e.revisit
+          ? `User returned to field "${e.fieldId}".`
+          : `User focused field "${e.fieldId}".`;
+      }
+      if (e.valueLength === 0) return `User left field "${e.fieldId}" empty.`;
+      return `Field "${e.fieldId}" now contains: "${e.valuePreview}"`;
+    });
+
+    return [
+      'You are an ambient UX assistant embedded in a form.',
+      'Recent user activity, oldest first:',
+      ...lines,
+      '',
+      'Based only on this activity, suggest exactly one concise, specific next-step action the user might want.',
+      'Respond as compact JSON only: {"label": string (<=60 chars), "action": string (<=140 chars), "confidence": number 0-1}.',
+      'If nothing useful can be suggested, respond {"label": null}.'
+    ].join('\n');
+  }
+}
+
+export function createSentinel(name, options) {
+  return new SolaSentinel(name, options);
+}