flipbookengine 0.6.5 → 1.0.0

package/dist/index-BhTR2SK6.js

@@ -0,0 +1,366 @@
+var C = Object.defineProperty;
+var B = (t, i, e) => i in t ? C(t, i, { enumerable: !0, configurable: !0, writable: !0, value: e }) : t[i] = e;
+var p = (t, i, e) => B(t, typeof i != "symbol" ? i + "" : i, e);
+var q = Symbol.for("preact-signals");
+function S() {
+  if (u > 1)
+    u--;
+  else {
+    var t, i = !1;
+    for (function() {
+      var o = w;
+      for (w = void 0; o !== void 0; )
+        o.S.v === o.v && (o.S.i = o.i), o = o.o;
+    }(); c !== void 0; ) {
+      var e = c;
+      for (c = void 0, y++; e !== void 0; ) {
+        var r = e.u;
+        if (e.u = void 0, e.f &= -3, !(8 & e.f) && m(e)) try {
+          e.c();
+        } catch (o) {
+          i || (t = o, i = !0);
+        }
+        e = r;
+      }
+    }
+    if (y = 0, u--, i) throw t;
+  }
+}
+var s = void 0;
+function b(t) {
+  var i = s;
+  s = void 0;
+  try {
+    return t();
+  } finally {
+    s = i;
+  }
+}
+var c = void 0, u = 0, y = 0, E = 0, w = void 0, g = 0;
+function x(t) {
+  if (s !== void 0) {
+    var i = t.n;
+    if (i === void 0 || i.t !== s)
+      return i = { i: 0, S: t, p: s.s, n: void 0, t: s, e: void 0, x: void 0, r: i }, s.s !== void 0 && (s.s.n = i), s.s = i, t.n = i, 32 & s.f && t.S(i), i;
+    if (i.i === -1)
+      return i.i = 0, i.n !== void 0 && (i.n.p = i.p, i.p !== void 0 && (i.p.n = i.n), i.p = s.s, i.n = void 0, s.s.n = i, s.s = i), i;
+  }
+}
+function h(t, i) {
+  this.v = t, this.i = 0, this.n = void 0, this.t = void 0, this.l = 0, this.W = i == null ? void 0 : i.watched, this.Z = i == null ? void 0 : i.unwatched, this.name = i == null ? void 0 : i.name;
+}
+h.prototype.brand = q;
+h.prototype.h = function() {
+  return !0;
+};
+h.prototype.S = function(t) {
+  var i = this, e = this.t;
+  e !== t && t.e === void 0 && (t.x = e, this.t = t, e !== void 0 ? e.e = t : b(function() {
+    var r;
+    (r = i.W) == null || r.call(i);
+  }));
+};
+h.prototype.U = function(t) {
+  var i = this;
+  if (this.t !== void 0) {
+    var e = t.e, r = t.x;
+    e !== void 0 && (e.x = r, t.e = void 0), r !== void 0 && (r.e = e, t.x = void 0), t === this.t && (this.t = r, r === void 0 && b(function() {
+      var o;
+      (o = i.Z) == null || o.call(i);
+    }));
+  }
+};
+h.prototype.subscribe = function(t) {
+  var i = this;
+  return F(function() {
+    var e = i.value;
+    b(function() {
+      return t(e);
+    });
+  }, { name: "sub" });
+};
+h.prototype.valueOf = function() {
+  return this.value;
+};
+h.prototype.toString = function() {
+  return this.value + "";
+};
+h.prototype.toJSON = function() {
+  return this.value;
+};
+h.prototype.peek = function() {
+  var t = this;
+  return b(function() {
+    return t.value;
+  });
+};
+Object.defineProperty(h.prototype, "value", { get: function() {
+  var t = x(this);
+  return t !== void 0 && (t.i = this.i), this.v;
+}, set: function(t) {
+  if (t !== this.v) {
+    if (y > 100) throw new Error("Cycle detected");
+    (function(e) {
+      u !== 0 && y === 0 && e.l !== E && (e.l = E, w = { S: e, v: e.v, i: e.i, o: w });
+    })(this), this.v = t, this.i++, g++, u++;
+    try {
+      for (var i = this.t; i !== void 0; i = i.x) i.t.N();
+    } finally {
+      S();
+    }
+  }
+} });
+function I(t, i) {
+  return new h(t, i);
+}
+function m(t) {
+  for (var i = t.s; i !== void 0; i = i.n) if (i.S.i !== i.i || !i.S.h() || i.S.i !== i.i) return !0;
+  return !1;
+}
+function k(t) {
+  for (var i = t.s; i !== void 0; i = i.n) {
+    var e = i.S.n;
+    if (e !== void 0 && (i.r = e), i.S.n = i, i.i = -1, i.n === void 0) {
+      t.s = i;
+      break;
+    }
+  }
+}
+function $(t) {
+  for (var i = t.s, e = void 0; i !== void 0; ) {
+    var r = i.p;
+    i.i === -1 ? (i.S.U(i), r !== void 0 && (r.n = i.n), i.n !== void 0 && (i.n.p = r)) : e = i, i.S.n = i.r, i.r !== void 0 && (i.r = void 0), i = r;
+  }
+  t.s = e;
+}
+function l(t, i) {
+  h.call(this, void 0, i), this.x = t, this.s = void 0, this.g = g - 1, this.f = 4;
+}
+l.prototype = new h();
+l.prototype.h = function() {
+  if (this.f &= -3, 1 & this.f) return !1;
+  if ((36 & this.f) == 32 || (this.f &= -5, this.g === g)) return !0;
+  if (this.g = g, this.f |= 1, this.i > 0 && !m(this))
+    return this.f &= -2, !0;
+  var t = s;
+  try {
+    k(this), s = this;
+    var i = this.x();
+    (16 & this.f || this.v !== i || this.i === 0) && (this.v = i, this.f &= -17, this.i++);
+  } catch (e) {
+    this.v = e, this.f |= 16, this.i++;
+  }
+  return s = t, $(this), this.f &= -2, !0;
+};
+l.prototype.S = function(t) {
+  if (this.t === void 0) {
+    this.f |= 36;
+    for (var i = this.s; i !== void 0; i = i.n) i.S.S(i);
+  }
+  h.prototype.S.call(this, t);
+};
+l.prototype.U = function(t) {
+  if (this.t !== void 0 && (h.prototype.U.call(this, t), this.t === void 0)) {
+    this.f &= -33;
+    for (var i = this.s; i !== void 0; i = i.n) i.S.U(i);
+  }
+};
+l.prototype.N = function() {
+  if (!(2 & this.f)) {
+    this.f |= 6;
+    for (var t = this.t; t !== void 0; t = t.x) t.t.N();
+  }
+};
+Object.defineProperty(l.prototype, "value", { get: function() {
+  if (1 & this.f) throw new Error("Cycle detected");
+  var t = x(this);
+  if (this.h(), t !== void 0 && (t.i = this.i), 16 & this.f) throw this.v;
+  return this.v;
+} });
+function M(t, i) {
+  return new l(t, i);
+}
+function A(t) {
+  var i = t.m;
+  if (t.m = void 0, typeof i == "function") {
+    u++;
+    var e = s;
+    s = void 0;
+    try {
+      i();
+    } catch (r) {
+      throw t.f &= -2, t.f |= 8, P(t), r;
+    } finally {
+      s = e, S();
+    }
+  }
+}
+function P(t) {
+  for (var i = t.s; i !== void 0; i = i.n) i.S.U(i);
+  t.x = void 0, t.s = void 0, A(t);
+}
+function U(t) {
+  if (s !== this) throw new Error("Out-of-order effect");
+  $(this), s = t, this.f &= -2, 8 & this.f && P(this), S();
+}
+function d(t, i) {
+  this.x = t, this.m = void 0, this.s = void 0, this.u = void 0, this.f = 32, this.name = i == null ? void 0 : i.name;
+}
+d.prototype.c = function() {
+  var t = this.S();
+  try {
+    if (8 & this.f || this.x === void 0) return;
+    var i = this.x();
+    typeof i == "function" && (this.m = i);
+  } finally {
+    t();
+  }
+};
+d.prototype.S = function() {
+  if (1 & this.f) throw new Error("Cycle detected");
+  this.f |= 1, this.f &= -9, A(this), k(this), u++;
+  var t = s;
+  return s = this, U.bind(this, t);
+};
+d.prototype.N = function() {
+  2 & this.f || (this.f |= 2, this.u = c, c = this);
+};
+d.prototype.d = function() {
+  this.f |= 8, 1 & this.f || P(this);
+};
+d.prototype.dispose = function() {
+  this.d();
+};
+function F(t, i) {
+  var e = new d(t, i);
+  try {
+    e.c();
+  } catch (o) {
+    throw e.d(), o;
+  }
+  var r = e.d.bind(e);
+  return r[Symbol.dispose] = r, r;
+}
+/**
+ * @license FlipbookEngine v1.0.0
+ * Copyright (c) 2026 Murat Dogan
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+class N {
+  constructor() {
+    p(this, "version", I(0));
+    p(this, "activePanelId", I(null));
+    p(this, "plugins", /* @__PURE__ */ new Map());
+  }
+  install(i, e) {
+    const r = String((e == null ? void 0 : e.name) || "").trim();
+    if (!r) throw new Error("Flipbook plugin name is required.");
+    if (this.plugins.has(r)) throw new Error(`Flipbook plugin "${r}" is already installed.`);
+    const o = {
+      plugin: e,
+      context: void 0,
+      cleanups: /* @__PURE__ */ new Set(),
+      toolbarButtons: /* @__PURE__ */ new Map(),
+      panels: /* @__PURE__ */ new Map(),
+      apis: /* @__PURE__ */ new Map()
+    }, v = {
+      engine: i,
+      pluginName: r,
+      activePanelId: this.activePanelId,
+      registerToolbarButton: (n) => {
+        const a = this.requireContributionId(n == null ? void 0 : n.id, "toolbar button");
+        if (o.toolbarButtons.has(a)) throw new Error(`Plugin "${r}" already registered toolbar button "${a}".`);
+        return o.toolbarButtons.set(a, n), this.version.value++, () => {
+          o.toolbarButtons.delete(a) && this.version.value++;
+        };
+      },
+      registerPanel: (n) => {
+        const a = this.requireContributionId(n == null ? void 0 : n.id, "panel");
+        if (o.panels.has(a)) throw new Error(`Plugin "${r}" already registered panel "${a}".`);
+        return o.panels.set(a, n), this.version.value++, () => {
+          o.panels.delete(a) && (this.activePanelId.value === this.key(r, a) && (this.activePanelId.value = null), this.version.value++);
+        };
+      },
+      registerApi: (n, a) => {
+        const f = this.requireContributionId(n, "API");
+        if (o.apis.has(f)) throw new Error(`Plugin "${r}" already registered API "${f}".`);
+        return o.apis.set(f, a), this.version.value++, () => {
+          o.apis.delete(f) && this.version.value++;
+        };
+      },
+      on: (n, a) => {
+        const f = i.on(n, a);
+        return o.cleanups.add(f), () => {
+          o.cleanups.delete(f), f();
+        };
+      },
+      openPanel: (n) => {
+        const a = this.requireContributionId(n, "panel");
+        if (!o.panels.has(a)) throw new Error(`Plugin "${r}" has no panel "${a}".`);
+        this.activePanelId.value = this.key(r, a);
+      },
+      closePanel: (n) => {
+        const a = n ? this.key(r, n) : null;
+        (!n || this.activePanelId.value === a) && (this.activePanelId.value = null);
+      },
+      addCleanup: (n) => {
+        typeof n == "function" && o.cleanups.add(n);
+      }
+    };
+    o.context = v, this.plugins.set(r, o);
+    try {
+      const n = e.install(i, v);
+      typeof n == "function" && o.cleanups.add(n);
+    } catch (n) {
+      throw this.plugins.delete(r), o.cleanups.forEach((a) => a()), n;
+    }
+    this.version.value++;
+  }
+  uninstall(i) {
+    var r;
+    const e = this.plugins.get(i);
+    return e ? ((r = this.activePanelId.value) != null && r.startsWith(i + ":") && (this.activePanelId.value = null), e.cleanups.forEach((o) => o()), e.toolbarButtons.clear(), e.panels.clear(), e.apis.clear(), this.plugins.delete(i), this.version.value++, !0) : !1;
+  }
+  clear() {
+    Array.from(this.plugins.keys()).forEach((i) => this.uninstall(i));
+  }
+  getPluginNames() {
+    return Array.from(this.plugins.keys());
+  }
+  getToolbarButtons() {
+    const i = [];
+    return this.plugins.forEach((e, r) => e.toolbarButtons.forEach((o, v) => {
+      i.push({ ...o, pluginName: r, key: this.key(r, v) });
+    })), i;
+  }
+  getPanels() {
+    const i = [];
+    return this.plugins.forEach((e, r) => e.panels.forEach((o, v) => {
+      i.push({ ...o, pluginName: r, key: this.key(r, v) });
+    })), i;
+  }
+  getApi(i, e) {
+    var r;
+    return (r = this.plugins.get(i)) == null ? void 0 : r.apis.get(e);
+  }
+  async callApi(i, e, ...r) {
+    const o = this.getApi(i, e);
+    if (!o) throw new Error(`Plugin API "${i}.${e}" is not registered.`);
+    return await o(...r);
+  }
+  key(i, e) {
+    return `${i}:${e}`;
+  }
+  requireContributionId(i, e) {
+    const r = String(i || "").trim();
+    if (!r) throw new Error(`Flipbook plugin ${e} id is required.`);
+    return r;
+  }
+}
+export {
+  N as F,
+  M as g,
+  F as j,
+  I as y
+};
+//# sourceMappingURL=index-BhTR2SK6.js.map

