@sola-air-ui/core 1.0.2 → 1.1.0

package/dist/sola-core.iife.js

@@ -0,0 +1,597 @@
+/* @sola-air-ui/core — IIFE build for ServiceNow and no-bundler environments */
+var SolaCore = (() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __export = (target, all) => {
+    for (var name in all)
+      __defProp(target, name, { get: all[name], enumerable: true });
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+  // src/index.js
+  var src_exports = {};
+  __export(src_exports, {
+    SolaSentinel: () => SolaSentinel,
+    __flush_destroys: () => __flush_destroys,
+    __flush_mounts: () => __flush_mounts,
+    configureData: () => configureData,
+    configureIntent: () => configureIntent,
+    createData: () => createData,
+    createDerived: () => createDerived,
+    createEffect: () => createEffect,
+    createIntent: () => createIntent,
+    createSentinel: () => createSentinel,
+    createSignal: () => createSignal,
+    createTopicSignal: () => createTopicSignal,
+    flushSync: () => flushSync,
+    onDestroy: () => onDestroy,
+    onMount: () => onMount,
+    popContext: () => popContext,
+    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;
+  function flushSync() {
+    while (pendingEffects.size > 0) {
+      const effects = [...pendingEffects];
+      pendingEffects.clear();
+      for (const effect of effects) {
+        effect.execute();
+      }
+    }
+    isFlushing = false;
+  }
+  function scheduleFlush() {
+    if (!isFlushing) {
+      isFlushing = true;
+      queueMicrotask(flushSync);
+    }
+  }
+  function createSignal(initialValue) {
+    let value = initialValue;
+    const subscribers = /* @__PURE__ */ new Set();
+    const read = () => {
+      const currentEffect = effectStack[effectStack.length - 1];
+      if (currentEffect) {
+        subscribers.add(currentEffect);
+        currentEffect.dependencies.add(subscribers);
+      }
+      return value;
+    };
+    const write = (newValue) => {
+      if (value !== newValue) {
+        value = newValue;
+        for (const sub of [...subscribers]) {
+          pendingEffects.add(sub);
+        }
+        scheduleFlush();
+      }
+    };
+    return [read, write];
+  }
+  function createEffect(fn) {
+    const effect = {
+      execute() {
+        cleanup();
+        effectStack.push(effect);
+        try {
+          fn();
+        } finally {
+          effectStack.pop();
+        }
+      },
+      dependencies: /* @__PURE__ */ new Set(),
+      cleanup
+    };
+    function cleanup() {
+      for (const dep of effect.dependencies) {
+        dep.delete(effect);
+      }
+      effect.dependencies.clear();
+    }
+    effectStack.push(effect);
+    try {
+      fn();
+    } finally {
+      effectStack.pop();
+    }
+    return cleanup;
+  }
+  function createDerived(fn) {
+    let cachedValue;
+    let dirty = true;
+    const subscribers = /* @__PURE__ */ new Set();
+    let innerDependencies = /* @__PURE__ */ new Set();
+    const markDirty = {
+      execute() {
+        if (!dirty) {
+          dirty = true;
+          for (const sub of [...subscribers]) {
+            pendingEffects.add(sub);
+          }
+          scheduleFlush();
+        }
+      },
+      dependencies: innerDependencies,
+      cleanup() {
+        for (const dep of innerDependencies) {
+          dep.delete(markDirty);
+        }
+        innerDependencies.clear();
+      }
+    };
+    const read = () => {
+      const currentEffect = effectStack[effectStack.length - 1];
+      if (currentEffect) {
+        subscribers.add(currentEffect);
+        currentEffect.dependencies.add(subscribers);
+      }
+      if (dirty) {
+        markDirty.cleanup();
+        innerDependencies = /* @__PURE__ */ new Set();
+        markDirty.dependencies = innerDependencies;
+        effectStack.push(markDirty);
+        try {
+          cachedValue = fn();
+        } finally {
+          effectStack.pop();
+        }
+        dirty = false;
+      }
+      return cachedValue;
+    };
+    return read;
+  }
+  var contextStack = [];
+  var activeContext = null;
+  function pushContext() {
+    const ctx = { mounts: [], destroys: [] };
+    contextStack.push(ctx);
+    activeContext = ctx;
+    return ctx;
+  }
+  function popContext(ctx) {
+    const idx = contextStack.lastIndexOf(ctx);
+    if (idx !== -1) {
+      contextStack.splice(idx, 1);
+    }
+    activeContext = contextStack.length > 0 ? contextStack[contextStack.length - 1] : null;
+  }
+  function onMount(fn) {
+    if (activeContext) {
+      activeContext.mounts.push(fn);
+    } else {
+      fn();
+    }
+  }
+  function onDestroy(fn) {
+    if (activeContext) {
+      activeContext.destroys.push(fn);
+    }
+  }
+  function __flush_mounts() {
+    if (activeContext && activeContext.mounts.length > 0) {
+      const cbs = [...activeContext.mounts];
+      activeContext.mounts = [];
+      for (const cb of cbs) {
+        cb();
+      }
+    }
+  }
+  function __flush_destroys() {
+    if (activeContext && activeContext.destroys.length > 0) {
+      const cbs = [...activeContext.destroys];
+      activeContext.destroys = [];
+      for (const cb of cbs) {
+        cb();
+      }
+    }
+  }
+  var defaultIntentConfig = {
+    provider: "local",
+    endpoint: "/api/intent",
+    model: "gemini-2.5-flash",
+    stream: false
+  };
+  var globalIntentConfig = { ...defaultIntentConfig };
+  function configureIntent(config) {
+    globalIntentConfig = { ...globalIntentConfig, ...config };
+  }
+  async function _consumeSSE(response, onToken, onDone, onError) {
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buf = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buf += decoder.decode(value, { stream: true });
+        const lines = buf.split("\n");
+        buf = lines.pop();
+        for (const line of lines) {
+          if (!line.startsWith("data: ")) continue;
+          const payload = line.slice(6).trim();
+          if (payload === "[DONE]") {
+            onDone();
+            return;
+          }
+          try {
+            const parsed = JSON.parse(payload);
+            const token = parsed.token ?? parsed.delta ?? parsed.content ?? "";
+            if (token) onToken(token);
+          } catch {
+            if (payload) onToken(payload);
+          }
+        }
+      }
+      onDone();
+    } catch (err) {
+      if (err.name !== "AbortError") onError(err);
+    }
+  }
+  function createIntent(promptFn, options = {}) {
+    const config = { ...globalIntentConfig, ...options };
+    const [read, write] = createSignal(options.initial ?? null);
+    const [loading, setLoading] = createSignal(false);
+    const [error, setError] = createSignal(null);
+    let abortController = null;
+    onDestroy(() => {
+      if (abortController) abortController.abort();
+    });
+    createEffect(() => {
+      const prompt = typeof promptFn === "function" ? promptFn() : promptFn;
+      if (!prompt) return;
+      if (abortController) abortController.abort();
+      abortController = new AbortController();
+      write(null);
+      setError(null);
+      setLoading(true);
+      const body = JSON.stringify({
+        messages: [{ role: "user", content: prompt }],
+        model: config.model,
+        provider: config.provider,
+        stream: config.stream
+      });
+      fetch(config.endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body,
+        signal: abortController.signal
+      }).then((res) => {
+        if (!res.ok) throw new Error(`Intent failed: ${res.status}`);
+        if (config.stream) {
+          let accumulated = "";
+          return _consumeSSE(
+            res,
+            (token) => {
+              accumulated += token;
+              write(accumulated);
+            },
+            () => setLoading(false),
+            (err) => {
+              setError(err.message);
+              setLoading(false);
+            }
+          );
+        }
+        return res.json().then((data) => {
+          if (data?.components?.length > 0) write(data.components[0]);
+          else if (data?.result != null) write(data.result);
+          else write(data);
+          setLoading(false);
+        });
+      }).catch((err) => {
+        if (err.name !== "AbortError") {
+          console.error("[Sola Intent Error]", err);
+          setError(err.message);
+          setLoading(false);
+        }
+      });
+    });
+    const accessor = read;
+    accessor.loading = loading;
+    accessor.error = error;
+    return accessor;
+  }
+  var defaultDataConfig = {
+    relayEndpoint: "http://localhost:4040/api/query",
+    refresh: null
+    // e.g. '30s', '1m', '5m'
+  };
+  var globalDataConfig = { ...defaultDataConfig };
+  function configureData(config) {
+    globalDataConfig = { ...globalDataConfig, ...config };
+  }
+  function parseInterval(str) {
+    if (!str) return null;
+    const match = str.match(/^(\d+)(s|m|h)$/);
+    if (!match) return null;
+    const val = parseInt(match[1]);
+    switch (match[2]) {
+      case "s":
+        return val * 1e3;
+      case "m":
+        return val * 60 * 1e3;
+      case "h":
+        return val * 3600 * 1e3;
+    }
+    return null;
+  }
+  function createData(source, options = {}) {
+    const config = { ...globalDataConfig, ...options };
+    const [read, write] = createSignal({ loading: true, data: null, error: null });
+    let abortController = null;
+    let refreshTimer = null;
+    function fetchData() {
+      if (abortController) abortController.abort();
+      abortController = new AbortController();
+      write({ loading: true, data: read().data, error: null });
+      fetch(config.relayEndpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          source,
+          query: config.query || null,
+          filters: config.filters || null,
+          sort: config.sort || null,
+          limit: config.limit || null,
+          offset: config.offset || null
+        }),
+        signal: abortController.signal
+      }).then((res) => {
+        if (!res.ok) throw new Error(`Data fetch failed: ${res.status}`);
+        return res.json();
+      }).then((data) => {
+        write({ loading: false, data: data.rows || data, error: null });
+      }).catch((err) => {
+        if (err.name !== "AbortError") {
+          console.error("[Sola Data Error]", err);
+          write({ loading: false, data: null, error: err.message });
+        }
+      });
+    }
+    fetchData();
+    const interval = parseInterval(config.refresh);
+    if (interval) {
+      refreshTimer = setInterval(fetchData, interval);
+    }
+    const accessor = () => read();
+    accessor.refetch = fetchData;
+    accessor.stop = () => {
+      if (refreshTimer) clearInterval(refreshTimer);
+      if (abortController) abortController.abort();
+    };
+    return accessor;
+  }
+  var SignalMeshEngine = class {
+    constructor() {
+      this.topics = /* @__PURE__ */ new Map();
+      this.telemetrySubscribers = /* @__PURE__ */ new Set();
+      this.cycleStack = /* @__PURE__ */ new Set();
+    }
+    topic(name, initialValue) {
+      if (!this.topics.has(name)) {
+        const [read2, write2] = createSignal(initialValue);
+        this.topics.set(name, { read: read2, write: write2, value: initialValue, subscribers: /* @__PURE__ */ new Set() });
+      }
+      const entry = this.topics.get(name);
+      const read = () => entry.read();
+      const write = (next, originId = "signal") => {
+        const nextVal = typeof next === "function" ? next(entry.value) : next;
+        if (entry.value === nextVal) return;
+        if (this.cycleStack.has(name)) {
+          console.warn(`[Sola Signal Mesh] Cycle detected on topic "${name}". Aborting cyclic dispatch.`);
+          return;
+        }
+        const prev = entry.value;
+        entry.value = nextVal;
+        entry.write(nextVal);
+        const event = {
+          topic: name,
+          value: nextVal,
+          prevValue: prev,
+          timestamp: typeof performance !== "undefined" ? performance.now() : Date.now(),
+          originWidgetId: originId
+        };
+        this.telemetrySubscribers.forEach((cb) => {
+          try {
+            cb(event);
+          } catch (e) {
+            console.error(e);
+          }
+        });
+        this.cycleStack.add(name);
+        try {
+          entry.subscribers.forEach((sub) => {
+            try {
+              sub(nextVal, event);
+            } catch (e) {
+              console.error(e);
+            }
+          });
+        } finally {
+          this.cycleStack.delete(name);
+        }
+      };
+      return [read, write];
+    }
+    subscribe(name, fn) {
+      if (!this.topics.has(name)) {
+        this.topic(name, void 0);
+      }
+      const entry = this.topics.get(name);
+      entry.subscribers.add(fn);
+      return () => entry.subscribers.delete(fn);
+    }
+    onTelemetry(fn) {
+      this.telemetrySubscribers.add(fn);
+      return () => this.telemetrySubscribers.delete(fn);
+    }
+  };
+  var signalMesh = new SignalMeshEngine();
+  var createTopicSignal = (topic, initialVal) => signalMesh.topic(topic, initialVal);
+  return __toCommonJS(src_exports);
+})();

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

