galbook 0.0.0-stage → 1.2.4

package/galbook/importers/common.py

@@ -0,0 +1,94 @@
+"""导入器共用：建场景、资源解析、统计。"""
+import os
+import re
+
+
+class SceneB(object):
+    def __init__(self, sid, title, tags=None, route=""):
+        self.id, self.title = sid, title
+        self.ops = []
+        self.tags = list(tags or [])
+        self.route = route
+
+    def add(self, op, **kw):
+        d = {"op": op}
+        d.update({k: v for k, v in kw.items() if v is not None})
+        self.ops.append(d)
+        return d
+
+    def data(self):
+        return {"id": self.id, "title": self.title, "ops": self.ops, "tags": self.tags, "route": self.route}
+
+
+class Assets(object):
+    """资源索引：大小写不敏感、可省扩展名。paths 是相对书目录的路径（如 assets/画像/bg_001.bmp）。"""
+    EXTS = (".png", ".webp", ".jpg", ".jpeg", ".bmp", ".gif", ".svg")
+
+    def __init__(self, paths=(), prefix=""):
+        self.by_stem = {}
+        self.by_name = {}
+        for p in paths:
+            p = p.replace("\\", "/")
+            full = prefix + p
+            base = p.rsplit("/", 1)[-1].lower()
+            stem, ext = os.path.splitext(base)
+            if ext in self.EXTS:
+                self.by_name.setdefault(base, full)
+                self.by_stem.setdefault(stem, full)
+                # 带子目录的 stem（立ち絵/中/灯_中_01_01_02）
+                sub = os.path.splitext(p.lower())[0]
+                self.by_stem.setdefault(sub, full)
+        self.hit = 0
+        self.miss = {}
+
+    @classmethod
+    def from_dir(cls, book_dir, sub="assets"):
+        root = os.path.join(book_dir, sub)
+        paths = []
+        for dp, _, fns in os.walk(root):
+            for fn in fns:
+                paths.append(os.path.relpath(os.path.join(dp, fn), book_dir).replace(os.sep, "/"))
+        return cls(paths)
+
+    @classmethod
+    def from_list(cls, list_file, prefix="assets/"):
+        with open(list_file, encoding="utf-8") as f:
+            return cls([ln.strip() for ln in f if ln.strip()], prefix)
+
+    def find(self, name, kind="img"):
+        if not name:
+            return None
+        k = name.replace("\\", "/").lower()
+        r = self.by_name.get(k.rsplit("/", 1)[-1]) or self.by_stem.get(k) or \
+            self.by_stem.get(os.path.splitext(k)[0]) or self.by_stem.get(k.rsplit("/", 1)[-1])
+        if r:
+            self.hit += 1
+        else:
+            self.miss[name] = self.miss.get(name, 0) + 1
+        return r
+
+    def report(self):
+        tot = self.hit + sum(self.miss.values())
+        top = sorted(self.miss.items(), key=lambda x: -x[1])[:15]
+        return {"resolved": self.hit, "total": tot, "rate": round(self.hit / tot, 3) if tot else None,
+                "missing_top": top}
+
+
+def read_text(path, encs=("utf-8-sig", "cp932", "gbk", "utf-16")):
+    with open(path, "rb") as fh:
+        raw = fh.read()
+    if raw[:2] in (b"\xff\xfe", b"\xfe\xff"):
+        return raw.decode("utf-16")
+    for e in encs:
+        try:
+            return raw.decode(e)
+        except UnicodeDecodeError:
+            continue
+    return raw.decode("cp932", "replace")
+
+
+H_RE = re.compile(r"[ＨH](?:シーン|[0-9０-９]+回目|$)|エッチ|ｴｯﾁ")
+
+
+def is_h_title(t):
+    return bool(H_RE.search(t or ""))

package/galbook/importers/galscript.py