package/dist/index-BhTR2SK6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-BhTR2SK6.js","sources":["../node_modules/@preact/signals-core/dist/signals-core.module.js","../src/plugins/index.ts"],"sourcesContent":["var i=Symbol.for(\"preact-signals\");function t(){if(!(s>1)){var i,t=!1;!function(){var i=c;c=void 0;while(void 0!==i){if(i.S.v===i.v)i.S.i=i.i;i=i.o}}();while(void 0!==h){var n=h;h=void 0;v++;while(void 0!==n){var r=n.u;n.u=void 0;n.f&=-3;if(!(8&n.f)&&w(n))try{n.c()}catch(n){if(!t){i=n;t=!0}}n=r}}v=0;s--;if(t)throw i}else s--}function n(i){if(s>0)return i();e=++u;s++;try{return i()}finally{t()}}var r=void 0;function o(i){var t=r;r=void 0;try{return i()}finally{r=t}}var f,h=void 0,s=0,v=0,u=0,e=0,c=void 0,d=0;function a(i){if(void 0!==r){var t=i.n;if(void 0===t||t.t!==r){t={i:0,S:i,p:r.s,n:void 0,t:r,e:void 0,x:void 0,r:t};if(void 0!==r.s)r.s.n=t;r.s=t;i.n=t;if(32&r.f)i.S(t);return t}else if(-1===t.i){t.i=0;if(void 0!==t.n){t.n.p=t.p;if(void 0!==t.p)t.p.n=t.n;t.p=r.s;t.n=void 0;r.s.n=t;r.s=t}return t}}}function l(i,t){this.v=i;this.i=0;this.n=void 0;this.t=void 0;this.l=0;this.W=null==t?void 0:t.watched;this.Z=null==t?void 0:t.unwatched;this.name=null==t?void 0:t.name}l.prototype.brand=i;l.prototype.h=function(){return!0};l.prototype.S=function(i){var t=this,n=this.t;if(n!==i&&void 0===i.e){i.x=n;this.t=i;if(void 0!==n)n.e=i;else o(function(){var i;null==(i=t.W)||i.call(t)})}};l.prototype.U=function(i){var t=this;if(void 0!==this.t){var n=i.e,r=i.x;if(void 0!==n){n.x=r;i.e=void 0}if(void 0!==r){r.e=n;i.x=void 0}if(i===this.t){this.t=r;if(void 0===r)o(function(){var i;null==(i=t.Z)||i.call(t)})}}};l.prototype.subscribe=function(i){var t=this;return j(function(){var n=t.value;o(function(){return i(n)})},{name:\"sub\"})};l.prototype.valueOf=function(){return this.value};l.prototype.toString=function(){return this.value+\"\"};l.prototype.toJSON=function(){return this.value};l.prototype.peek=function(){var i=this;return o(function(){return i.value})};Object.defineProperty(l.prototype,\"value\",{get:function(){var i=a(this);if(void 0!==i)i.i=this.i;return this.v},set:function(i){if(i!==this.v){if(v>100)throw new Error(\"Cycle detected\");!function(i){if(0!==s&&0===v)if(i.l!==e){i.l=e;c={S:i,v:i.v,i:i.i,o:c}}}(this);this.v=i;this.i++;d++;s++;try{for(var n=this.t;void 0!==n;n=n.x)n.t.N()}finally{t()}}}});function y(i,t){return new l(i,t)}function w(i){for(var t=i.s;void 0!==t;t=t.n)if(t.S.i!==t.i||!t.S.h()||t.S.i!==t.i)return!0;return!1}function _(i){for(var t=i.s;void 0!==t;t=t.n){var n=t.S.n;if(void 0!==n)t.r=n;t.S.n=t;t.i=-1;if(void 0===t.n){i.s=t;break}}}function b(i){var t=i.s,n=void 0;while(void 0!==t){var r=t.p;if(-1===t.i){t.S.U(t);if(void 0!==r)r.n=t.n;if(void 0!==t.n)t.n.p=r}else n=t;t.S.n=t.r;if(void 0!==t.r)t.r=void 0;t=r}i.s=n}function p(i,t){l.call(this,void 0,t);this.x=i;this.s=void 0;this.g=d-1;this.f=4}p.prototype=new l;p.prototype.h=function(){this.f&=-3;if(1&this.f)return!1;if(32==(36&this.f))return!0;this.f&=-5;if(this.g===d)return!0;this.g=d;this.f|=1;if(this.i>0&&!w(this)){this.f&=-2;return!0}var i=r;try{_(this);r=this;var t=this.x();if(16&this.f||this.v!==t||0===this.i){this.v=t;this.f&=-17;this.i++}}catch(i){this.v=i;this.f|=16;this.i++}r=i;b(this);this.f&=-2;return!0};p.prototype.S=function(i){if(void 0===this.t){this.f|=36;for(var t=this.s;void 0!==t;t=t.n)t.S.S(t)}l.prototype.S.call(this,i)};p.prototype.U=function(i){if(void 0!==this.t){l.prototype.U.call(this,i);if(void 0===this.t){this.f&=-33;for(var t=this.s;void 0!==t;t=t.n)t.S.U(t)}}};p.prototype.N=function(){if(!(2&this.f)){this.f|=6;for(var i=this.t;void 0!==i;i=i.x)i.t.N()}};Object.defineProperty(p.prototype,\"value\",{get:function(){if(1&this.f)throw new Error(\"Cycle detected\");var i=a(this);this.h();if(void 0!==i)i.i=this.i;if(16&this.f)throw this.v;return this.v}});function g(i,t){return new p(i,t)}function S(i){var n=i.m;i.m=void 0;if(\"function\"==typeof n){s++;var o=r;r=void 0;try{n()}catch(t){i.f&=-2;i.f|=8;m(i);throw t}finally{r=o;t()}}}function m(i){for(var t=i.s;void 0!==t;t=t.n)t.S.U(t);i.x=void 0;i.s=void 0;S(i)}function x(i){if(r!==this)throw new Error(\"Out-of-order effect\");b(this);r=i;this.f&=-2;if(8&this.f)m(this);t()}function E(i,t){this.x=i;this.m=void 0;this.s=void 0;this.u=void 0;this.f=32;this.name=null==t?void 0:t.name;if(f)f.push(this)}E.prototype.c=function(){var i=this.S();try{if(8&this.f)return;if(void 0===this.x)return;var t=this.x();if(\"function\"==typeof t)this.m=t}finally{i()}};E.prototype.S=function(){if(1&this.f)throw new Error(\"Cycle detected\");this.f|=1;this.f&=-9;S(this);_(this);s++;var i=r;r=this;return x.bind(this,i)};E.prototype.N=function(){if(!(2&this.f)){this.f|=2;this.u=h;h=this}};E.prototype.d=function(){this.f|=8;if(!(1&this.f))m(this)};E.prototype.dispose=function(){this.d()};function j(i,t){var n=new E(i,t);try{n.c()}catch(i){n.d();throw i}var r=n.d.bind(n);r[Symbol.dispose]=r;return r}function C(i){return function(){var t=arguments,r=this;return n(function(){return o(function(){return i.apply(r,[].slice.call(t))})})}}function O(){var i=f;f=[];return function(){var t=f;if(f&&i)i=i.concat(f);f=i;return t}}var k=function(i){for(var t in i){var n=i[t];if(\"function\"==typeof n)i[t]=C(n);else if(\"object\"==typeof n&&null!==n&&!(\"brand\"in n))k(n)}};function T(i){return function(){var t,n,r=O();try{n=i.apply(void 0,[].slice.call(arguments))}catch(i){f=void 0;throw i}finally{t=r()}k(n);n[Symbol.dispose]=C(function(){if(t)for(var i=0;i<t.length;i++)t[i].dispose();t=void 0});return n}}export{p as Computed,E as Effect,l as Signal,C as action,n as batch,g as computed,T as createModel,j as effect,y as signal,o as untracked};//# sourceMappingURL=signals-core.module.js.map\n","/**\n * @license FlipbookEngine v1.0.0\n * Copyright (c) 2026 Murat Dogan\n * SPDX-License-Identifier: AGPL-3.0-or-later\n */\n\nimport { signal, type Signal } from '@preact/signals-core';\nimport type {\n    FlipbookEngine,\n    FlipbookEngineEventMap,\n    FlipbookEngineEventName\n} from '../engine';\n\nexport type FlipbookPluginEventHandler<T extends FlipbookEngineEventName> =\n    (payload: FlipbookEngineEventMap[T]) => void;\n\nexport interface FlipbookPluginToolbarButton {\n    /** Stable identifier within the plugin namespace. */\n    id: string;\n    /** Visible label. Keep this short; hosts can localize it before registration. */\n    label: string;\n    title?: string;\n    /** Optional text/icon token rendered by the built-in toolbar. */\n    icon?: string;\n    /** Toolbar group placement. */\n    placement?: 'start' | 'end';\n    disabled?: boolean | (() => boolean);\n    onClick: () => void;\n}\n\nexport interface FlipbookPluginPanel {\n    /** Stable identifier within the plugin namespace. */\n    id: string;\n    title?: string;\n    /** Called when the panel is mounted. Return a cleanup function when needed. */\n    render: (container: HTMLElement) => void | (() => void);\n}\n\nexport type FlipbookPluginApiHandler = (...args: any[]) => unknown | Promise<unknown>;\n\nexport interface FlipbookPluginContext {\n    readonly engine: FlipbookEngine;\n    readonly pluginName: string;\n    readonly activePanelId: Signal<string | null>;\n    registerToolbarButton(button: FlipbookPluginToolbarButton): () => void;\n    registerPanel(panel: FlipbookPluginPanel): () => void;\n    registerApi<T extends FlipbookPluginApiHandler>(name: string, handler: T): () => void;\n    on<T extends FlipbookEngineEventName>(eventName: T, handler: FlipbookPluginEventHandler<T>): () => void;\n    openPanel(id: string): void;\n    closePanel(id?: string): void;\n    addCleanup(cleanup: () => void): void;\n}\n\nexport interface FlipbookPlugin {\n    /** Stable plugin namespace. Duplicate names are rejected. */\n    name: string;\n    /** Installs contributions and may return an additional cleanup callback. */\n    install: (engine: FlipbookEngine, context: FlipbookPluginContext) => void | (() => void);\n}\n\ninterface RegisteredPlugin {\n    plugin: FlipbookPlugin;\n    context: FlipbookPluginContext;\n    cleanups: Set<() => void>;\n    toolbarButtons: Map<string, FlipbookPluginToolbarButton>;\n    panels: Map<string, FlipbookPluginPanel>;\n    apis: Map<string, FlipbookPluginApiHandler>;\n}\n\n/** Internal registry exposed to UI components through the engine. */\nexport class FlipbookPluginRegistry {\n    readonly version = signal(0);\n    readonly activePanelId = signal<string | null>(null);\n    private readonly plugins = new Map<string, RegisteredPlugin>();\n\n    install(engine: FlipbookEngine, plugin: FlipbookPlugin): void {\n        const name = String(plugin?.name || '').trim();\n        if (!name) throw new Error('Flipbook plugin name is required.');\n        if (this.plugins.has(name)) throw new Error(`Flipbook plugin \"${name}\" is already installed.`);\n\n        const registered: RegisteredPlugin = {\n            plugin,\n            context: undefined as unknown as FlipbookPluginContext,\n            cleanups: new Set(),\n            toolbarButtons: new Map(),\n            panels: new Map(),\n            apis: new Map()\n        };\n\n        const context: FlipbookPluginContext = {\n            engine,\n            pluginName: name,\n            activePanelId: this.activePanelId,\n            registerToolbarButton: (button) => {\n                const id = this.requireContributionId(button?.id, 'toolbar button');\n                if (registered.toolbarButtons.has(id)) throw new Error(`Plugin \"${name}\" already registered toolbar button \"${id}\".`);\n                registered.toolbarButtons.set(id, button);\n                this.version.value++;\n                return () => {\n                    if (registered.toolbarButtons.delete(id)) this.version.value++;\n                };\n            },\n            registerPanel: (panel) => {\n                const id = this.requireContributionId(panel?.id, 'panel');\n                if (registered.panels.has(id)) throw new Error(`Plugin \"${name}\" already registered panel \"${id}\".`);\n                registered.panels.set(id, panel);\n                this.version.value++;\n                return () => {\n                    if (registered.panels.delete(id)) {\n                        if (this.activePanelId.value === this.key(name, id)) this.activePanelId.value = null;\n                        this.version.value++;\n                    }\n                };\n            },\n            registerApi: (id, handler) => {\n                const apiId = this.requireContributionId(id, 'API');\n                if (registered.apis.has(apiId)) throw new Error(`Plugin \"${name}\" already registered API \"${apiId}\".`);\n                registered.apis.set(apiId, handler);\n                this.version.value++;\n                return () => {\n                    if (registered.apis.delete(apiId)) this.version.value++;\n                };\n            },\n            on: (eventName, handler) => {\n                const unsubscribe = engine.on(eventName, handler);\n                registered.cleanups.add(unsubscribe);\n                return () => {\n                    registered.cleanups.delete(unsubscribe);\n                    unsubscribe();\n                };\n            },\n            openPanel: (id) => {\n                const panelId = this.requireContributionId(id, 'panel');\n                if (!registered.panels.has(panelId)) throw new Error(`Plugin \"${name}\" has no panel \"${panelId}\".`);\n                this.activePanelId.value = this.key(name, panelId);\n            },\n            closePanel: (id) => {\n                const expected = id ? this.key(name, id) : null;\n                if (!id || this.activePanelId.value === expected) this.activePanelId.value = null;\n            },\n            addCleanup: (cleanup) => {\n                if (typeof cleanup === 'function') registered.cleanups.add(cleanup);\n            }\n        };\n\n        registered.context = context;\n        this.plugins.set(name, registered);\n        try {\n            const cleanup = plugin.install(engine, context);\n            if (typeof cleanup === 'function') registered.cleanups.add(cleanup);\n        }\n        catch (error) {\n            this.plugins.delete(name);\n            registered.cleanups.forEach((cleanup) => cleanup());\n            throw error;\n        }\n        this.version.value++;\n    }\n\n    uninstall(name: string): boolean {\n        const registered = this.plugins.get(name);\n        if (!registered) return false;\n        if (this.activePanelId.value?.startsWith(name + ':')) this.activePanelId.value = null;\n        registered.cleanups.forEach((cleanup) => cleanup());\n        registered.toolbarButtons.clear();\n        registered.panels.clear();\n        registered.apis.clear();\n        this.plugins.delete(name);\n        this.version.value++;\n        return true;\n    }\n\n    clear(): void {\n        Array.from(this.plugins.keys()).forEach((name) => this.uninstall(name));\n    }\n\n    getPluginNames(): string[] {\n        return Array.from(this.plugins.keys());\n    }\n\n    getToolbarButtons(): Array<FlipbookPluginToolbarButton & { pluginName: string; key: string }> {\n        const result: Array<FlipbookPluginToolbarButton & { pluginName: string; key: string }> = [];\n        this.plugins.forEach((registered, pluginName) => registered.toolbarButtons.forEach((button, id) => {\n            result.push({ ...button, pluginName, key: this.key(pluginName, id) });\n        }));\n        return result;\n    }\n\n    getPanels(): Array<FlipbookPluginPanel & { pluginName: string; key: string }> {\n        const result: Array<FlipbookPluginPanel & { pluginName: string; key: string }> = [];\n        this.plugins.forEach((registered, pluginName) => registered.panels.forEach((panel, id) => {\n            result.push({ ...panel, pluginName, key: this.key(pluginName, id) });\n        }));\n        return result;\n    }\n\n    getApi<T extends FlipbookPluginApiHandler>(pluginName: string, id: string): T | undefined {\n        return this.plugins.get(pluginName)?.apis.get(id) as T | undefined;\n    }\n\n    async callApi<T = unknown>(pluginName: string, id: string, ...args: any[]): Promise<T> {\n        const handler = this.getApi(pluginName, id);\n        if (!handler) throw new Error(`Plugin API \"${pluginName}.${id}\" is not registered.`);\n        return await handler(...args) as T;\n    }\n\n    private key(pluginName: string, id: string): string {\n        return `${pluginName}:${id}`;\n    }\n\n    private requireContributionId(id: string | undefined, kind: string): string {\n        const normalized = String(id || '').trim();\n        if (!normalized) throw new Error(`Flipbook plugin ${kind} id is required.`);\n        return normalized;\n    }\n}\n\n"],"names":["i","t","s","c","h","n","v","w","r","o","e","d","a","l","j","y","_","b","p","g","S","m","x","E","FlipbookPluginRegistry","__publicField","signal","engine","plugin","name","registered","context","button","id","panel","handler","apiId","eventName","unsubscribe","panelId","expected","cleanup","error","_a","result","pluginName","args","kind","normalized"],"mappings":"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","x_google_ignoreList":[0]}

