msime-windows/engine/contracts/webview/generate.py

#!/usr/bin/env python3
"""Generate checked-in language bindings. --check rejects stale artifacts in CI."""
import argparse
import json
from pathlib import Path

ROOT = Path(__file__).resolve().parent


def ts_type(rule):
    if "anyOf" in rule:
        return " | ".join(ts_type(branch) for branch in rule["anyOf"])
    if "enum" in rule:
        return " | ".join(json.dumps(value) for value in rule["enum"])
    if rule.get("type") == "array":
        return "Array<" + ts_type(rule["items"]) + ">"
    if rule.get("type") == "object":
        fields = [f'{json.dumps(key)}{"" if key in rule.get("required", []) else "?"}: {ts_type(value)}'
                  for key, value in rule.get("properties", {}).items()]
        if rule.get("additionalProperties"):
            fields.append("[key: string]: unknown")
        return "{ " + "; ".join(fields) + " }"
    return {"integer": "number", "number": "number", "string": "string", "boolean": "boolean", "null": "null"}.get(rule.get("type"), "unknown")


def union(messages):
    entries = []
    for name, spec in messages.items():
        properties = {"type": {"enum": [name]}, "protocolVersion": {"enum": [1]}, **spec.get("properties", {})}
        required = ["type", *spec.get("required", [])]
        if "data" in spec:
            properties["data"] = spec["data"]
            required.append("data")
        entries.append(ts_type({"type": "object", "properties": properties, "required": required,
                                "additionalProperties": spec.get("additionalProperties", False)}))
    return "\n  | ".join(entries)


def generate():
    schema = json.loads((ROOT / "messages.json").read_text())
    compact = json.dumps(schema, ensure_ascii=False, separators=(",", ":"))
    files = {
        "schema.js": "// Generated by generate.py; edit messages.json.\n(function(root) {\n  const schema = " + compact + ";\n  root.MsimeMessageSchema = schema;\n  if (typeof module !== 'undefined' && module.exports) module.exports = schema;\n})(globalThis);\n",
        "schema.h": '#pragma once\n// Generated by generate.py; edit messages.json.\nnamespace metasequoia::webview {\ninline constexpr int Version = ' + str(schema["version"]) + ';\ninline constexpr char SchemaJson[] = R"msime(' + compact + ')msime";\n}\n',
        "runtime.d.ts": "export {};\n",
    }
    types = "// Generated by generate.py; edit messages.json.\nimport './schema.js';\nimport './runtime.js';\n"
    for name, messages in [("ClientMessage", schema["client"]), ("ServerMessage", schema["server"]),
                           ("SettingsMessage", {k: v for k, v in schema["client"].items() if "settings" in v["surfaces"]})]:
        types += f"export type {name} =\n  | {union(messages)};\n"
    types += '''declare global {
  var MsimeProtocol: {
    validate(message: unknown, direction: 'client' | 'server', surface?: string): boolean;
    serializeClientMessage(message: ClientMessage, surface: string): string;
    version: number;
  };
}
export function serializeHostMessage(message: SettingsMessage): string {
  return globalThis.MsimeProtocol.serializeClientMessage(message, 'settings');
}
export function isServerMessage(message: unknown): message is ServerMessage {
  return globalThis.MsimeProtocol.validate(message, 'server');
}
'''
    files["messages.ts"] = types
    files["schema.d.ts"] = "export {};\n"
    return files


def main():
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--check", action="store_true")
    args = parser.parse_args()
    for name, content in generate().items():
        path = ROOT / name
        payload = content.encode("utf-8")
        if args.check:
            # Byte comparison, not read_text(): text mode folds CRLF to LF and
            # would hide a line-ending drift in an otherwise identical file.
            if not path.exists() or path.read_bytes() != payload:
                raise SystemExit(f"Stale binding: {path}; run generate.py")
        else:
            # newline="\n" keeps the checked-in bytes platform-independent; text
            # mode's default translation writes CRLF on Windows.
            path.write_text(content, encoding="utf-8", newline="\n")


if __name__ == "__main__":
    main()