morph-embed 0.2.2 → 0.3.0

package/dist/morph-embed.esm.mjs

@@ -1,4 +1,4 @@
-/*! Morph Embed SDK v0.2.2 — https://usemorph.xyz — MIT */
+/*! Morph Embed SDK v0.3.0 — https://usemorph.xyz — MIT */
 const g = typeof window !== "undefined" ? window : globalThis;
 
 /* ---- shared/dsl.js ---- */
@@ -1365,255 +1365,259 @@ const g = typeof window !== "undefined" ? window : globalThis;
 
 
 /* ---- sdk/src/storage.js ---- */
-/*
- * Morph SDK — recipe store. SCHEMA v2: a recipe is a LIST OF EDITS
- * ({id, prompt, ts, enabled, transform}) per page path, which is what makes
- * per-edit undo, history, and toggling possible in the SDK UI (Nielsen #3,
- * user control and freedom). v1 recipes (one merged blob) migrate on read.
- *
- * Default backing is localStorage (per-browser); a vendor may pass a custom
- * adapter {get,set,remove} (sync or Promise) to store recipes in their own
- * backend so a user's generated features follow them across devices.
- * Storage failures NEVER throw — a broken store must never break the host page.
- * UMD: Node module in tests, browser global `MorphStorage` in the SDK bundle.
- */
-(function (global, factory) {
-  const api = factory();
-  if (typeof module !== 'undefined' && module.exports) module.exports = api;
-  else global.MorphStorage = api;
-})(typeof self !== 'undefined' ? self : this, function () {
-  'use strict';
-
-  const PREFIX = 'morph:sdk:recipe:';
-  const SCHEMA_VERSION = 2;
-  const MAX_PROMPT_LABEL = 300;
-  const MAX_EDITS = 20;
-
-  // Default adapter: window.localStorage, JSON values, fully guarded.
-  function localAdapter() {
-    function ls() {
-      try {
-        return (typeof window !== 'undefined' && window.localStorage) ? window.localStorage : null;
-      } catch (_) { return null; } // SecurityError in sandboxed frames
-    }
-    return {
-      get(key) {
-        const s = ls();
-        if (!s) return undefined;
-        const raw = s.getItem(key);
-        if (raw == null) return undefined;
-        try { return JSON.parse(raw); } catch (_) { return undefined; }
-      },
-      set(key, value) {
-        const s = ls();
-        if (!s) return;
-        s.setItem(key, JSON.stringify(value));
-      },
-      remove(key) {
-        const s = ls();
-        if (!s) return;
-        s.removeItem(key);
-      },
-    };
-  }
-
-  function genId() {
-    return 'e_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
-  }
-
-  // mergeTransforms concats; recipes must UNION. Drop structurally identical
-  // ops (first occurrence wins) so repeating a prompt can't bloat the recipe.
-  function dedupeOps(transform) {
-    if (!transform || !Array.isArray(transform.ops)) return transform;
-    const seen = new Set();
-    const ops = transform.ops.filter((op) => {
-      let key;
-      try { key = JSON.stringify(op); } catch (_) { return true; }
-      if (seen.has(key)) return false;
-      seen.add(key);
-      return true;
-    });
-    return Object.assign({}, transform, { ops });
-  }
-
-  // Merge the ENABLED edits, in order, into one transform (deduped). Returns
-  // null when nothing is enabled. mergeFn is DSL.mergeTransforms when the
-  // caller has the DSL; the concat fallback keeps this module dependency-free.
-  function composeEdits(edits, mergeFn) {
-    const enabled = (Array.isArray(edits) ? edits : []).filter((e) => e && e.enabled !== false && e.transform);
-    if (!enabled.length) return null;
-    let merged = enabled[0].transform;
-    for (let i = 1; i < enabled.length; i++) {
-      merged = (typeof mergeFn === 'function')
-        ? mergeFn(merged, enabled[i].transform)
-        : Object.assign({}, merged, { ops: (merged.ops || []).concat(enabled[i].transform.ops || []) });
-    }
-    return dedupeOps(merged);
-  }
-
-  // Human label for the whole recipe: unique enabled-edit prompts, in order.
-  function promptLabel(edits) {
-    const seen = new Set();
-    const parts = [];
-    for (const e of Array.isArray(edits) ? edits : []) {
-      if (!e || e.enabled === false) continue;
-      const p = String(e.prompt || '').trim();
-      const k = p.toLowerCase();
-      if (!p || seen.has(k)) continue;
-      seen.add(k);
-      parts.push(p);
-    }
-    return parts.join(' + ').slice(0, MAX_PROMPT_LABEL);
-  }
-
-  // Any stored shape -> v2. v1 recipes (single merged transform) become one
-  // edit so nothing a user saved before the redesign is lost.
-  function migrate(raw, pathKey) {
-    const base = { path: String(pathKey || '/'), enabled: true, schemaVersion: SCHEMA_VERSION, createdAt: (raw && raw.createdAt) || Date.now(), edits: [] };
-    if (!raw || typeof raw !== 'object') return base;
-    if (Array.isArray(raw.edits)) {
-      base.edits = raw.edits.filter((e) => e && typeof e === 'object' && e.transform);
-      return base;
-    }
-    if (raw.transform) {
-      base.edits = [{
-        id: genId(),
-        prompt: String(raw.prompt || 'Earlier changes').slice(0, MAX_PROMPT_LABEL),
-        ts: raw.createdAt || Date.now(),
-        enabled: raw.enabled !== false,
-        transform: raw.transform,
-      }];
-    }
-    return base;
-  }
-
-  function createStore(adapter) {
-    const backing = (adapter && typeof adapter === 'object') ? adapter : localAdapter();
-    const keyOf = (pathKey) => PREFIX + String(pathKey || '/');
-
-    // Serialize read-modify-write so rapid appends can't lose edits (same
-    // pattern as extension/src/recipes.js).
-    let writeChain = Promise.resolve();
-    function serialize(fn) {
-      const run = writeChain.then(fn, fn);
-      writeChain = run.then(() => {}, () => {});
-      return run;
-    }
-
-    async function readMigrated(pathKey) {
-      let raw;
-      try { raw = await backing.get(keyOf(pathKey)); } catch (_) { raw = undefined; }
-      if (!raw || typeof raw !== 'object') return null;
-      return migrate(raw, pathKey);
-    }
-
-    async function persist(pathKey, recipe) {
-      await backing.set(keyOf(pathKey), recipe);
-      return recipe;
-    }
-
-    // Back-compat read shape: composed transform + merged prompt + the edits.
-    async function loadRecipe(pathKey) {
-      try {
-        const r = await readMigrated(pathKey);
-        if (!r) return null;
-        return {
-          path: r.path,
-          enabled: r.edits.some((e) => e.enabled !== false),
-          prompt: promptLabel(r.edits),
-          transform: composeEdits(r.edits),
-          edits: r.edits,
-          schemaVersion: SCHEMA_VERSION,
-          createdAt: r.createdAt,
-        };
-      } catch (_) { return null; }
-    }
-
-    function saveRecipe(pathKey, recipe) {
-      return serialize(async () => {
-        try {
-          const merged = Object.assign(
-            { path: String(pathKey || '/'), enabled: true, createdAt: Date.now() },
-            recipe,
-            { schemaVersion: SCHEMA_VERSION, path: String(pathKey || '/') }
-          );
-          await persist(pathKey, merged);
-          return merged;
-        } catch (_) { return null; }
-      });
-    }
-
-    // Add one edit (the unit of undo/history). Returns the new edit or null.
-    function appendEdit(pathKey, transform, meta) {
-      return serialize(async () => {
-        try {
-          const r = (await readMigrated(pathKey)) || migrate(null, pathKey);
-          const edit = {
-            id: genId(),
-            prompt: String((meta && meta.prompt) || '').slice(0, MAX_PROMPT_LABEL),
-            ts: Date.now(),
-            enabled: true,
-            transform,
-          };
-          r.edits.push(edit);
-          if (r.edits.length > MAX_EDITS) r.edits.splice(0, r.edits.length - MAX_EDITS);
-          await persist(pathKey, r);
-          return edit;
-        } catch (_) { return null; }
-      });
-    }
-
-    async function listEdits(pathKey) {
-      try {
-        const r = await readMigrated(pathKey);
-        return r ? r.edits : [];
-      } catch (_) { return []; }
-    }
-
-    function setEditEnabled(pathKey, id, enabled) {
-      return serialize(async () => {
-        try {
-          const r = await readMigrated(pathKey);
-          if (!r) return false;
-          const edit = r.edits.find((e) => e.id === id);
-          if (!edit) return false;
-          edit.enabled = enabled !== false;
-          await persist(pathKey, r);
-          return true;
-        } catch (_) { return false; }
-      });
-    }
-
-    function removeEdit(pathKey, id) {
-      return serialize(async () => {
-        try {
-          const r = await readMigrated(pathKey);
-          if (!r) return false;
-          const i = r.edits.findIndex((e) => e.id === id);
-          if (i < 0) return false;
-          r.edits.splice(i, 1);
-          await persist(pathKey, r);
-          return true;
-        } catch (_) { return false; }
-      });
-    }
-
-    // v1 API kept for existing callers: appends as an edit under the hood.
-    function appendTransform(pathKey, transform, meta, mergeFn) {
-      return appendEdit(pathKey, transform, meta).then((edit) => (edit ? loadRecipe(pathKey) : null), () => null);
-    }
-
-    function removeRecipe(pathKey) {
-      return serialize(async () => {
-        try { await backing.remove(keyOf(pathKey)); } catch (_) { /* never throws */ }
-      });
-    }
-
-    return { loadRecipe, saveRecipe, appendTransform, appendEdit, listEdits, setEditEnabled, removeEdit, removeRecipe };
-  }
-
-  return { createStore, composeEdits, SCHEMA_VERSION };
-});
+/*
+ * Morph SDK — recipe store. SCHEMA v2: a recipe is a LIST OF EDITS
+ * ({id, prompt, ts, enabled, transform}) per page path, which is what makes
+ * per-edit undo, history, and toggling possible in the SDK UI (Nielsen #3,
+ * user control and freedom). v1 recipes (one merged blob) migrate on read.
+ *
+ * Default backing is localStorage (per-browser); a vendor may pass a custom
+ * adapter {get,set,remove} (sync or Promise) to store recipes in their own
+ * backend so a user's generated features follow them across devices.
+ * Storage failures NEVER throw — a broken store must never break the host page.
+ * UMD: Node module in tests, browser global `MorphStorage` in the SDK bundle.
+ */
+(function (global, factory) {
+  const api = factory();
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+  else global.MorphStorage = api;
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const PREFIX = 'morph:sdk:recipe:';
+  const SCHEMA_VERSION = 2;
+  const MAX_PROMPT_LABEL = 300;
+  const MAX_EDITS = 20;
+
+  // Default adapter: window.localStorage, JSON values, fully guarded.
+  function localAdapter() {
+    function ls() {
+      try {
+        return (typeof window !== 'undefined' && window.localStorage) ? window.localStorage : null;
+      } catch (_) { return null; } // SecurityError in sandboxed frames
+    }
+    return {
+      get(key) {
+        const s = ls();
+        if (!s) return undefined;
+        const raw = s.getItem(key);
+        if (raw == null) return undefined;
+        try { return JSON.parse(raw); } catch (_) { return undefined; }
+      },
+      set(key, value) {
+        const s = ls();
+        if (!s) return;
+        s.setItem(key, JSON.stringify(value));
+      },
+      remove(key) {
+        const s = ls();
+        if (!s) return;
+        s.removeItem(key);
+      },
+    };
+  }
+
+  function genId() {
+    return 'e_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+  }
+
+  // mergeTransforms concats; recipes must UNION. Drop structurally identical
+  // ops (first occurrence wins) so repeating a prompt can't bloat the recipe.
+  function dedupeOps(transform) {
+    if (!transform || !Array.isArray(transform.ops)) return transform;
+    const seen = new Set();
+    const ops = transform.ops.filter((op) => {
+      let key;
+      try { key = JSON.stringify(op); } catch (_) { return true; }
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    });
+    return Object.assign({}, transform, { ops });
+  }
+
+  // Merge the ENABLED edits, in order, into one transform (deduped). Returns
+  // null when nothing is enabled. mergeFn is DSL.mergeTransforms when the
+  // caller has the DSL; the concat fallback keeps this module dependency-free.
+  function composeEdits(edits, mergeFn) {
+    const enabled = (Array.isArray(edits) ? edits : []).filter((e) => e && e.enabled !== false && e.transform);
+    if (!enabled.length) return null;
+    let merged = enabled[0].transform;
+    for (let i = 1; i < enabled.length; i++) {
+      merged = (typeof mergeFn === 'function')
+        ? mergeFn(merged, enabled[i].transform)
+        : Object.assign({}, merged, { ops: (merged.ops || []).concat(enabled[i].transform.ops || []) });
+    }
+    return dedupeOps(merged);
+  }
+
+  // Human label for the whole recipe: unique enabled-edit prompts, in order.
+  function promptLabel(edits) {
+    const seen = new Set();
+    const parts = [];
+    for (const e of Array.isArray(edits) ? edits : []) {
+      if (!e || e.enabled === false) continue;
+      const p = String(e.prompt || '').trim();
+      const k = p.toLowerCase();
+      if (!p || seen.has(k)) continue;
+      seen.add(k);
+      parts.push(p);
+    }
+    return parts.join(' + ').slice(0, MAX_PROMPT_LABEL);
+  }
+
+  // Any stored shape -> v2. v1 recipes (single merged transform) become one
+  // edit so nothing a user saved before the redesign is lost.
+  function migrate(raw, pathKey) {
+    const base = { path: String(pathKey || '/'), enabled: true, schemaVersion: SCHEMA_VERSION, createdAt: (raw && raw.createdAt) || Date.now(), edits: [] };
+    if (!raw || typeof raw !== 'object') return base;
+    if (Array.isArray(raw.edits)) {
+      base.edits = raw.edits.filter((e) => e && typeof e === 'object' && e.transform);
+      return base;
+    }
+    if (raw.transform) {
+      base.edits = [{
+        id: genId(),
+        prompt: String(raw.prompt || 'Earlier changes').slice(0, MAX_PROMPT_LABEL),
+        ts: raw.createdAt || Date.now(),
+        enabled: raw.enabled !== false,
+        transform: raw.transform,
+      }];
+    }
+    return base;
+  }
+
+  function createStore(adapter) {
+    const backing = (adapter && typeof adapter === 'object') ? adapter : localAdapter();
+    const keyOf = (pathKey) => PREFIX + String(pathKey || '/');
+
+    // Serialize read-modify-write so rapid appends can't lose edits (same
+    // pattern as extension/src/recipes.js).
+    let writeChain = Promise.resolve();
+    function serialize(fn) {
+      const run = writeChain.then(fn, fn);
+      writeChain = run.then(() => {}, () => {});
+      return run;
+    }
+
+    async function readMigrated(pathKey) {
+      let raw;
+      try { raw = await backing.get(keyOf(pathKey)); } catch (_) { raw = undefined; }
+      if (!raw || typeof raw !== 'object') return null;
+      return migrate(raw, pathKey);
+    }
+
+    async function persist(pathKey, recipe) {
+      await backing.set(keyOf(pathKey), recipe);
+      return recipe;
+    }
+
+    // Back-compat read shape: composed transform + merged prompt + the edits.
+    async function loadRecipe(pathKey) {
+      try {
+        const r = await readMigrated(pathKey);
+        if (!r) return null;
+        return {
+          path: r.path,
+          enabled: r.edits.some((e) => e.enabled !== false),
+          prompt: promptLabel(r.edits),
+          transform: composeEdits(r.edits),
+          edits: r.edits,
+          schemaVersion: SCHEMA_VERSION,
+          createdAt: r.createdAt,
+        };
+      } catch (_) { return null; }
+    }
+
+    function saveRecipe(pathKey, recipe) {
+      return serialize(async () => {
+        try {
+          const merged = Object.assign(
+            { path: String(pathKey || '/'), enabled: true, createdAt: Date.now() },
+            recipe,
+            { schemaVersion: SCHEMA_VERSION, path: String(pathKey || '/') }
+          );
+          await persist(pathKey, merged);
+          return merged;
+        } catch (_) { return null; }
+      });
+    }
+
+    // Add one edit (the unit of undo/history). Returns the new edit or null.
+    function appendEdit(pathKey, transform, meta) {
+      return serialize(async () => {
+        try {
+          const r = (await readMigrated(pathKey)) || migrate(null, pathKey);
+          const edit = {
+            id: genId(),
+            prompt: String((meta && meta.prompt) || '').slice(0, MAX_PROMPT_LABEL),
+            ts: Date.now(),
+            enabled: true,
+            transform,
+          };
+          const fps = (meta && Array.isArray(meta.fps))
+            ? meta.fps.filter((f) => typeof f === 'string' && /^[a-f0-9]{12}$/.test(f)).slice(0, 8)
+            : [];
+          if (fps.length) edit.fps = fps;
+          r.edits.push(edit);
+          if (r.edits.length > MAX_EDITS) r.edits.splice(0, r.edits.length - MAX_EDITS);
+          await persist(pathKey, r);
+          return edit;
+        } catch (_) { return null; }
+      });
+    }
+
+    async function listEdits(pathKey) {
+      try {
+        const r = await readMigrated(pathKey);
+        return r ? r.edits : [];
+      } catch (_) { return []; }
+    }
+
+    function setEditEnabled(pathKey, id, enabled) {
+      return serialize(async () => {
+        try {
+          const r = await readMigrated(pathKey);
+          if (!r) return false;
+          const edit = r.edits.find((e) => e.id === id);
+          if (!edit) return false;
+          edit.enabled = enabled !== false;
+          await persist(pathKey, r);
+          return true;
+        } catch (_) { return false; }
+      });
+    }
+
+    function removeEdit(pathKey, id) {
+      return serialize(async () => {
+        try {
+          const r = await readMigrated(pathKey);
+          if (!r) return false;
+          const i = r.edits.findIndex((e) => e.id === id);
+          if (i < 0) return false;
+          r.edits.splice(i, 1);
+          await persist(pathKey, r);
+          return true;
+        } catch (_) { return false; }
+      });
+    }
+
+    // v1 API kept for existing callers: appends as an edit under the hood.
+    function appendTransform(pathKey, transform, meta, mergeFn) {
+      return appendEdit(pathKey, transform, meta).then((edit) => (edit ? loadRecipe(pathKey) : null), () => null);
+    }
+
+    function removeRecipe(pathKey) {
+      return serialize(async () => {
+        try { await backing.remove(keyOf(pathKey)); } catch (_) { /* never throws */ }
+      });
+    }
+
+    return { loadRecipe, saveRecipe, appendTransform, appendEdit, listEdits, setEditEnabled, removeEdit, removeRecipe };
+  }
+
+  return { createStore, composeEdits, SCHEMA_VERSION };
+});
 
 
 /* ---- extension/src/context.js ---- */
@@ -2887,6 +2891,22 @@ const g = typeof window !== "undefined" ? window : globalThis;
       } catch (_) { /* badge is best-effort */ }
     }
 