package/dist/index.d.ts

@@ -7,9 +7,16 @@
 export { FlipbookEngine, type FlipbookEngineOptions, type FlipbookLocaleMessages, type PageImages, type FlipbookEngineEventMap, type FlipbookEngineEventName } from './engine';
 export type { FlipbookPageAsset, FlipbookPageKind, FlipbookCropMode, FlipbookSplitDirection, NormalizedFlipbookPage } from './model/pages';
 export type { FlipbookTocEntry } from './model/toc';
+export type { FlipbookSearchHighlight, FlipbookSearchResult, FlipbookSearchOptions } from './model/search';
+export type { FlipbookHotspot, FlipbookHotspotKind, FlipbookHotspotMedia, FlipbookHotspotMediaType, FlipbookHotspotGalleryItem } from './model/hotspots';
+export type { FlipbookAnnotation } from './model/annotations';
+export { FlipbookPluginRegistry } from './plugins';
+export type { FlipbookPlugin, FlipbookPluginContext, FlipbookPluginApiHandler, FlipbookPluginEventHandler, FlipbookPluginPanel, FlipbookPluginToolbarButton } from './plugins';
 export { normalizeFlipbookToc } from './model/toc';
 export { normalizeFlipbookPages, isFlipbookPageAsset } from './model/pages';
 export type { FlipbookLocale, FlipbookMessages, PartialFlipbookMessages } from './i18n/service';
 export type { FlipbookThemeMode, FlipbookBackgroundStyle, FlipbookBackgrounds } from './theme/theme';
 export type { PdfPageMode, PdfPageLayout } from './core/PdfRenderer';
 export { isA3Landscape } from './core/PdfRenderer';