@@ -0,0 +1,218 @@
+"""galscript（.gal）：一种人手能写、程序好生成的剧本格式 → galbook/1。
+
+用途：①自己写互动故事给 agent 玩；②给没有现成导入器的引擎写转换脚本时，先转成 .gal 再导入（最省事）。
+
+  # 注释                         title: 书名   （第一个场景前的 key: value 是书的信息）
+  === 场景id 标题                 新场景（一个文件可多个；不写就是一个场景 main）
+  @route 路线名   @tag h          给当前场景标路线 / 标签（h = H 场景，默认折叠）
+  * 标签                          跳转目标
+  灯：「台词」   或   灯: 台词     台词（名字 ≤12 字、不含空格和句读；用全角「：」或「: 」）
+  其它行                          旁白
+  @bg 文件  @cg 文件  @show 名字 文件 [位置]  @hide 名字  @clear  @bgm 名字|none  @event 名 参数
+  $ f.trust += 1; s.clear_a = 1   改变量（f. 本周目 / s. 跨周目）
+  ? 提示语                        选项开始（可省提示语，直接写 - 行也行）
+  - 选项文字 -> 目标 [if 条件] [do 赋值]
+  -> 目标 [if 条件]               跳转；目标 = 标签 / 场景id / 场景id#标签
+                                  （先找本场景标签，再找同名场景，再找全局唯一标签；找不到 build 校验会报出来）
+  call 目标   return
+  @end ending 结局名   @end title   @end stop
+文件编码 UTF-8（也认 cp932/GBK）。多个 .gal 文件按文件名排序依次读入，第一个文件的第一个场景是入口。"""
+import os
+import re
+
+from .common import SceneB, Assets, read_text
+
+NAME = "galscript"
+SAY = re.compile(r"^([^\s：:「『。，、！？!?,…—]{1,12})(?:：|:\s)\s*(.+)$")
+SAY_Q = re.compile(r"^([^\s：:「『（(。，、！？!?,…—]{1,12})([「『].*)$")
+OPT = re.compile(r"^-\s*(.+?)\s*->\s*(\S+)(?:\s+if\s+(.+?))?(?:\s+do\s+(.+))?\s*$")
+JMP = re.compile(r"^->\s*(\S+)(?:\s+if\s+(.+))?\s*$")
+
+
+def detect(src):
+    for dp, _, fn in os.walk(src):
+        if any(f.lower().endswith(".gal") for f in fn):
+            return True, "有 galscript 剧本（.gal）"
+    return False, ""
+
+
+def _target(t, here):
+    if "#" in t:
+        sc, _, lb = t.partition("#")
+        return {"scene": sc or None, "label": lb or None}
+    return {"scene": None, "label": t}
+
+
+def build(src, assets=None, **_):
+    assets = assets or Assets()
+    files = []
+    for dp, _, fn in os.walk(src):
+        files += [os.path.join(dp, f) for f in fn if f.lower().endswith(".gal")]
+    files.sort()
+    if not files:
+        raise ValueError("%s 里没有 .gal 文件" % src)
+    scenes, order, meta_kv, warnings = {}, [], {}, []
+    stats = {"files": len(files), "says": 0, "choices": 0, "options": 0, "jumps": 0, "calls": 0, "sets": 0}
+    sysv = set()
+    cur, pend = None, None   # pend = 正在攒的 choice op
+
+    def new_scene(sid, title):
+        nonlocal cur
+        if sid in scenes:
+            raise ValueError("场景 id 重复：%s" % sid)
+        cur = SceneB(sid, title or sid)
+        scenes[sid] = cur
+        order.append(sid)
+
+    def fix_targets(op, here):
+        g = op.get("goto") if op.get("op") == "choice" else None
+        return g
+
+    for path in files:
+        rel = os.path.relpath(path, src)
+        for no, raw in enumerate(read_text(path).splitlines(), 1):
+            line = raw.strip()
+            where = "%s:%d" % (rel, no)
+            if not line or line.startswith("#"):
+                continue
+            if pend is not None and not (line.startswith("- ") or line == "-" or line.startswith("-\t")):
+                pend = None
+            if cur is None and not line.startswith("===") and re.match(r"^[A-Za-z_]+:\s", line) and not scenes:
+                k, _, v = line.partition(":")
+                meta_kv[k.strip()] = v.strip()
+                continue
+            if line.startswith("==="):
+                bits = line[3:].strip().split(None, 1)
+                if not bits:
+                    warnings.append("%s: === 后面要写场景 id" % where)
+                    continue
+                new_scene(bits[0], bits[1] if len(bits) > 1 else bits[0])
+                continue
+            if cur is None:
+                new_scene("main", meta_kv.get("title", "main"))
+            for m in re.findall(r"\b(s\.[A-Za-z_]\w*)", line):
+                sysv.add(m[2:])
+            if line.startswith("* "):
+                cur.add("label", name=line[2:].strip())
+            elif line.startswith("@"):
+                w = line[1:].split()
+                c, a = w[0].lower(), w[1:]
+                if c == "route":
+                    cur.route = " ".join(a)
+                elif c == "tag":
+                    cur.tags += a
+                elif c in ("bg", "cg"):
+                    img = None if not a or a[0].lower() == "none" else (assets.find(a[0]) or a[0])
+                    cur.add(c, img=img)
+                elif c == "show" and len(a) >= 2:
+                    cur.add("sprite", name=a[0], img=assets.find(a[1]) or a[1], pos=a[2] if len(a) > 2 else "center")
+                elif c == "hide" and a:
+                    cur.add("sprite", name=a[0], img=None)
+                elif c == "clear":
+                    cur.add("sprites_clear")
+                elif c == "bgm":
+                    cur.add("bgm", name=None if not a or a[0].lower() == "none" else a[0])
+                elif c == "event" and a:
+                    cur.add("event", name=a[0], arg=" ".join(a[1:]) or None)
+                elif c == "end":
+                    kind = a[0] if a and a[0] in ("ending", "title", "stop") else "ending"
+                    cur.add("end", kind=kind, name=" ".join(a[1:]) or None)
+                else:
+                    warnings.append("%s: 不认识的指令 @%s" % (where, c))
+            elif line.startswith("$"):
+                cur.add("set", expr=line[1:].strip())
+                stats["sets"] += 1
+            elif line.startswith("?") or line.startswith("- ") or line == "-":
+                if pend is None:
+                    pend = cur.add("choice", id="c%d" % len(cur.ops), prompt=line[1:].strip() if line.startswith("?") else "",
+                                   options=[])
+                    stats["choices"] += 1
+                if line.startswith("-"):
+                    m = OPT.match(line)
+                    if not m:
+                        warnings.append("%s: 选项要写成「- 文字 -> 目标」" % where)
+                        continue
+                    o = {"text": m.group(1), "goto": _target(m.group(2), cur.id)}
+                    if m.group(3):
+                        o["if"] = m.group(3)
+                    if m.group(4):
+                        o["set"] = m.group(4)
+                    pend["options"].append(o)
+                    stats["options"] += 1
+            elif line.startswith("->"):
+                m = JMP.match(line)
+                if not m:
+                    warnings.append("%s: 跳转要写成「-> 目标」" % where)
+                    continue
+                g = _target(m.group(1), cur.id)
+                cur.add("jump", scene=g["scene"], label=g["label"], **({"if": m.group(2)} if m.group(2) else {}))
+                stats["jumps"] += 1
+            elif line.startswith("if ") and "->" in line:
+                cond, _, tg = line[3:].rpartition("->")
+                g = _target(tg.strip(), cur.id)
+                cur.add("jump", scene=g["scene"], label=g["label"], **{"if": cond.strip()})
+                stats["jumps"] += 1
+            elif line.startswith("call "):
+                g = _target(line[5:].strip(), cur.id)
+                cur.add("call", scene=g["scene"], label=g["label"])
+                stats["calls"] += 1
+            elif line == "return":
+                cur.add("ret")
+            else:
+                m = SAY.match(line) or SAY_Q.match(line)
+                if m:
+                    cur.add("say", who=m.group(1), text=m.group(2).strip())
+                else:
+                    cur.add("say", who="", text=line)
+                stats["says"] += 1
+    # 场景之间默认按顺序接上（没写结尾的场景走到下一个）
+    for a, b in zip(order, order[1:]):
+        ops = scenes[a].ops
+        if not ops or ops[-1]["op"] not in ("jump", "end", "ret"):
+            scenes[a].add("jump", scene=b, label=None)
+    last = scenes[order[-1]].ops
+    if not last or last[-1]["op"] not in ("jump", "end", "ret"):
+        scenes[order[-1]].add("end", kind="title", how="走到最后")
+    # 目标解析：先找本场景的标签，再找同名场景，再找全局唯一的标签；都没有就原样留给校验报错
+    labels = {sid: {op["name"] for op in b.ops if op["op"] == "label"} for sid, b in scenes.items()}
+
+    def resolve(g, sid):
+        if g.get("scene") is None and g.get("label") is not None and g["label"] not in labels[sid]:
+            lb = g["label"]
+            if lb in scenes:
+                g["scene"], g["label"] = lb, None
+            else:
+                owners = [s2 for s2, ls in labels.items() if lb in ls]
+                if len(owners) == 1:
+                    g["scene"] = owners[0]
+    for sid, b in scenes.items():
+        for op in b.ops:
+            if op["op"] == "choice":
+                for o in op["options"]:
+                    resolve(o["goto"], sid)
+                    o["goto"]["scene"] = o["goto"]["scene"] or sid
+                    if o["goto"].get("label") is None:
+                        o["goto"].pop("label")
+            elif op["op"] in ("jump", "call") and "scene" not in op:
+                g = {"scene": None, "label": op.get("label")}
+                resolve(g, sid)
+                if g["scene"]:
+                    op["scene"] = g["scene"]
+                    if g["label"] is None:
+                        op.pop("label", None)
+    routes, seen_r = [], set()
+    for sid in order:
+        r = scenes[sid].route
+        if r and r not in seen_r:
+            seen_r.add(r)
+            routes.append({"id": r, "title": r, "start": {"scene": sid, "label": None}})
+    data = {k: v.data() for k, v in scenes.items()}
+    meta = {"format": "galbook/1", "title": meta_kv.get("title", ""), "engine": "galscript", "importer": "galbook-galscript-1",
+            "entry": {"scene": order[0], "label": None},
+            "scenes": {k: {"title": v["title"], "tags": v["tags"], "route": v["route"]} for k, v in data.items()},
+            "routes": routes, "system_vars": sorted(sysv),
+            "stats": dict(stats, unknown=[], assets=assets.report()), "warnings": warnings[:200]}
+    for k in ("author", "license", "lang"):
+        if k in meta_kv:
+            meta[k] = meta_kv[k]
+    return meta, data

