@scenar/embed 0.3.0

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Scenar Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,69 @@
+# @scenar/embed
+
+Drop-in host-side embedding for hosted [Scenar](https://github.com/stigmer/scenar)
+tours. Frame a published tour as a responsive, theme-synced iframe without
+hand-writing the `postMessage` listener, the theme sync, or the resize-to-fit
+glue.
+
+It builds on the framework-free embed host controller in `@scenar/core`, so the
+wire protocol is single-sourced and never drifts. It does **not** pull in the
+player runtime (`@scenar/react`) — embedding a hosted tour costs your host page
+nothing but this small package.
+
+## Three ways to use it
+
+### 1. Web component (any framework, or none)
+
+```html
+<script type="module" src="https://cdn.jsdelivr.net/npm/@scenar/embed/dist/embed.global.js"></script>
+
+<scenar-embed
+  src="https://you.github.io/scenar-embeds/welcome-tour/"
+  title="Welcome tour"
+></scenar-embed>
+```
+
+Or, with a bundler:
+
+```ts
+import "@scenar/embed/define"; // registers <scenar-embed>
+```
+
+### 2. React
+
+```tsx
+import { ScenarEmbed } from "@scenar/embed/react";
+
+<ScenarEmbed
+  src="https://you.github.io/scenar-embeds/welcome-tour/"
+  title="Welcome tour"
+/>;
+```
+
+`react` and `react-dom` are optional peer dependencies — only needed for this
+subpath.
+
+### 3. Imperative (build your own host)
+
+```ts
+import { createEmbedMount } from "@scenar/embed";
+
+const mount = createEmbedMount(iframeElement, {
+  src: "https://you.github.io/scenar-embeds/welcome-tour/",
+  theme: "auto",
+  onAspectRatio: ({ widthPx, heightPx }) => {
+    /* size your container */
+  },
+});
+// mount.controller.play(); mount.controller.pause(); …
+// mount.destroy();
+```
+
+## Theme
+
+`theme` is `auto` (default), `light`, or `dark`. `auto` tracks the host page's
+`dark` class on `<html>` and re-themes the embed when it toggles.
+
+## License
+
+Apache-2.0

package/define.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define.d.ts.map

package/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":""}

package/define.js

@@ -0,0 +1,8 @@
+/**
+ * Side-effecting entry: importing `@scenar/embed/define` registers the
+ * `<scenar-embed>` custom element. For bundler hosts that want the tag available
+ * without calling {@link defineScenarEmbed} themselves.
+ */
+import { defineScenarEmbed } from "./element.js";
+defineScenarEmbed();
+//# sourceMappingURL=define.js.map

package/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,iBAAiB,EAAE,CAAC"}

package/element.d.ts

@@ -0,0 +1,55 @@
+/** The custom element tag name. */
+export declare const SCENAR_EMBED_TAG = "scenar-embed";
+/**
+ * SSR-safe base: subclassing `HTMLElement` evaluates at module load, which would
+ * throw in a non-DOM environment (server render). Fall back to a stub so this
+ * module can be imported anywhere; the element is only ever *registered* in a
+ * browser via {@link defineScenarEmbed}.
+ */
+declare const HTMLElementBase: typeof HTMLElement;
+/**
+ * `<scenar-embed src="…">` — a framework-agnostic, drop-in embed for a hosted
+ * Scenar tour. It owns an internal iframe and its responsive box; all bridge
+ * behavior (origin pinning, theme sync, resize → aspect-ratio) comes from
+ * {@link createEmbedMount}, so the element holds no protocol logic of its own.
+ *
+ * Attributes:
+ * - `src` (required) — the absolute embed URL.
+ * - `title` — accessible iframe title (defaults to a generic label).
+ * - `theme` — `auto` (default) | `light` | `dark`.
+ *
+ * Events: re-dispatches every embed event as a DOM `CustomEvent` named
+ * `scenar:<type>` (e.g. `scenar:ready`, `scenar:completed`) with the event in
+ * `detail`, so a vanilla host can listen without touching `postMessage`.
+ *
+ * Imperative transport (`play`/`pause`/`seek`/`setMuted`/`setVolume`) delegates
+ * to the bridge; calls before the element has a `src` are no-ops.
+ */
+export declare class ScenarEmbedElement extends HTMLElementBase {
+    static get observedAttributes(): string[];
+    private iframe;
+    private mount;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    play(): void;
+    pause(): void;
+    seek(timeMs: number): void;
+    setMuted(muted: boolean): void;
+    setVolume(volume: number): void;
+    private titleAttr;
+    private themeAttr;
+    private setAspectRatio;
+    /** Build the host box + the internal iframe (once). */
+    private render;
+    /** (Re)create the bridge for the current `src`/`theme`. */
+    private attach;
+}
+/**
+ * Register `<scenar-embed>` (idempotent and SSR-safe). Pass a custom tag name to
+ * register under a different element name. A no-op when the registry is absent
+ * (server) or the tag is already defined.
+ */
+export declare function defineScenarEmbed(tagName?: string): void;
+export {};
+//# sourceMappingURL=element.d.ts.map

package/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAOA,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAK/C;;;;;GAKG;AACH,QAAA,MAAM,eAAe,EAAE,OAAO,WAGmB,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,SAAQ,eAAe;IACrD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,KAAK,CAA2B;IAExC,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAU9F,IAAI,IAAI,IAAI;IAIZ,KAAK,IAAI,IAAI;IAIb,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,cAAc;IAItB,uDAAuD;IACvD,OAAO,CAAC,MAAM;IAkBd,2DAA2D;IAC3D,OAAO,CAAC,MAAM;CAaf;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,MAAyB,GAAG,IAAI,CAI1E"}

package/element.js

@@ -0,0 +1,129 @@
+import { createEmbedMount } from "./mount.js";
+import { EMBED_BASE_ASPECT_HEIGHT, EMBED_BASE_ASPECT_WIDTH, } from "./resolve.js";
+/** The custom element tag name. */
+export const SCENAR_EMBED_TAG = "scenar-embed";
+/** Accessible iframe title when the host sets none. */
+const DEFAULT_TITLE = "Interactive product tour";
+/**
+ * SSR-safe base: subclassing `HTMLElement` evaluates at module load, which would
+ * throw in a non-DOM environment (server render). Fall back to a stub so this
+ * module can be imported anywhere; the element is only ever *registered* in a
+ * browser via {@link defineScenarEmbed}.
+ */
+const HTMLElementBase = typeof HTMLElement !== "undefined"
+    ? HTMLElement
+    : class {
+    };
+/**
+ * `<scenar-embed src="…">` — a framework-agnostic, drop-in embed for a hosted
+ * Scenar tour. It owns an internal iframe and its responsive box; all bridge
+ * behavior (origin pinning, theme sync, resize → aspect-ratio) comes from
+ * {@link createEmbedMount}, so the element holds no protocol logic of its own.
+ *
+ * Attributes:
+ * - `src` (required) — the absolute embed URL.
+ * - `title` — accessible iframe title (defaults to a generic label).
+ * - `theme` — `auto` (default) | `light` | `dark`.
+ *
+ * Events: re-dispatches every embed event as a DOM `CustomEvent` named
+ * `scenar:<type>` (e.g. `scenar:ready`, `scenar:completed`) with the event in
+ * `detail`, so a vanilla host can listen without touching `postMessage`.
+ *
+ * Imperative transport (`play`/`pause`/`seek`/`setMuted`/`setVolume`) delegates
+ * to the bridge; calls before the element has a `src` are no-ops.
+ */
+export class ScenarEmbedElement extends HTMLElementBase {
+    static get observedAttributes() {
+        return ["src", "title", "theme"];
+    }
+    iframe = null;
+    mount = null;
+    connectedCallback() {
+        if (!this.iframe)
+            this.render();
+        this.attach();
+    }
+    disconnectedCallback() {
+        this.mount?.destroy();
+        this.mount = null;
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue === newValue)
+            return;
+        if (name === "title") {
+            if (this.iframe)
+                this.iframe.setAttribute("title", this.titleAttr());
+            return;
+        }
+        // A new src or theme rebuilds the bridge (and reloads the frame).
+        if (this.isConnected)
+            this.attach();
+    }
+    play() {
+        this.mount?.controller.play();
+    }
+    pause() {
+        this.mount?.controller.pause();
+    }
+    seek(timeMs) {
+        this.mount?.controller.seek(timeMs);
+    }
+    setMuted(muted) {
+        this.mount?.controller.setMuted(muted);
+    }
+    setVolume(volume) {
+        this.mount?.controller.setVolume(volume);
+    }
+    titleAttr() {
+        return this.getAttribute("title") ?? DEFAULT_TITLE;
+    }
+    themeAttr() {
+        const theme = this.getAttribute("theme");
+        return theme === "light" || theme === "dark" ? theme : "auto";
+    }
+    setAspectRatio(width, height) {
+        this.style.aspectRatio = `${width} / ${height}`;
+    }
+    /** Build the host box + the internal iframe (once). */
+    render() {
+        this.style.display = "block";
+        this.style.position = "relative";
+        this.style.width = "100%";
+        this.setAspectRatio(EMBED_BASE_ASPECT_WIDTH, EMBED_BASE_ASPECT_HEIGHT);
+        const iframe = document.createElement("iframe");
+        iframe.setAttribute("title", this.titleAttr());
+        iframe.setAttribute("loading", "lazy");
+        iframe.setAttribute("allow", "autoplay; fullscreen");
+        iframe.setAttribute("allowfullscreen", "");
+        iframe.style.cssText =
+            "position:absolute;inset:0;width:100%;height:100%;border:0;border-radius:inherit";
+        this.appendChild(iframe);
+        this.iframe = iframe;
+    }
+    /** (Re)create the bridge for the current `src`/`theme`. */
+    attach() {
+        const src = this.getAttribute("src");
+        if (!src || !this.iframe)
+            return;
+        this.mount?.destroy();
+        this.mount = createEmbedMount(this.iframe, {
+            src,
+            theme: this.themeAttr(),
+            onAspectRatio: ({ widthPx, heightPx }) => this.setAspectRatio(widthPx, heightPx),
+            onEvent: (event) => this.dispatchEvent(new CustomEvent(`scenar:${event.type}`, { detail: event })),
+        });
+    }
+}
+/**
+ * Register `<scenar-embed>` (idempotent and SSR-safe). Pass a custom tag name to
+ * register under a different element name. A no-op when the registry is absent
+ * (server) or the tag is already defined.
+ */
+export function defineScenarEmbed(tagName = SCENAR_EMBED_TAG) {
+    if (typeof customElements === "undefined")
+        return;
+    if (customElements.get(tagName))
+        return;
+    customElements.define(tagName, ScenarEmbedElement);
+}
+//# sourceMappingURL=element.js.map