+    // Signal events: strictly fail-open, fire-and-forget. keepalive:true so a
+    // keep followed by navigation still lands. fps come from the backend's
+    // transform response and ride the stored edit records.
+    function sendSignals(kind, fps) {
+      const list = Array.isArray(fps) ? fps.slice(0, 8) : [];
+      if (!list.length) return;
+      try {
+        fetchFn(backend + '/api/embed/event', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'X-Morph-Key': config.key },
+          body: JSON.stringify({ kind, fps: list }),
+          keepalive: true,
+        }).catch(() => {});
+      } catch (_) { /* signals must never break the host page */ }
+    }
+
     function init() {
       if (typeof config.key !== 'string' || !config.key) {
         throw new TypeError('Morph: init requires a publishable key (config.key)');
@@ -3088,8 +3108,10 @@ const g = typeof window !== "undefined" ? window : globalThis;
           bar.setStatus('Couldn’t make that change here — try rephrasing.', '');
           return;
         }
+        const fps = (resp && resp.signal && Array.isArray(resp.signal.fps)) ? resp.signal.fps : [];
         const anchored = DSL.withAnchors ? DSL.withAnchors(transform, win.document) : transform;
-        const edit = await store.appendEdit(pathKey(), anchored, { prompt });
+        const edit = await store.appendEdit(pathKey(), anchored, { prompt, fps });
+        if (edit) sendSignals('kept', fps);
         const note = handle.failed ? ' (' + handle.failed + ' op(s) skipped)' : '';
         const explanation = (resp.transform && resp.transform.explanation) || 'Done.';
         // setStatus renders TRUSTED HTML (innerHTML) — escape the model's
@@ -3114,7 +3136,14 @@ const g = typeof window !== "undefined" ? window : globalThis;
 
     // Per-edit dismissal (HAX G8/G9): drop ONE edit, keep the rest.
     async function removeEdit(id) {
+      let fps = [];
+      try {
+        const edits = await store.listEdits(pathKey());
+        const e = edits.find((x) => x.id === id);
+        fps = (e && e.fps) || [];
+      } catch (_) { /* signal lookup is best-effort */ }
       await store.removeEdit(pathKey(), id);
+      sendSignals('undone', fps);
       await reapplyFromStore();
       await refreshCount();
       try { bar.setStatus('Change removed.', ''); } catch (_) { /* noop */ }
@@ -3132,6 +3161,14 @@ const g = typeof window !== "undefined" ? window : globalThis;
     async function resetPage() {
       if (currentHandle) { DSL.undoTransform(currentHandle); currentHandle = null; }
       activeTransform = null;
+      try {
+        const edits = await store.listEdits(pathKey());
+        const union = [];
+        for (const e of edits) for (const f of (e.fps || [])) {
+          if (union.length < 8 && !union.includes(f)) union.push(f);
+        }
+        sendSignals('undone', union);
+      } catch (_) { /* best-effort */ }
       await store.removeRecipe(pathKey());
       await refreshCount();
       if (ui) await openPanelIfRendered();
@@ -3172,6 +3209,12 @@ const g = typeof window !== "undefined" ? window : globalThis;
       const v = DSL.validateTransform(recipe.transform);
       if (!v.ok) return;
 
+      const savedFps = [];
+      for (const e of (recipe.edits || [])) {
+        if (!e || e.enabled === false) continue;
+        for (const f of (e.fps || [])) if (savedFps.length < 8 && !savedFps.includes(f)) savedFps.push(f);
+      }
+
       // 1) instant CSS so the page doesn't flash unstyled
       const cssOnly = Object.assign({}, v.transform, { ops: v.transform.ops.filter((o) => o.op === 'injectCSS') });
       let cssHandle = null;
@@ -3184,6 +3227,7 @@ const g = typeof window !== "undefined" ? window : globalThis;
         if (cssHandle) { DSL.undoTransform(cssHandle); cssHandle = null; }
         if (!transform.ops.length) return;
         await applyMerged(transform, data);
+        sendSignals('reapplied', savedFps);
       };
       if (win.document.readyState === 'loading') {
         win.document.addEventListener('DOMContentLoaded', () => { full().catch(() => {}); }, { once: true });

package/dist/morph-embed.js

@@ -1,4 +1,4 @@
-/*! Morph Embed SDK v0.2.2 — https://usemorph.xyz — MIT */
+/*! Morph Embed SDK v0.3.0 — https://usemorph.xyz — MIT */
 
 /* ---- shared/dsl.js ---- */
 /*
@@ -1364,255 +1364,259 @@
 
 
 /* ---- sdk/src/storage.js ---- */
-/*
- * Morph SDK — recipe store. SCHEMA v2: a recipe is a LIST OF EDITS
- * ({id, prompt, ts, enabled, transform}) per page path, which is what makes
- * per-edit undo, history, and toggling possible in the SDK UI (Nielsen #3,
- * user control and freedom). v1 recipes (one merged blob) migrate on read.
- *
- * Default backing is localStorage (per-browser); a vendor may pass a custom
- * adapter {get,set,remove} (sync or Promise) to store recipes in their own
- * backend so a user's generated features follow them across devices.
- * Storage failures NEVER throw — a broken store must never break the host page.
- * UMD: Node module in tests, browser global `MorphStorage` in the SDK bundle.
- */
-(function (global, factory) {
-  const api = factory();
-  if (typeof module !== 'undefined' && module.exports) module.exports = api;
-  else global.MorphStorage = api;
-})(typeof self !== 'undefined' ? self : this, function () {
-  'use strict';
-
-  const PREFIX = 'morph:sdk:recipe:';
-  const SCHEMA_VERSION = 2;
-  const MAX_PROMPT_LABEL = 300;
-  const MAX_EDITS = 20;
-
-  // Default adapter: window.localStorage, JSON values, fully guarded.
-  function localAdapter() {
-    function ls() {
-      try {
-        return (typeof window !== 'undefined' && window.localStorage) ? window.localStorage : null;
-      } catch (_) { return null; } // SecurityError in sandboxed frames
-    }
-    return {
-      get(key) {
-        const s = ls();
-        if (!s) return undefined;
-        const raw = s.getItem(key);
-        if (raw == null) return undefined;
-        try { return JSON.parse(raw); } catch (_) { return undefined; }
-      },
-      set(key, value) {
-        const s = ls();
-        if (!s) return;
-        s.setItem(key, JSON.stringify(value));
-      },
-      remove(key) {
-        const s = ls();
-        if (!s) return;
-        s.removeItem(key);
-      },
-    };
-  }
-
-  function genId() {
-    return 'e_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
-  }
-
-  // mergeTransforms concats; recipes must UNION. Drop structurally identical
-  // ops (first occurrence wins) so repeating a prompt can't bloat the recipe.
-  function dedupeOps(transform) {
-    if (!transform || !Array.isArray(transform.ops)) return transform;
-    const seen = new Set();
-    const ops = transform.ops.filter((op) => {
-      let key;
-      try { key = JSON.stringify(op); } catch (_) { return true; }
-      if (seen.has(key)) return false;
-      seen.add(key);
-      return true;
-    });
-    return Object.assign({}, transform, { ops });
-  }
-
-  // Merge the ENABLED edits, in order, into one transform (deduped). Returns
-  // null when nothing is enabled. mergeFn is DSL.mergeTransforms when the
-  // caller has the DSL; the concat fallback keeps this module dependency-free.
-  function composeEdits(edits, mergeFn) {
-    const enabled = (Array.isArray(edits) ? edits : []).filter((e) => e && e.enabled !== false && e.transform);
-    if (!enabled.length) return null;
-    let merged = enabled[0].transform;
-    for (let i = 1; i < enabled.length; i++) {
-      merged = (typeof mergeFn === 'function')
-        ? mergeFn(merged, enabled[i].transform)
-        : Object.assign({}, merged, { ops: (merged.ops || []).concat(enabled[i].transform.ops || []) });
-    }
-    return dedupeOps(merged);
-  }
-
-  // Human label for the whole recipe: unique enabled-edit prompts, in order.
-  function promptLabel(edits) {
-    const seen = new Set();
-    const parts = [];
-    for (const e of Array.isArray(edits) ? edits : []) {
-      if (!e || e.enabled === false) continue;
-      const p = String(e.prompt || '').trim();
-      const k = p.toLowerCase();
-      if (!p || seen.has(k)) continue;
-      seen.add(k);
-      parts.push(p);
-    }
-    return parts.join(' + ').slice(0, MAX_PROMPT_LABEL);
-  }
-
-  // Any stored shape -> v2. v1 recipes (single merged transform) become one
-  // edit so nothing a user saved before the redesign is lost.
-  function migrate(raw, pathKey) {
-    const base = { path: String(pathKey || '/'), enabled: true, schemaVersion: SCHEMA_VERSION, createdAt: (raw && raw.createdAt) || Date.now(), edits: [] };
-    if (!raw || typeof raw !== 'object') return base;
-    if (Array.isArray(raw.edits)) {
-      base.edits = raw.edits.filter((e) => e && typeof e === 'object' && e.transform);
-      return base;
-    }
-    if (raw.transform) {
-      base.edits = [{
-        id: genId(),
-        prompt: String(raw.prompt || 'Earlier changes').slice(0, MAX_PROMPT_LABEL),
-        ts: raw.createdAt || Date.now(),
-        enabled: raw.enabled !== false,
-        transform: raw.transform,
-      }];
-    }
-    return base;
-  }
-
-  function createStore(adapter) {
-    const backing = (adapter && typeof adapter === 'object') ? adapter : localAdapter();
-    const keyOf = (pathKey) => PREFIX + String(pathKey || '/');
-
-    // Serialize read-modify-write so rapid appends can't lose edits (same
-    // pattern as extension/src/recipes.js).
-    let writeChain = Promise.resolve();
-    function serialize(fn) {
-      const run = writeChain.then(fn, fn);
-      writeChain = run.then(() => {}, () => {});
-      return run;
-    }
-
-    async function readMigrated(pathKey) {
-      let raw;
-      try { raw = await backing.get(keyOf(pathKey)); } catch (_) { raw = undefined; }
-      if (!raw || typeof raw !== 'object') return null;
-      return migrate(raw, pathKey);
-    }
-
-    async function persist(pathKey, recipe) {
-      await backing.set(keyOf(pathKey), recipe);
-      return recipe;
-    }
-
-    // Back-compat read shape: composed transform + merged prompt + the edits.
-    async function loadRecipe(pathKey) {
-      try {
-        const r = await readMigrated(pathKey);
-        if (!r) return null;
-        return {
-          path: r.path,
-          enabled: r.edits.some((e) => e.enabled !== false),
-          prompt: promptLabel(r.edits),
-          transform: composeEdits(r.edits),
-          edits: r.edits,
-          schemaVersion: SCHEMA_VERSION,
-          createdAt: r.createdAt,
-        };
-      } catch (_) { return null; }
-    }
-
-    function saveRecipe(pathKey, recipe) {
-      return serialize(async () => {
-        try {
-          const merged = Object.assign(
-            { path: String(pathKey || '/'), enabled: true, createdAt: Date.now() },
-            recipe,
-            { schemaVersion: SCHEMA_VERSION, path: String(pathKey || '/') }
-          );
-          await persist(pathKey, merged);
-          return merged;
-        } catch (_) { return null; }
-      });
-    }
-
-    // Add one edit (the unit of undo/history). Returns the new edit or null.
-    function appendEdit(pathKey, transform, meta) {
-      return serialize(async () => {
-        try {
-          const r = (await readMigrated(pathKey)) || migrate(null, pathKey);
-          const edit = {
-            id: genId(),
-            prompt: String((meta && meta.prompt) || '').slice(0, MAX_PROMPT_LABEL),
-            ts: Date.now(),
-            enabled: true,
-            transform,
-          };
-          r.edits.push(edit);
-          if (r.edits.length > MAX_EDITS) r.edits.splice(0, r.edits.length - MAX_EDITS);
-          await persist(pathKey, r);
-          return edit;
-        } catch (_) { return null; }
-      });
-    }
-
-    async function listEdits(pathKey) {
-      try {
-        const r = await readMigrated(pathKey);
-        return r ? r.edits : [];
-      } catch (_) { return []; }
-    }
-
-    function setEditEnabled(pathKey, id, enabled) {
-      return serialize(async () => {
-        try {
-          const r = await readMigrated(pathKey);
-          if (!r) return false;
-          const edit = r.edits.find((e) => e.id === id);
-          if (!edit) return false;
-          edit.enabled = enabled !== false;
-          await persist(pathKey, r);
-          return true;
-        } catch (_) { return false; }
-      });
-    }
-
-    function removeEdit(pathKey, id) {
-      return serialize(async () => {
-        try {
-          const r = await readMigrated(pathKey);
-          if (!r) return false;
-          const i = r.edits.findIndex((e) => e.id === id);
-          if (i < 0) return false;
-          r.edits.splice(i, 1);
-          await persist(pathKey, r);
-          return true;
-        } catch (_) { return false; }
-      });
-    }
-
-    // v1 API kept for existing callers: appends as an edit under the hood.
-    function appendTransform(pathKey, transform, meta, mergeFn) {
-      return appendEdit(pathKey, transform, meta).then((edit) => (edit ? loadRecipe(pathKey) : null), () => null);
-    }
-
-    function removeRecipe(pathKey) {
-      return serialize(async () => {
-        try { await backing.remove(keyOf(pathKey)); } catch (_) { /* never throws */ }
-      });
-    }
-
-    return { loadRecipe, saveRecipe, appendTransform, appendEdit, listEdits, setEditEnabled, removeEdit, removeRecipe };
-  }
-
-  return { createStore, composeEdits, SCHEMA_VERSION };
-});
+/*
+ * Morph SDK — recipe store. SCHEMA v2: a recipe is a LIST OF EDITS
+ * ({id, prompt, ts, enabled, transform}) per page path, which is what makes
+ * per-edit undo, history, and toggling possible in the SDK UI (Nielsen #3,
+ * user control and freedom). v1 recipes (one merged blob) migrate on read.
+ *
+ * Default backing is localStorage (per-browser); a vendor may pass a custom
+ * adapter {get,set,remove} (sync or Promise) to store recipes in their own
+ * backend so a user's generated features follow them across devices.
+ * Storage failures NEVER throw — a broken store must never break the host page.
+ * UMD: Node module in tests, browser global `MorphStorage` in the SDK bundle.
+ */
+(function (global, factory) {
+  const api = factory();
+  if (typeof module !== 'undefined' && module.exports) module.exports = api;
+  else global.MorphStorage = api;
+})(typeof self !== 'undefined' ? self : this, function () {
+  'use strict';
+
+  const PREFIX = 'morph:sdk:recipe:';
+  const SCHEMA_VERSION = 2;
+  const MAX_PROMPT_LABEL = 300;
+  const MAX_EDITS = 20;
+
+  // Default adapter: window.localStorage, JSON values, fully guarded.
+  function localAdapter() {
+    function ls() {
+      try {
+        return (typeof window !== 'undefined' && window.localStorage) ? window.localStorage : null;
+      } catch (_) { return null; } // SecurityError in sandboxed frames
+    }
+    return {
+      get(key) {
+        const s = ls();
+        if (!s) return undefined;
+        const raw = s.getItem(key);
+        if (raw == null) return undefined;
+        try { return JSON.parse(raw); } catch (_) { return undefined; }
+      },
+      set(key, value) {
+        const s = ls();
+        if (!s) return;
+        s.setItem(key, JSON.stringify(value));
+      },
+      remove(key) {
+        const s = ls();
+        if (!s) return;
+        s.removeItem(key);
+      },
+    };
+  }
+
+  function genId() {
+    return 'e_' + Date.now().toString(36) + Math.random().toString(36).slice(2, 8);
+  }
+
+  // mergeTransforms concats; recipes must UNION. Drop structurally identical
+  // ops (first occurrence wins) so repeating a prompt can't bloat the recipe.
+  function dedupeOps(transform) {
+    if (!transform || !Array.isArray(transform.ops)) return transform;
+    const seen = new Set();
+    const ops = transform.ops.filter((op) => {
+      let key;
+      try { key = JSON.stringify(op); } catch (_) { return true; }
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    });
+    return Object.assign({}, transform, { ops });
+  }
+
+  // Merge the ENABLED edits, in order, into one transform (deduped). Returns
+  // null when nothing is enabled. mergeFn is DSL.mergeTransforms when the
+  // caller has the DSL; the concat fallback keeps this module dependency-free.
+  function composeEdits(edits, mergeFn) {
+    const enabled = (Array.isArray(edits) ? edits : []).filter((e) => e && e.enabled !== false && e.transform);
+    if (!enabled.length) return null;
+    let merged = enabled[0].transform;
+    for (let i = 1; i < enabled.length; i++) {
+      merged = (typeof mergeFn === 'function')
+        ? mergeFn(merged, enabled[i].transform)
+        : Object.assign({}, merged, { ops: (merged.ops || []).concat(enabled[i].transform.ops || []) });
+    }
+    return dedupeOps(merged);
+  }
+
+  // Human label for the whole recipe: unique enabled-edit prompts, in order.
+  function promptLabel(edits) {
+    const seen = new Set();
+    const parts = [];
+    for (const e of Array.isArray(edits) ? edits : []) {
+      if (!e || e.enabled === false) continue;
+      const p = String(e.prompt || '').trim();
+      const k = p.toLowerCase();
+      if (!p || seen.has(k)) continue;
+      seen.add(k);
+      parts.push(p);
+    }
+    return parts.join(' + ').slice(0, MAX_PROMPT_LABEL);
+  }
+
+  // Any stored shape -> v2. v1 recipes (single merged transform) become one
+  // edit so nothing a user saved before the redesign is lost.
+  function migrate(raw, pathKey) {
+    const base = { path: String(pathKey || '/'), enabled: true, schemaVersion: SCHEMA_VERSION, createdAt: (raw && raw.createdAt) || Date.now(), edits: [] };
+    if (!raw || typeof raw !== 'object') return base;
+    if (Array.isArray(raw.edits)) {
+      base.edits = raw.edits.filter((e) => e && typeof e === 'object' && e.transform);
+      return base;
+    }
+    if (raw.transform) {
+      base.edits = [{
+        id: genId(),
+        prompt: String(raw.prompt || 'Earlier changes').slice(0, MAX_PROMPT_LABEL),
+        ts: raw.createdAt || Date.now(),
+        enabled: raw.enabled !== false,
+        transform: raw.transform,
+      }];
+    }
+    return base;
+  }
+
+  function createStore(adapter) {
+    const backing = (adapter && typeof adapter === 'object') ? adapter : localAdapter();
+    const keyOf = (pathKey) => PREFIX + String(pathKey || '/');
+
+    // Serialize read-modify-write so rapid appends can't lose edits (same
+    // pattern as extension/src/recipes.js).
+    let writeChain = Promise.resolve();
+    function serialize(fn) {
+      const run = writeChain.then(fn, fn);
+      writeChain = run.then(() => {}, () => {});
+      return run;
+    }
+
+    async function readMigrated(pathKey) {
+      let raw;
+      try { raw = await backing.get(keyOf(pathKey)); } catch (_) { raw = undefined; }
+      if (!raw || typeof raw !== 'object') return null;
+      return migrate(raw, pathKey);
+    }
+
+    async function persist(pathKey, recipe) {
+      await backing.set(keyOf(pathKey), recipe);
+      return recipe;
+    }
+
+    // Back-compat read shape: composed transform + merged prompt + the edits.
+    async function loadRecipe(pathKey) {
+      try {
+        const r = await readMigrated(pathKey);
+        if (!r) return null;
+        return {
+          path: r.path,
+          enabled: r.edits.some((e) => e.enabled !== false),
+          prompt: promptLabel(r.edits),
+          transform: composeEdits(r.edits),
+          edits: r.edits,
+          schemaVersion: SCHEMA_VERSION,
+          createdAt: r.createdAt,
+        };
+      } catch (_) { return null; }
+    }
+
+    function saveRecipe(pathKey, recipe) {
+      return serialize(async () => {
+        try {
+          const merged = Object.assign(
+            { path: String(pathKey || '/'), enabled: true, createdAt: Date.now() },
+            recipe,
+            { schemaVersion: SCHEMA_VERSION, path: String(pathKey || '/') }
+          );
+          await persist(pathKey, merged);
+          return merged;
+        } catch (_) { return null; }
+      });
+    }
+
+    // Add one edit (the unit of undo/history). Returns the new edit or null.
+    function appendEdit(pathKey, transform, meta) {
+      return serialize(async () => {
+        try {
+          const r = (await readMigrated(pathKey)) || migrate(null, pathKey);
+          const edit = {
+            id: genId(),
+            prompt: String((meta && meta.prompt) || '').slice(0, MAX_PROMPT_LABEL),
+            ts: Date.now(),
+            enabled: true,
+            transform,
+          };
+          const fps = (meta && Array.isArray(meta.fps))
+            ? meta.fps.filter((f) => typeof f === 'string' && /^[a-f0-9]{12}$/.test(f)).slice(0, 8)
+            : [];
+          if (fps.length) edit.fps = fps;
+          r.edits.push(edit);
+          if (r.edits.length > MAX_EDITS) r.edits.splice(0, r.edits.length - MAX_EDITS);
+          await persist(pathKey, r);
+          return edit;
+        } catch (_) { return null; }
+      });
+    }
+
+    async function listEdits(pathKey) {
+      try {
+        const r = await readMigrated(pathKey);
+        return r ? r.edits : [];
+      } catch (_) { return []; }
+    }
+
+    function setEditEnabled(pathKey, id, enabled) {
+      return serialize(async () => {
+        try {
+          const r = await readMigrated(pathKey);
+          if (!r) return false;
+          const edit = r.edits.find((e) => e.id === id);
+          if (!edit) return false;
+          edit.enabled = enabled !== false;
+          await persist(pathKey, r);
+          return true;
+        } catch (_) { return false; }
+      });
+    }
+
+    function removeEdit(pathKey, id) {
+      return serialize(async () => {
+        try {
+          const r = await readMigrated(pathKey);
+          if (!r) return false;
+          const i = r.edits.findIndex((e) => e.id === id);
+          if (i < 0) return false;
+          r.edits.splice(i, 1);
+          await persist(pathKey, r);
+          return true;
+        } catch (_) { return false; }
+      });
+    }
+
+    // v1 API kept for existing callers: appends as an edit under the hood.
+    function appendTransform(pathKey, transform, meta, mergeFn) {
+      return appendEdit(pathKey, transform, meta).then((edit) => (edit ? loadRecipe(pathKey) : null), () => null);
+    }
+
+    function removeRecipe(pathKey) {
+      return serialize(async () => {
+        try { await backing.remove(keyOf(pathKey)); } catch (_) { /* never throws */ }
+      });
+    }
+
+    return { loadRecipe, saveRecipe, appendTransform, appendEdit, listEdits, setEditEnabled, removeEdit, removeRecipe };
+  }
+
+  return { createStore, composeEdits, SCHEMA_VERSION };
+});
 
 
 /* ---- extension/src/context.js ---- */
@@ -2886,6 +2890,22 @@
       } catch (_) { /* badge is best-effort */ }
     }
 
+    // Signal events: strictly fail-open, fire-and-forget. keepalive:true so a
+    // keep followed by navigation still lands. fps come from the backend's
+    // transform response and ride the stored edit records.
+    function sendSignals(kind, fps) {
+      const list = Array.isArray(fps) ? fps.slice(0, 8) : [];
+      if (!list.length) return;
+      try {
+        fetchFn(backend + '/api/embed/event', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'X-Morph-Key': config.key },
+          body: JSON.stringify({ kind, fps: list }),
+          keepalive: true,
+        }).catch(() => {});
+      } catch (_) { /* signals must never break the host page */ }
+    }
+
     function init() {
       if (typeof config.key !== 'string' || !config.key) {
         throw new TypeError('Morph: init requires a publishable key (config.key)');
@@ -3087,8 +3107,10 @@
           bar.setStatus('Couldn’t make that change here — try rephrasing.', '');
           return;
         }
+        const fps = (resp && resp.signal && Array.isArray(resp.signal.fps)) ? resp.signal.fps : [];
         const anchored = DSL.withAnchors ? DSL.withAnchors(transform, win.document) : transform;
-        const edit = await store.appendEdit(pathKey(), anchored, { prompt });
+        const edit = await store.appendEdit(pathKey(), anchored, { prompt, fps });
+        if (edit) sendSignals('kept', fps);
         const note = handle.failed ? ' (' + handle.failed + ' op(s) skipped)' : '';
         const explanation = (resp.transform && resp.transform.explanation) || 'Done.';
         // setStatus renders TRUSTED HTML (innerHTML) — escape the model's
@@ -3113,7 +3135,14 @@
 
     // Per-edit dismissal (HAX G8/G9): drop ONE edit, keep the rest.
     async function removeEdit(id) {
+      let fps = [];
+      try {
+        const edits = await store.listEdits(pathKey());
+        const e = edits.find((x) => x.id === id);
+        fps = (e && e.fps) || [];
+      } catch (_) { /* signal lookup is best-effort */ }
       await store.removeEdit(pathKey(), id);
+      sendSignals('undone', fps);
       await reapplyFromStore();
       await refreshCount();
       try { bar.setStatus('Change removed.', ''); } catch (_) { /* noop */ }
@@ -3131,6 +3160,14 @@
     async function resetPage() {
       if (currentHandle) { DSL.undoTransform(currentHandle); currentHandle = null; }
       activeTransform = null;
+      try {
+        const edits = await store.listEdits(pathKey());
+        const union = [];
+        for (const e of edits) for (const f of (e.fps || [])) {
+          if (union.length < 8 && !union.includes(f)) union.push(f);
+        }
+        sendSignals('undone', union);
+      } catch (_) { /* best-effort */ }
       await store.removeRecipe(pathKey());
       await refreshCount();
       if (ui) await openPanelIfRendered();
@@ -3171,6 +3208,12 @@
       const v = DSL.validateTransform(recipe.transform);
       if (!v.ok) return;
 
+      const savedFps = [];
+      for (const e of (recipe.edits || [])) {
+        if (!e || e.enabled === false) continue;
+        for (const f of (e.fps || [])) if (savedFps.length < 8 && !savedFps.includes(f)) savedFps.push(f);
+      }
+
       // 1) instant CSS so the page doesn't flash unstyled
       const cssOnly = Object.assign({}, v.transform, { ops: v.transform.ops.filter((o) => o.op === 'injectCSS') });
       let cssHandle = null;
@@ -3183,6 +3226,7 @@
         if (cssHandle) { DSL.undoTransform(cssHandle); cssHandle = null; }
         if (!transform.ops.length) return;
         await applyMerged(transform, data);
+        sendSignals('reapplied', savedFps);
       };
       if (win.document.readyState === 'loading') {
         win.document.addEventListener('DOMContentLoaded', () => { full().catch(() => {}); }, { once: true });

package/package.json

@@ -1,37 +1,37 @@
-{
-  "name": "morph-embed",
-  "version": "0.2.2",
-  "description": "Embed a prompt bar in your product so users can generate the features you haven't built — real-data widgets, layout reshapes, and confirm-gated actions. Declarative-DSL security model; your data never leaves the page.",
-  "license": "MIT",
-  "main": "dist/morph-embed.esm.mjs",
-  "exports": {
-    ".": "./dist/morph-embed.esm.mjs",
-    "./iife": "./dist/morph-embed.js"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mandarwagh9/morph.git",
-    "directory": "sdk"
-  },
-  "homepage": "https://usemorph.xyz",
-  "bugs": {
-    "url": "https://github.com/mandarwagh9/morph/issues"
-  },
-  "author": "Mandar Wagh (https://usemorph.xyz)",
-  "keywords": [
-    "generative-ui",
-    "copilot",
-    "embed",
-    "widgets",
-    "prompt",
-    "llm",
-    "dashboard",
-    "no-code",
-    "morph"
-  ]
-}
+{
+  "name": "morph-embed",
+  "version": "0.3.0",
+  "description": "Embed a prompt bar in your product so users can generate the features you haven't built — real-data widgets, layout reshapes, and confirm-gated actions. Declarative-DSL security model; your data never leaves the page.",
+  "license": "MIT",
+  "main": "dist/morph-embed.esm.mjs",
+  "exports": {
+    ".": "./dist/morph-embed.esm.mjs",
+    "./iife": "./dist/morph-embed.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mandarwagh9/morph-embed.git",
+    "directory": "sdk"
+  },
+  "homepage": "https://usemorph.xyz",
+  "bugs": {
+    "url": "https://github.com/mandarwagh9/morph/issues"
+  },
+  "author": "Mandar Wagh (https://usemorph.xyz)",
+  "keywords": [
+    "generative-ui",
+    "copilot",
+    "embed",
+    "widgets",
+    "prompt",
+    "llm",
+    "dashboard",
+    "no-code",
+    "morph"
+  ]
+}