"""HTML Widget converter — Hybrid embed package."""
from __future__ import annotations
import json
import zipfile
from pathlib import Path
from backend.app.config import TEMPLATES_DIR
from backend.app.converters.base import Artifact, BuildContext, Converter, ConverterResult
from backend.app.security.zipsafe import safe_add_tree
def _esc(s: str) -> str:
return (
str(s)
.replace("&", "&")
.replace("<", "<")
.replace(">", ">")
.replace('"', """)
)
def _slug(s: str) -> str:
return "".join(c if c.isalnum() or c in "-_" else "-" for c in s)[:64]
DEFAULT_INDEX = """
{{EMOJI}} {{TITLE}} — SpaceForge Widget
"""
DEFAULT_LOADER = """(function () {
const root = document.getElementById("sf-root");
if (!root) return;
const url = root.dataset.embed || "{{EMBED_URL}}";
const iframe = document.createElement("iframe");
iframe.src = url;
iframe.title = root.dataset.repo || "Hugging Face Space";
iframe.allow = "accelerometer; camera; microphone; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share";
iframe.allowFullscreen = true;
iframe.referrerPolicy = "strict-origin-when-cross-origin";
iframe.className = "sf-frame";
root.appendChild(iframe);
})();
"""
DEFAULT_CSS = """html,body{margin:0;height:100%;font-family:system-ui,sans-serif;background:#0b1020;color:#e8eefc}
.sf-header{display:flex;gap:1rem;align-items:center;padding:.75rem 1rem;background:#121a33;border-bottom:1px solid #243056}
.sf-header a{color:#8ab4ff;margin-left:auto}
.badge{font-size:.75rem;padding:.15rem .5rem;border-radius:999px;background:#2a3d7a}
#sf-root,.sf-frame{width:100%;height:calc(100vh - 52px);border:0;display:block}
"""
class HtmlWidgetConverter(Converter):
id = "html_widget"
label = "HTML Widget"
mode = "hybrid"
async def convert(self, ctx: BuildContext) -> ConverterResult:
info = ctx.space_info
out_dir = ctx.work_dir / "html_widget"
out_dir.mkdir(parents=True, exist_ok=True)
tpl = TEMPLATES_DIR / "widget"
ctx.info(f"Generating HTML widget for {info['repo_id']} (mode=hybrid)")
title = info.get("title") or info["repo_id"]
embed = info.get("embed_url") or ""
space_url = info.get("space_url") or ""
index = (tpl / "index.html").read_text(encoding="utf-8") if (tpl / "index.html").exists() else DEFAULT_INDEX
index = (
index.replace("{{TITLE}}", _esc(title))
.replace("{{EMBED_URL}}", _esc(embed))
.replace("{{SPACE_URL}}", _esc(space_url))
.replace("{{REPO_ID}}", _esc(info["repo_id"]))
.replace("{{EMOJI}}", info.get("emoji") or "🚀")
.replace("{{MODE}}", "Hybrid")
)
(out_dir / "index.html").write_text(index, encoding="utf-8")
loader = (tpl / "loader.js").read_text(encoding="utf-8") if (tpl / "loader.js").exists() else DEFAULT_LOADER
loader = loader.replace("{{EMBED_URL}}", embed).replace("{{REPO_ID}}", info["repo_id"])
(out_dir / "loader.js").write_text(loader, encoding="utf-8")
style = (tpl / "style.css").read_text(encoding="utf-8") if (tpl / "style.css").exists() else DEFAULT_CSS
(out_dir / "style.css").write_text(style, encoding="utf-8")
meta = {
"product": "SpaceForge",
"target": self.id,
"mode": self.mode,
"space": info["repo_id"],
"embed_url": embed,
"disclaimer": "Hybrid Hosted Wrapper shell — requires the live Space URL.",
}
(out_dir / "spaceforge.json").write_text(json.dumps(meta, indent=2), encoding="utf-8")
(out_dir / "README.md").write_text(
f"# {title} — HTML Widget (Hybrid)\n\n"
f"Open `index.html` or host this folder statically.\n"
f"Embeds: `{embed}`\n\n"
f"**Mode: Hybrid / Hosted Wrapper** — not a local offline app.\n",
encoding="utf-8",
)
zip_path = ctx.work_dir / f"{_slug(info['name'])}-html-widget.zip"
with zipfile.ZipFile(zip_path, "w", zipfile.ZIP_DEFLATED) as zf:
safe_add_tree(zf, out_dir)
ctx.info(f"Wrote {zip_path.name}")
return ConverterResult(
ok=True,
artifact=Artifact(
target_id=self.id,
path=zip_path,
filename=zip_path.name,
mode=self.mode,
notes="Hybrid HTML widget (iframe + loader).",
),
)