+export { FlipbookEmbedBridge, createFlipbookEmbedController } from './embed';
+export type { FlipbookEmbedOptions, FlipbookEmbedCommandName, FlipbookEmbedCommand, FlipbookEmbedEvent, FlipbookEmbedResponse, FlipbookEmbedState, FlipbookEmbedController } from './embed';

package/dist/model/annotations.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license FlipbookEngine v1.0.0
+ * Copyright (c) 2026 Murat Dogan
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+/** A host-provided note marker anchored to a logical page using 0..1 coordinates. */
+export interface FlipbookAnnotation {
+    id: string;
+    pageIndex: number;
+    x: number;
+    y: number;
+    text: string;
+    color?: string;
+}

package/dist/model/hotspots.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license FlipbookEngine v1.0.0
+ * Copyright (c) 2026 Murat Dogan
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+export type FlipbookHotspotKind = 'info' | 'media' | 'gallery' | 'commerce';
+export type FlipbookHotspotMediaType = 'image' | 'video' | 'audio';
+export interface FlipbookHotspotMedia {
+    type: FlipbookHotspotMediaType;
+    src: string;
+    alt?: string;
+    poster?: string;
+}
+export interface FlipbookHotspotGalleryItem {
+    src: string;
+    alt?: string;
+    href?: string;
+    target?: string;
+}
+/** An interactive overlay anchored to a logical page. Coordinates are 0..1. */
+export interface FlipbookHotspot {
+    id: string;
+    pageIndex: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    label: string;
+    /** Controls the semantic presentation in the popup. */
+    kind?: FlipbookHotspotKind;
+    /** Plain-text description; HTML is never interpreted. */
+    content?: string;
+    /** Optional commerce/product destination. */
+    href?: string;
+    target?: string;
+    /** Optional single image, video, or audio preview. */
+    media?: FlipbookHotspotMedia;
+    /** Optional gallery of image previews. */
+    gallery?: FlipbookHotspotGalleryItem[];
+}