package/element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.js","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"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"}

package/embed.global.js

@@ -0,0 +1 @@
+var ScenarEmbed=function(o){"use strict";var I=Object.defineProperty;var N=(o,u,d)=>u in o?I(o,u,{enumerable:!0,configurable:!0,writable:!0,value:d}):o[u]=d;var E=(o,u,d)=>N(o,typeof u!="symbol"?u+"":u,d);const u="scenar-embed";function g(e){return{source:u,v:1,...e}}function S(e){if(typeof e!="object"||e===null)return!1;const s=e;return s.source===u&&s.v===1}function l(e){return typeof e=="number"&&Number.isFinite(e)}function A(e){if(!S(e))return null;const s=e.type;switch(s){case"started":case"paused":case"completed":case"audioBlocked":return{type:s};case"ready":return l(e.totalSteps)&&typeof e.hasNarration=="boolean"?{type:s,totalSteps:e.totalSteps,hasNarration:e.hasNarration}:null;case"resize":return l(e.widthPx)&&l(e.heightPx)?{type:s,widthPx:e.widthPx,heightPx:e.heightPx}:null;case"stepchange":return l(e.stepIndex)&&l(e.totalSteps)?{type:s,stepIndex:e.stepIndex,totalSteps:e.totalSteps}:null;case"progress":return l(e.stepIndex)&&l(e.totalSteps)&&l(e.fraction)?{type:s,stepIndex:e.stepIndex,totalSteps:e.totalSteps,fraction:e.fraction}:null;case"error":return typeof e.message=="string"?{type:s,message:e.message}:null;default:return null}}function w(e,s={}){const{iframe:t,origin:n}=e,{onEvent:r}=s,a=typeof window<"u",c=i=>{var h;(h=t.contentWindow)==null||h.postMessage(g(i),n)},f=i=>{if(i.source!==t.contentWindow||i.origin!==n)return;const h=A(i.data);h&&(r==null||r(h))};return a&&window.addEventListener("message",f),{play:()=>c({type:"play"}),pause:()=>c({type:"pause"}),seek:i=>c({type:"seek",timeMs:i}),setMuted:i=>c({type:"setMuted",muted:i}),setVolume:i=>c({type:"setVolume",volume:i}),prefetch:()=>c({type:"prefetch"}),destroy:()=>{c({type:"destroy"}),a&&window.removeEventListener("message",f)}}}const T=896,C=480;function M(e,s){return e==="light"?"light":e==="dark"||s?"dark":"light"}function _(e,s){const t=new URL(e);return t.searchParams.set("theme",s),t.toString()}function P(e){return new URL(e).origin}function R(){return typeof document<"u"&&document.documentElement.classList.contains("dark")}function O(e,s){const{src:t,theme:n="auto",onAspectRatio:r,onEvent:a}=s,c=P(t);let f=null;const i=()=>{const m=M(n,R());m!==f&&(f=m,e.src=_(t,m))},h=w({iframe:e,origin:c},{onEvent:m=>{m.type==="resize"&&(r==null||r({widthPx:m.widthPx,heightPx:m.heightPx})),a==null||a(m)}});let p;return n==="auto"&&typeof MutationObserver<"u"&&typeof document<"u"&&(p=new MutationObserver(i),p.observe(document.documentElement,{attributes:!0,attributeFilter:["class"]})),i(),{controller:h,destroy(){p==null||p.disconnect(),h.destroy()}}}const k="scenar-embed",x="Interactive product tour",L=typeof HTMLElement<"u"?HTMLElement:class{};class y extends L{constructor(){super(...arguments);E(this,"iframe",null);E(this,"mount",null)}static get observedAttributes(){return["src","title","theme"]}connectedCallback(){this.iframe||this.render(),this.attach()}disconnectedCallback(){var t;(t=this.mount)==null||t.destroy(),this.mount=null}attributeChangedCallback(t,n,r){if(n!==r){if(t==="title"){this.iframe&&this.iframe.setAttribute("title",this.titleAttr());return}this.isConnected&&this.attach()}}play(){var t;(t=this.mount)==null||t.controller.play()}pause(){var t;(t=this.mount)==null||t.controller.pause()}seek(t){var n;(n=this.mount)==null||n.controller.seek(t)}setMuted(t){var n;(n=this.mount)==null||n.controller.setMuted(t)}setVolume(t){var n;(n=this.mount)==null||n.controller.setVolume(t)}titleAttr(){return this.getAttribute("title")??x}themeAttr(){const t=this.getAttribute("theme");return t==="light"||t==="dark"?t:"auto"}setAspectRatio(t,n){this.style.aspectRatio=`${t} / ${n}`}render(){this.style.display="block",this.style.position="relative",this.style.width="100%",this.setAspectRatio(T,C);const t=document.createElement("iframe");t.setAttribute("title",this.titleAttr()),t.setAttribute("loading","lazy"),t.setAttribute("allow","autoplay; fullscreen"),t.setAttribute("allowfullscreen",""),t.style.cssText="position:absolute;inset:0;width:100%;height:100%;border:0;border-radius:inherit",this.appendChild(t),this.iframe=t}attach(){var n;const t=this.getAttribute("src");!t||!this.iframe||((n=this.mount)==null||n.destroy(),this.mount=O(this.iframe,{src:t,theme:this.themeAttr(),onAspectRatio:({widthPx:r,heightPx:a})=>this.setAspectRatio(r,a),onEvent:r=>this.dispatchEvent(new CustomEvent(`scenar:${r.type}`,{detail:r}))}))}}function b(e=k){typeof customElements>"u"||customElements.get(e)||customElements.define(e,y)}return b(),o.ScenarEmbedElement=y,o.defineScenarEmbed=b,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"}),o}({});

package/global.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The IIFE entry, bundled to `dist/embed.global.js` (see vite.config.ts) — the
+ * single pasteable `<script>` for no-bundler hosts. It auto-registers
+ * `<scenar-embed>` on load and also exposes the registrar on `window.ScenarEmbed`
+ * for hosts that register under a custom tag.
+ */
+import { ScenarEmbedElement, defineScenarEmbed } from "./element.js";
+export { ScenarEmbedElement, defineScenarEmbed };
+//# sourceMappingURL=global.d.ts.map

package/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAIrE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC"}

package/global.js

@@ -0,0 +1,10 @@
+/**
+ * The IIFE entry, bundled to `dist/embed.global.js` (see vite.config.ts) — the
+ * single pasteable `<script>` for no-bundler hosts. It auto-registers
+ * `<scenar-embed>` on load and also exposes the registrar on `window.ScenarEmbed`
+ * for hosts that register under a custom tag.
+ */
+import { ScenarEmbedElement, defineScenarEmbed } from "./element.js";
+defineScenarEmbed();
+export { ScenarEmbedElement, defineScenarEmbed };
+//# sourceMappingURL=global.js.map

package/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../src/global.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAErE,iBAAiB,EAAE,CAAC;AAEpB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC"}

package/index.d.ts

@@ -0,0 +1,7 @@
+export { ScenarEmbedElement, defineScenarEmbed, SCENAR_EMBED_TAG } from "./element.js";
+export { createEmbedMount } from "./mount.js";
+export type { EmbedMount, EmbedMountOptions, EmbedAspectRatio } from "./mount.js";
+export { resolveEmbedSrc, resolveTheme, applyThemeToSrc, originFromSrc, EMBED_BASE_ASPECT_WIDTH, EMBED_BASE_ASPECT_HEIGHT, } from "./resolve.js";
+export type { ScenarEmbedTheme, EmbedSource } from "./resolve.js";
+export type { ScenarEmbedEvent, ScenarEmbedCommand } from "@scenar/core";
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGlF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGlE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/index.js

@@ -0,0 +1,11 @@
+// @scenar/embed — public API
+// Drop-in host-side embedding for hosted Scenar tours. Importing this entry has
+// no side effects (it does not register the element); call `defineScenarEmbed()`
+// or import `@scenar/embed/define` to register `<scenar-embed>`.
+// Custom element + registrar
+export { ScenarEmbedElement, defineScenarEmbed, SCENAR_EMBED_TAG } from "./element.js";
+// Framework-free mount (the shared core both adapters build on)
+export { createEmbedMount } from "./mount.js";
+// Pure resolution helpers + baseline constants
+export { resolveEmbedSrc, resolveTheme, applyThemeToSrc, originFromSrc, EMBED_BASE_ASPECT_WIDTH, EMBED_BASE_ASPECT_HEIGHT, } from "./resolve.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,gFAAgF;AAChF,iFAAiF;AACjF,iEAAiE;AAEjE,6BAA6B;AAC7B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvF,gEAAgE;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,+CAA+C;AAC/C,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}

package/mount.d.ts

@@ -0,0 +1,40 @@
+import { type ScenarEmbedEvent, type ScenarEmbedHostController } from "@scenar/core";
+import { type ScenarEmbedTheme } from "./resolve.js";
+/** The embed's exact rendered size, reported over the `resize` event. */
+export interface EmbedAspectRatio {
+    readonly widthPx: number;
+    readonly heightPx: number;
+}
+/** Options for {@link createEmbedMount}. */
+export interface EmbedMountOptions {
+    /** The absolute embed URL, without a theme query (the mount adds it). */
+    readonly src: string;
+    /** Theme strategy (default `auto`). */
+    readonly theme?: ScenarEmbedTheme;
+    /** Called whenever the embed reports a new rendered size, for host layout. */
+    readonly onAspectRatio?: (ratio: EmbedAspectRatio) => void;
+    /** Called for every well-formed event from the pinned embed. */
+    readonly onEvent?: (event: ScenarEmbedEvent) => void;
+}
+/** A live mount: the host controller plus a teardown for all listeners. */
+export interface EmbedMount {
+    /** Imperative transport (play/pause/seek/setMuted/setVolume) over the bridge. */
+    readonly controller: ScenarEmbedHostController;
+    /** Disconnect the theme observer and the controller's message listener. */
+    destroy(): void;
+}
+/**
+ * Wire an existing iframe to a hosted Scenar tour: set its themed `src`, pin the
+ * embed origin, adopt the embed's reported aspect ratio, and (for `theme:auto`)
+ * track the host's dark mode.
+ *
+ * This is the one place the loader's behavior lives. The `<scenar-embed>`
+ * element and the React `<ScenarEmbed>` are thin adapters that create the iframe
+ * + own layout, then hand it here — so neither re-implements the bridge, exactly
+ * as {@link createEmbedHostController} is shared by the console and this loader.
+ *
+ * The caller owns the iframe element (and removes it for full teardown); this
+ * function owns only the listeners it adds, all released by {@link EmbedMount.destroy}.
+ */
+export declare function createEmbedMount(iframe: HTMLIFrameElement, options: EmbedMountOptions): EmbedMount;
+//# sourceMappingURL=mount.d.ts.map

package/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAE/B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAEtB,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC3D,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACtD;AAED,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C,2EAA2E;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,iBAAiB,GACzB,UAAU,CAkDZ"}