@lukawi/toporealm 0.1.0

package/dist/web/index.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync } from "node:fs";
+import { extname, join, normalize, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import { coreSurface } from "../core/index.js";
+import { CoreError } from "../core/index.js";
+export const webSurface = {
+    name: "web",
+    coreFormat: coreSurface.graphFormat,
+};
+/** Client-side projection that consumes the same revisioned patches returned by Core. */
+export class WebGraphModel {
+    current;
+    constructor(snapshot) {
+        this.current = structuredClone(snapshot);
+    }
+    get snapshot() {
+        return structuredClone(this.current);
+    }
+    applyPatch(patch) {
+        if (patch.fromRevision !== this.current.revision) {
+            throw new CoreError({
+                code: "PATCH_GAP",
+                message: `Web 视图需要 revision ${this.current.revision}，收到 ${patch.fromRevision}。`,
+                details: { expectedRevision: this.current.revision, patchFrom: patch.fromRevision },
+            });
+        }
+        const objects = new Map(this.current.objects.map((object) => [object.id, structuredClone(object)]));
+        const relations = new Map(this.current.relations.map((relation) => [relation.id, structuredClone(relation)]));
+        for (const object of patch.objects.added)
+            objects.set(object.id, structuredClone(object));
+        for (const object of patch.objects.updated)
+            objects.set(object.id, structuredClone(object));
+        for (const id of patch.objects.deleted)
+            objects.delete(id);
+        for (const relation of patch.relations.added)
+            relations.set(relation.id, structuredClone(relation));
+        for (const relation of patch.relations.updated)
+            relations.set(relation.id, structuredClone(relation));
+        for (const id of patch.relations.deleted)
+            relations.delete(id);
+        this.current = {
+            manifest: patch.manifestChanged && patch.manifest ? structuredClone(patch.manifest) : this.current.manifest,
+            objects: [...objects.values()].sort(byId),
+            relations: [...relations.values()].sort(byId),
+            revision: patch.toRevision,
+        };
+        return this.snapshot;
+    }
+}
+/** One extension failing must leave the generic surface usable. */
+export function withUiErrorBoundary(extension, fallback) {
+    try {
+        return { enabled: true, value: extension() };
+    }
+    catch (error) {
+        return { enabled: false, value: fallback(), error: error instanceof Error ? error.message : String(error) };
+    }
+}
+const PACKAGED_WEB_DIST = fileURLToPath(new URL("../web-assets/", import.meta.url));
+const DEVELOPMENT_WEB_DIST = join(process.cwd(), "web-ui", "dist");
+function defaultWebRoot() {
+    return existsSync(join(PACKAGED_WEB_DIST, "index.html")) ? PACKAGED_WEB_DIST : DEVELOPMENT_WEB_DIST;
+}
+const MIME_TYPES = {
+    ".css": "text/css; charset=utf-8",
+    ".html": "text/html; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+};
+/** Reads a built Web UI asset without allowing paths outside web-ui/dist. */
+export function readWebAsset(pathname, webRoot = defaultWebRoot()) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(pathname);
+    }
+    catch {
+        return undefined;
+    }
+    const assetPath = normalize(join(webRoot, decoded.replace(/^[/\\]+/, "")));
+    const rel = relative(webRoot, assetPath);
+    if (!rel || rel.startsWith("..") || rel.includes(`..${"/"}`) || rel.includes(`..${"\\"}`) || !existsSync(assetPath))
+        return undefined;
+    return { body: readFileSync(assetPath), contentType: MIME_TYPES[extname(assetPath).toLowerCase()] ?? "application/octet-stream" };
+}
+function byId(left, right) {
+    return left.id.localeCompare(right.id);
+}
+export function renderWebShell(webRoot = defaultWebRoot()) {
+    const builtIndex = join(webRoot, "index.html");
+    if (existsSync(builtIndex))
+        return readFileSync(builtIndex, "utf8");
+    return `<!doctype html>
+<html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>TopoRealm</title><style>body{font:15px system-ui,sans-serif;max-width:960px;margin:2rem auto;padding:0 1rem}button{margin:.25rem;padding:.45rem .7rem}pre{background:#f5f5f5;padding:1rem;overflow:auto}</style></head>
+<body><h1>TopoRealm</h1><p>最薄基座 Web 视图：读取图快照，并把编辑结果作为 revision patch 应用。</p>
+<p><button id="refresh">刷新</button><button id="undo">撤销</button><button id="redo">重做</button></p><pre id="state">加载中…</pre>
+<script>
+const state=document.querySelector('#state');
+async function get(){const r=await fetch('/graph'); const v=await r.json(); state.textContent=JSON.stringify(v,null,2);}
+async function action(path){const r=await fetch(path,{method:'POST',headers:{'content-type':'application/json'},body:'{}'}); const v=await r.json(); state.textContent=JSON.stringify(v,null,2);}
+document.querySelector('#refresh').onclick=get; document.querySelector('#undo').onclick=()=>action('/undo'); document.querySelector('#redo').onclick=()=>action('/redo'); get();
+</script></body></html>`;
+}
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

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