package/galbook/importers/kag.py

@@ -0,0 +1,326 @@
+"""吉里吉里 KAG / TyranoScript（.ks）→ galbook/1。老游戏（KAG2/KAG3/KAGEX）和新的网页游戏（Tyrano）共用。
+
+认的写法：
+  *label|标题                        标签
+  ; 注释    @tag a=b 整行指令    [tag a=b] 行内指令
+  台词     【名字】「…」 / #名字（Tyrano，到下一个 # 为止） / [nm t="名字"] / @nm t=名字（KAGEX）
+           [l] [p] [r] [cm] 断句；没写等待的行按一行一句
+  选项     [link target=*x storage=y.ks exp="f.a=1"]文字[endlink] … [s]
+           [glink text="文字" target=*x storage=… exp=…] … [s]（Tyrano）   [button graphic=… target=…]
+  跳转     [jump storage= target= cond=]  [call …]  [return]  [s]（无选项时 = 停住）
+  变量     [eval exp="f.x=1"]  sf.* = 系统变量（跨周目）→ s.*  tf.* → f.tf_*
+           [if exp=…] [elsif exp=…] [else] [endif]   [ignore exp=…] [endignore]
+  画面     [bg storage=]  @image storage= layer=base|0..n  [chara_show name= face=]  [chara_hide]
+           [chara_mod]  [freeimage layer=]  [playbgm storage=] / @bgm  [cm] / [ct]
+"""
+import os
+import re
+
+from .common import SceneB, Assets, read_text, is_h_title
+
+ATTR = re.compile(r'([A-Za-z_][\w\-]*)\s*=\s*("(?:[^"\\]|\\.)*"|\'(?:[^\'\\]|\\.)*\'|[^\s\]]+)|([A-Za-z_][\w\-]*)')
+TOK = re.compile(r"\[(?!\[)([^\]]*)\]|([^\[]+)|\[\[")
+
+
+def parse_attrs(s):
+    d = {}
+    for m in ATTR.finditer(s):
+        if m.group(1):
+            v = m.group(2)
+            if v[:1] in "\"'" and v[-1:] == v[:1]:
+                v = v[1:-1]
+            d[m.group(1).lower()] = v
+        elif m.group(3):
+            d[m.group(3).lower()] = True
+    return d
+
+
+def conv_expr(e):
+    if e is None:
+        return None
+    e = str(e)
+    e = re.sub(r"\bsf\.", "s.", e)
+    e = re.sub(r"\btf\.", "f.tf_", e)
+    e = re.sub(r"\bmp\.", "f.mp_", e)
+    e = e.replace("===", "==").replace("!==", "!=")
+    return e
+
+
+def _target(at, cur):
+    st = at.get("storage")
+    sid = os.path.splitext(os.path.basename(st))[0] if st and st is not True else None
+    tg = at.get("target")
+    lb = tg[1:] if isinstance(tg, str) and tg.startswith("*") else (tg if isinstance(tg, str) else None)
+    return sid, lb
+
+
+class _Ctx(object):
+    def __init__(self, sid):
+        self.b = SceneB(sid, sid, tags=["h"] if is_h_title(sid) else [])
+        self.buf = []
+        self.who = ""
+        self.hash_who = None
+        self.links = []
+        self.link_open = None
+        self.ifs = []
+        self.nif = 0
+        self.sprites = {}
+
+
+class Importer(object):
+    def __init__(self, src, assets=None, entry=None):
+        self.src, self.assets, self.entry = src, assets or Assets(), entry
+        self.files = {}
+        self.scenes = {}
+        self.warnings = []
+        self.unknown = {}
+        self.stats = {"files": 0, "says": 0, "choices": 0, "options": 0, "jumps": 0, "calls": 0, "sets": 0, "ifs": 0}
+        self.system_vars = set()
+
+    def build(self):
+        for dp, _, fns in os.walk(self.src):
+            for fn in sorted(fns):
+                if fn.lower().endswith(".ks"):
+                    self.files[os.path.splitext(fn)[0]] = os.path.join(dp, fn)
+        if not self.files:
+            raise ValueError("没找到 .ks")
+        for sid in sorted(self.files):
+            self._parse(sid)
+        ent = self.entry or next((x for x in ("first", "start", "main", "scenario") if x in self.files), sorted(self.files)[0])
+        start = SceneB("__start__", "开始", tags=["system"])
+        start.add("label", name="top")
+        start.add("jump", scene=ent)
+        self.scenes["__start__"] = start.data()
+        meta = {"format": "galbook/1", "title": "", "engine": "kag", "importer": "galbook-kag-1",
+                "entry": {"scene": "__start__", "label": "top"},
+                "scenes": {k: {"title": v["title"], "tags": v["tags"]} for k, v in self.scenes.items()},
+                "routes": [], "system_vars": sorted(self.system_vars),
+                "stats": dict(self.stats, unknown=sorted(self.unknown.items(), key=lambda x: -x[1])[:20],
+                              assets=self.assets.report()),
+                "warnings": self.warnings[:200]}
+        return meta, self.scenes
+
+    # ---- 文本缓冲 ----
+    def _flush(self, cx):
+        t = "".join(cx.buf).strip()
+        cx.buf = []
+        if not t:
+            return
+        who = cx.who or cx.hash_who or ""
+        m = re.match(r"^【([^】]{1,16})】\s*(.*)$", t)
+        if m:
+            who, t = m.group(1), m.group(2)
+        cx.b.add("say", who=who, text=t)
+        cx.who = ""
+        self.stats["says"] += 1
+
+    def _parse(self, sid):
+        cx = _Ctx(sid)
+        self.stats["files"] += 1
+        text = read_text(self.files[sid])
+        in_script = False
+        for raw in text.splitlines():
+            line = raw.rstrip("\r\n")
+            s = line.strip()
+            if in_script:
+                if s.lower().startswith("[endscript") or s.lower().startswith("@endscript"):
+                    in_script = False
+                continue
+            if not s or s.startswith(";") or s.startswith("//"):
+                continue
+            if s.startswith("*"):
+                self._flush(cx)
+                cx.b.add("label", name=s[1:].split("|")[0].strip())
+                continue
+            if s.startswith("#"):
+                self._flush(cx)
+                nm = s[1:].strip().split(":")[0]
+                cx.hash_who = nm or None
+                continue
+            if s.startswith("@"):
+                if s[1:].lower().startswith("iscript"):
+                    in_script = True
+                    continue
+                name, _, rest = s[1:].partition(" ")
+                self._tag(cx, name.lower(), parse_attrs(rest))
+                continue
+            if s.lower().startswith("[iscript"):
+                in_script = True
+                continue
+            had_wait = False
+            for m in TOK.finditer(s):
+                if m.group(0) == "[[":
+                    cx.buf.append("[")
+                elif m.group(2) is not None:
+                    if cx.link_open is not None:
+                        cx.link_open["text"] += m.group(2)
+                    else:
+                        cx.buf.append(m.group(2))
+                else:
+                    inner = m.group(1).strip()
+                    name, _, rest = inner.partition(" ")
+                    name = name.lower()
+                    if name in ("l", "p", "cm", "er", "ct"):
+                        had_wait = True
+                    self._tag(cx, name, parse_attrs(rest))
+            if not had_wait and cx.buf and cx.link_open is None:
+                self._flush(cx)        # 没写 [l]/[p] 的行：一行一句
+        self._flush(cx)
+        for lb in cx.ifs:
+            cx.b.add("label", name=lb["end"])
+        if cx.links:
+            self._emit_choice(cx)
+        self.scenes[sid] = cx.b.data()
+
+    def _emit_choice(self, cx):
+        opts = []
+        for l in cx.links:
+            o = {"text": l["text"].strip() or "(选项)", "goto": {"scene": l["sid"], "label": l["lb"]}}
+            if l.get("exp"):
+                o["set"] = conv_expr(l["exp"])
+            if l.get("cond"):
+                o["if"] = l["cond"]
+            opts.append(o)
+        cx.b.add("choice", id="c%d" % len(cx.b.ops), options=opts)
+        self.stats["choices"] += 1
+        self.stats["options"] += len(opts)
+        cx.links = []
+
+    @staticmethod
+    def _link_cond(cx, at):
+        """选项是攒到 [s] 才一起出的，所以要把外层 [if] 的条件记到每个选项上。"""
+        cs = [c for lb in cx.ifs for c in [lb.get("cur")] if c]
+        own = conv_expr(at.get("cond")) if isinstance(at.get("cond"), str) else None
+        if own:
+            cs.append(own)
+        return " && ".join("(%s)" % c for c in cs) if cs else None
+
+    def _tag(self, cx, name, at):
+        cond = conv_expr(at.get("cond")) if isinstance(at.get("cond"), str) else None
+        if name in ("l", "p"):
+            self._flush(cx)
+        elif name in ("r", "br"):
+            cx.buf.append("\n") if cx.link_open is None else None
+        elif name in ("cm", "er", "ct"):
+            self._flush(cx)
+        elif name in ("nm", "name", "ns"):
+            t = at.get("t") or at.get("text") or at.get("name")
+            if isinstance(t, str):
+                cx.who = t
+        elif name == "link":
+            sid, lb = _target(at, cx.b.id)
+            cx.link_open = {"text": "", "sid": sid, "lb": lb, "exp": at.get("exp"), "cond": self._link_cond(cx, at)}
+        elif name == "endlink":
+            if cx.link_open is not None:
+                cx.links.append(cx.link_open)
+                cx.link_open = None
+        elif name in ("glink", "button"):
+            sid, lb = _target(at, cx.b.id)
+            txt = at.get("text") or at.get("graphic") or "(按钮)"
+            if lb or sid:
+                cx.links.append({"text": str(txt), "sid": sid, "lb": lb, "exp": at.get("exp"), "cond": self._link_cond(cx, at)})
+        elif name == "s":
+            self._flush(cx)
+            if cx.links:
+                self._emit_choice(cx)
+            else:
+                cx.b.add("end", kind="stop", name="[s] 停住（等待外部操作）")
+        elif name in ("jump", "call"):
+            self._flush(cx)
+            sid, lb = _target(at, cx.b.id)
+            op = cx.b.add(name, scene=sid if sid != cx.b.id else None, label=lb)
+            if cond:
+                op["if"] = cond
+            self.stats["calls" if name == "call" else "jumps"] += 1
+        elif name == "return":
+            self._flush(cx)
+            cx.b.add("ret")
+        elif name == "eval":
+            e = conv_expr(at.get("exp"))
+            if e:
+                op = cx.b.add("set", expr=e)
+                if cond:
+                    op["if"] = cond
+                self.stats["sets"] += 1
+                for m in re.finditer(r"\bs\.(\w+)\s*(?:=|\+=|-=)(?!=)", e):
+                    self.system_vars.add(m.group(1))
+        elif name in ("if", "ignore"):
+            self._flush(cx)
+            cx.nif += 1
+            lb = {"next": "__if%d_n1" % cx.nif, "end": "__if%d_end" % cx.nif, "k": 1, "n": cx.nif}
+            cx.ifs.append(lb)
+            e = conv_expr(at.get("exp")) or "false"
+            neg = e if name == "ignore" else "!(%s)" % e
+            lb["cur"] = ("!(%s)" % e) if name == "ignore" else e
+            lb["prev"] = [lb["cur"]]
+            cx.b.add("jump", label=lb["next"], **{"if": neg})
+            self.stats["ifs"] += 1
+        elif name in ("elsif", "else"):
+            self._flush(cx)
+            if not cx.ifs:
+                return
+            lb = cx.ifs[-1]
+            cx.b.add("jump", label=lb["end"])
+            cx.b.add("label", name=lb["next"])
+            lb["k"] += 1
+            lb["next"] = "__if%d_n%d" % (lb["n"], lb["k"])
+            notprev = " && ".join("!(%s)" % c for c in lb.get("prev", []))
+            if name == "elsif":
+                e = conv_expr(at.get("exp")) or "false"
+                cx.b.add("jump", label=lb["next"], **{"if": "!(%s)" % e})
+                lb["cur"] = "(%s) && (%s)" % (notprev, e) if notprev else e
+                lb.setdefault("prev", []).append(e)
+            else:
+                lb["cur"] = notprev or None
+        elif name in ("endif", "endignore"):
+            self._flush(cx)
+            if cx.ifs:
+                lb = cx.ifs.pop()
+                cx.b.add("label", name=lb["next"])
+                cx.b.add("label", name=lb["end"])
+        elif name == "bg" or (name == "image" and str(at.get("layer", "")).lower() in ("base", "background")):
+            self._flush(cx)
+            cx.b.add("bg", img=self.assets.find(at.get("storage")) if at.get("storage") else None)
+        elif name == "image":
+            self._flush(cx)
+            layer = str(at.get("layer", "0"))
+            cx.b.add("sprite", name="layer" + layer, img=self.assets.find(at.get("storage")), pos=at.get("pos") or "center")
+        elif name in ("freeimage", "freelayer"):
+            self._flush(cx)
+            layer = str(at.get("layer", "0"))
+            if layer in ("base", "background"):
+                cx.b.add("bg", img=None)
+            else:
+                cx.b.add("sprite", name="layer" + layer, img=None)
+        elif name in ("chara_show", "chara_mod"):
+            self._flush(cx)
+            nm = at.get("name", "?")
+            face = at.get("face") or at.get("storage") or ""
+            img = self.assets.find(at.get("storage")) if at.get("storage") else self.assets.find("%s_%s" % (nm, face) if face else str(nm))
+            cx.b.add("sprite", name=str(nm), img=img or ("chara:%s%s" % (nm, (":" + face) if face else "")), pos=at.get("pos") or "center")
+        elif name == "chara_hide":
+            cx.b.add("sprite", name=str(at.get("name", "?")), img=None)
+        elif name in ("chara_hide_all", "freeimage_all"):
+            cx.b.add("sprites_clear")
+        elif name in ("playbgm", "bgm", "fadeinbgm"):
+            cx.b.add("bgm", name=at.get("storage") if isinstance(at.get("storage"), str) else None)
+        elif name in ("stopbgm", "fadeoutbgm"):
+            cx.b.add("bgm", name=None)
+        elif name in ("gotostart", "close", "end"):
+            self._flush(cx)
+            cx.b.add("end", kind="title", how="[%s]" % name)
+        elif name in ("macro", "endmacro", "wait", "wt", "trans", "wq", "quake", "move", "wm", "playse", "se", "ws",
+                      "position", "font", "resetfont", "delay", "nowait", "endnowait", "locate", "current", "layopt",
+                      "backlay", "style", "deffont", "defstyle", "history", "clearsysvar", "clearvar", "seopt",
+                      "anim", "kanim", "wa", "vo", "voice", "playvoice", "mask", "mask_off", "chara_new", "chara_face",
+                      "chara_config", "showmenubutton", "hidemenubutton", "title", "loadjs", "plugin", "skipstop",
+                      "autostop", "cancelskip", "fadeoutse", "stopse", "filter", "free_filter", "layermode", "camera",
+                      "reset_camera", "ptext", "free", "wait_cancel", "hidemessage", "showlog", "clickable", "dialog",
+                      "image_tag", "emb", "ruby", "graph", "ch", "hch", "add", "rclick", "button_cancel", "cancel"):
+            pass
+        else:
+            self.unknown[name] = self.unknown.get(name, 0) + 1
+
+
+def build(src, assets=None, entry=None, **_):
+    return Importer(src, assets, entry).build()