@sola-air-ui/core 1.0.3 → 1.1.0

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;
@@ -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 c=o.severity==="CRITICAL"?6:o.severity==="HIGH"?3.8:2,l=Math.max(.3,1-(t-o.timestamp)/12e4);return r+c*l},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 l=1;l<this.fieldHistory.length;l++)r.push(this.fieldHistory[l].timestamp-this.fieldHistory[l-1].timestamp);let o=r.reduce((l,u)=>l+u,0)/r.length,c=r.reduce((l,u)=>l+(u-o)**2,0)/r.length;e-=Math.min(10,Math.sqrt(c)/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 p=[],v=new Set,x=!1;function M(){for(;v.size>0;){let s=[...v];v.clear();for(let t of s)t.execute()}x=!1}function H(){x||(x=!0,queueMicrotask(M))}function S(s){let t=s,e=new Set;return[()=>{let r=p[p.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(),p.push(t);try{s()}finally{p.pop()}},dependencies:new Set,cleanup:e};function e(){for(let n of t.dependencies)n.delete(t);t.dependencies.clear()}p.push(t);try{s()}finally{p.pop()}return e}function U(s){let t,e=!0,n=new Set,i=new Set,r={execute(){if(!e){e=!0;for(let c of[...n])v.add(c);H()}},dependencies:i,cleanup(){for(let c of i)c.delete(r);i.clear()}};return()=>{let c=p[p.length-1];if(c&&(n.add(c),c.dependencies.add(n)),e){r.cleanup(),i=new Set,r.dependencies=i,p.push(r);try{t=s()}finally{p.pop()}e=!1}return t}}var b=[],f=null;function X(){let s={mounts:[],destroys:[]};return b.push(s),f=s,s}function P(s){let t=b.lastIndexOf(s);t!==-1&&b.splice(t,1),f=b.length>0?b[b.length-1]:null}function B(s){f?f.mounts.push(s):s()}function k(s){f&&f.destroys.push(s)}function V(){if(f&&f.mounts.length>0){let s=[...f.mounts];f.mounts=[];for(let t of s)t()}}function j(){if(f&&f.destroys.length>0){let s=[...f.destroys];f.destroys=[];for(let t of s)t()}}var q={provider:"local",endpoint:"/api/intent",model:"gemini-2.5-flash",stream:!1},_={...q};function G(s){_={..._,...s}}async function J(s,t,e,n){let i=s.body.getReader(),r=new TextDecoder,o="";try{for(;;){let{done:c,value:l}=await i.read();if(c)break;o+=r.decode(l,{stream:!0});let u=o.split(`
+`);o=u.pop();for(let a of u){if(!a.startsWith("data: "))continue;let d=a.slice(6).trim();if(d==="[DONE]"){e();return}try{let g=JSON.parse(d),h=g.token??g.delta??g.content??"";h&&t(h)}catch{d&&t(d)}}}e()}catch(c){c.name!=="AbortError"&&n(c)}}function z(s,t={}){let e={..._,...t},[n,i]=S(t.initial??null),[r,o]=S(!1),[c,l]=S(null),u=null;k(()=>{u&&u.abort()}),D(()=>{let d=typeof s=="function"?s():s;if(!d)return;u&&u.abort(),u=new AbortController,i(null),l(null),o(!0);let g=JSON.stringify({messages:[{role:"user",content:d}],model:e.model,provider:e.provider,stream:e.stream});fetch(e.endpoint,{method:"POST",headers:{"Content-Type":"application/json"},body:g,signal:u.signal}).then(h=>{if(!h.ok)throw new Error(`Intent failed: ${h.status}`);if(e.stream){let m="";return J(h,w=>{m+=w,i(m)},()=>o(!1),w=>{l(w.message),o(!1)})}return h.json().then(m=>{m?.components?.length>0?i(m.components[0]):m?.result!=null?i(m.result):i(m),o(!1)})}).catch(h=>{h.name!=="AbortError"&&(console.error("[Sola Intent Error]",h),l(h.message),o(!1))})});let a=n;return a.loading=r,a.error=c,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 c(){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}))})}c();let l=Q(e.refresh);l&&(o=setInterval(c,l));let u=()=>n();return u.refetch=c,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,c]=S(e);this.topics.set(t,{read:o,write:c,value:e,subscribers:new Set})}let n=this.topics.get(t);return[()=>n.read(),(o,c="signal")=>{let l=typeof o=="function"?o(n.value):o;if(n.value===l)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=l,n.write(l);let a={topic:t,value:l,prevValue:u,timestamp:typeof performance<"u"?performance.now():Date.now(),originWidgetId:c};this.telemetrySubscribers.forEach(d=>{try{d(a)}catch(g){console.error(g)}}),this.cycleStack.add(t);try{n.subscribers.forEach(d=>{try{d(l,a)}catch(g){console.error(g)}})}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.0",
   "description": "Zero-VDOM reactivity engine — signals, effects, lifecycle, and intent primitives",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -476,65 +476,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);
+}