@@ -0,0 +1,4 @@
+/* @sola-air-ui/core v1.0.2 | MIT */
+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,32 +1,40 @@
-{
-  "name": "@sola-air-ui/core",
-  "version": "1.0.2",
-  "description": "Zero-VDOM reactivity engine — signals, effects, lifecycle, and intent primitives",
-  "type": "module",
-  "main": "./src/index.js",
-  "exports": {
-    ".": "./src/index.js",
-    "./iife": "./dist/sola-core.iife.js"
-  },
-  "scripts": {
-    "build": "node build.js"
-  },
-  "keywords": [
-    "sola",
-    "reactivity",
-    "signals",
-    "zero-vdom",
-    "ui",
-    "frontend"
-  ],
-  "license": "MIT",
-  "homepage": "https://sola-air.dev",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/rbm3267/sola-air"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  }
-}
+{
+  "name": "@sola-air-ui/core",
+  "version": "1.1.0",
+  "description": "Zero-VDOM reactivity engine — signals, effects, lifecycle, and intent primitives",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./iife": "./dist/sola-core.iife.js"
+  },
+  "scripts": {
+    "build": "node build.js",
+    "prepare": "node build.js"
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "dependencies": {
+    "esbuild": "^0.21.5"
+  },
+  "keywords": [
+    "sola",
+    "reactivity",
+    "signals",
+    "zero-vdom",
+    "ui",
+    "frontend"
+  ],
+  "license": "MIT",
+  "homepage": "https://sola-air.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rbm3267/sola-air"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

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);
+}

package/build.js

@@ -1,33 +0,0 @@
-import { build } from 'esbuild';
-import { mkdirSync } from 'fs';
-
-mkdirSync('./dist', { recursive: true });
-
-await build({
-  entryPoints: ['./src/index.js'],
-  bundle: true,
-  format: 'iife',
-  globalName: 'SolaCore',
-  outfile: './dist/sola-core.iife.js',
-  minify: false,
-  target: ['es2020'],
-  banner: {
-    js: '/* @sola-air-ui/core — IIFE build for ServiceNow and no-bundler environments */'
-  }
-});
-
-// Also emit a minified version
-await build({
-  entryPoints: ['./src/index.js'],
-  bundle: true,
-  format: 'iife',
-  globalName: 'SolaCore',
-  outfile: './dist/sola-core.iife.min.js',
-  minify: true,
-  target: ['es2020'],
-  banner: {
-    js: '/* @sola-air-ui/core v1.0.2 | MIT */'
-  }
-});
-
-console.log('Built dist/sola-core.iife.js and dist/sola-core.iife.min.js');