package/dist/model/search.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license FlipbookEngine v1.0.0
+ * Copyright (c) 2026 Murat Dogan
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+/** A normalized text rectangle returned by the client-side PDF text search. */
+export interface FlipbookSearchHighlight {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** A page-level match returned by the client-side PDF text search. */
+export interface FlipbookSearchResult {
+    pageIndex: number;
+    pageNumber: number;
+    matches: number;
+    snippet: string;
+    sourcePageNumber?: number;
+    highlights?: FlipbookSearchHighlight[];
+}
+export interface FlipbookSearchOptions {
+    caseSensitive?: boolean;
+    maxResults?: number;
+}

package/dist/plugins/annotations.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createAnnotationsPlugin(): FlipbookPlugin;
+export declare const annotationsPlugin: FlipbookPlugin;

package/dist/plugins/bookmarks.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createBookmarksPlugin(): FlipbookPlugin;
+export declare const bookmarksPlugin: FlipbookPlugin;

package/dist/plugins/deep-link.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createDeepLinkPlugin(): FlipbookPlugin;
+export declare const deepLinkPlugin: FlipbookPlugin;

package/dist/plugins/feature.d.ts

@@ -0,0 +1,5 @@
+import { FlipbookEngine } from '../engine';
+import { FlipbookPlugin, FlipbookPluginApiHandler, FlipbookPluginContext } from './index';
+
+export type FeatureApiFactory = (engine: FlipbookEngine, context: FlipbookPluginContext) => Record<string, FlipbookPluginApiHandler>;
+export declare function createFeaturePlugin(name: string, factory: FeatureApiFactory): FlipbookPlugin;

package/dist/plugins/hotspots.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createHotspotsPlugin(): FlipbookPlugin;
+export declare const hotspotsPlugin: FlipbookPlugin;

package/dist/plugins/index.d.ts

@@ -0,0 +1,65 @@
+import { Signal } from '@preact/signals-core';
+import { FlipbookEngine, FlipbookEngineEventMap, FlipbookEngineEventName } from '../engine';
+
+export type FlipbookPluginEventHandler<T extends FlipbookEngineEventName> = (payload: FlipbookEngineEventMap[T]) => void;
+export interface FlipbookPluginToolbarButton {
+    /** Stable identifier within the plugin namespace. */
+    id: string;
+    /** Visible label. Keep this short; hosts can localize it before registration. */
+    label: string;
+    title?: string;
+    /** Optional text/icon token rendered by the built-in toolbar. */
+    icon?: string;
+    /** Toolbar group placement. */
+    placement?: 'start' | 'end';
+    disabled?: boolean | (() => boolean);
+    onClick: () => void;
+}
+export interface FlipbookPluginPanel {
+    /** Stable identifier within the plugin namespace. */
+    id: string;
+    title?: string;
+    /** Called when the panel is mounted. Return a cleanup function when needed. */
+    render: (container: HTMLElement) => void | (() => void);
+}
+export type FlipbookPluginApiHandler = (...args: any[]) => unknown | Promise<unknown>;
+export interface FlipbookPluginContext {
+    readonly engine: FlipbookEngine;
+    readonly pluginName: string;
+    readonly activePanelId: Signal<string | null>;
+    registerToolbarButton(button: FlipbookPluginToolbarButton): () => void;
+    registerPanel(panel: FlipbookPluginPanel): () => void;
+    registerApi<T extends FlipbookPluginApiHandler>(name: string, handler: T): () => void;
+    on<T extends FlipbookEngineEventName>(eventName: T, handler: FlipbookPluginEventHandler<T>): () => void;
+    openPanel(id: string): void;
+    closePanel(id?: string): void;
+    addCleanup(cleanup: () => void): void;
+}
+export interface FlipbookPlugin {
+    /** Stable plugin namespace. Duplicate names are rejected. */
+    name: string;
+    /** Installs contributions and may return an additional cleanup callback. */
+    install: (engine: FlipbookEngine, context: FlipbookPluginContext) => void | (() => void);
+}
+/** Internal registry exposed to UI components through the engine. */
+export declare class FlipbookPluginRegistry {
+    readonly version: Signal<number>;
+    readonly activePanelId: Signal<string | null>;
+    private readonly plugins;
+    install(engine: FlipbookEngine, plugin: FlipbookPlugin): void;
+    uninstall(name: string): boolean;
+    clear(): void;
+    getPluginNames(): string[];
+    getToolbarButtons(): Array<FlipbookPluginToolbarButton & {
+        pluginName: string;
+        key: string;
+    }>;
+    getPanels(): Array<FlipbookPluginPanel & {
+        pluginName: string;
+        key: string;
+    }>;
+    getApi<T extends FlipbookPluginApiHandler>(pluginName: string, id: string): T | undefined;
+    callApi<T = unknown>(pluginName: string, id: string, ...args: any[]): Promise<T>;
+    private key;
+    private requireContributionId;
+}

package/dist/plugins/notes.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createNotesPlugin(): FlipbookPlugin;
+export declare const notesPlugin: FlipbookPlugin;

package/dist/plugins/search.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createSearchPlugin(): FlipbookPlugin;
+export declare const searchPlugin: FlipbookPlugin;

package/dist/plugins/share.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createSharePlugin(): FlipbookPlugin;
+export declare const sharePlugin: FlipbookPlugin;

package/dist/plugins/toc.d.ts

@@ -0,0 +1,4 @@
+import { FlipbookPlugin } from './index';
+
+export declare function createTocPlugin(): FlipbookPlugin;
+export declare const tocPlugin: FlipbookPlugin;

package/dist/plugins-annotations.d.ts

@@ -0,0 +1 @@
+export * from './plugins/annotations'

package/dist/plugins-bookmarks.d.ts

@@ -0,0 +1 @@
+export * from './plugins/bookmarks'

package/dist/plugins-deep-link.d.ts

@@ -0,0 +1 @@
+export * from './plugins/deep-link'

package/dist/plugins-hotspots.d.ts

@@ -0,0 +1 @@
+export * from './plugins/hotspots'

package/dist/plugins-notes.d.ts

@@ -0,0 +1 @@
+export * from './plugins/notes'

package/dist/plugins-search.d.ts

@@ -0,0 +1 @@
+export * from './plugins/search'