@forgeax/engine-dsh 0.1.2

package/lib/client.js

@@ -0,0 +1,295 @@
+window.__ModuleLoader__.load({ id: "@forgeax/engine-dsh", factory: (require) => {
+var module = { exports: {} }; var exports = module.exports;
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.tsx
+var client_exports = {};
+__export(client_exports, {
+  apply: () => apply,
+  inject: () => inject
+});
+module.exports = __toCommonJS(client_exports);
+var import_react = require("react");
+
+// src/protocol.ts
+var FEDERATION_PROTOCOL_VERSION = 1;
+var FEDERATION_ROUTE_PREFIX = "/forgeax-federation/v1";
+function isEnginePreviewStatus(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return record.protocol === FEDERATION_PROTOCOL_VERSION && record.kind === "forgeax-engine-status" && record.binding === "external" && record.ready === true && typeof record.frameId === "number" && typeof record.tick === "number" && typeof record.state === "number";
+}
+function isFederationStatus(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return record.protocol === FEDERATION_PROTOCOL_VERSION && record.realm === "dsh" && record.ready === true && typeof record.identity === "string" && Array.isArray(record.capabilities) && record.capabilities.every((capability) => typeof capability === "string") && Number.isInteger(record.leases) && record.leases >= 0 && isEngineProjection(record.engine);
+}
+function isEngineProjection(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  if (record.ready !== true) return false;
+  if (record.binding === "external") return typeof record.endpoint === "string";
+  return record.binding === "embedded" && typeof record.frameId === "number" && typeof record.tick === "number" && typeof record.state === "number";
+}
+
+// src/client.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+var inject = ["slots"];
+function apply(ctx) {
+  ctx.slots.inject(
+    "shell.overlay",
+    () => ctx.slots.register(
+      {
+        name: "shell.overlay",
+        id: "forgeax-engine",
+        order: 80,
+        label: "ForgeaX Engine"
+      },
+      ForgeaXPanel
+    )
+  );
+}
+function ForgeaXPanel() {
+  const [open, setOpen] = (0, import_react.useState)(true);
+  const [realm, setRealm] = (0, import_react.useState)();
+  const [engine, setEngine] = (0, import_react.useState)();
+  const iframe = (0, import_react.useRef)(null);
+  const readRealm = (0, import_react.useCallback)(async () => {
+    const response = await fetch(`${FEDERATION_ROUTE_PREFIX}/status`, { cache: "no-store" });
+    if (!response.ok) return;
+    const value = await response.json();
+    if (isFederationStatus(value)) setRealm(value);
+  }, []);
+  const engineEndpoint = realm?.engine.binding === "external" ? realm.engine.endpoint : void 0;
+  (0, import_react.useEffect)(() => {
+    if (!open) return;
+    void readRealm();
+    const realmTimer = window.setInterval(() => void readRealm(), 1e3);
+    return () => window.clearInterval(realmTimer);
+  }, [open, readRealm]);
+  (0, import_react.useEffect)(() => {
+    if (!open || engineEndpoint === void 0) return;
+    const pollTimer = window.setInterval(() => {
+      const target = iframe.current?.contentWindow;
+      if (target == null) return;
+      target.postMessage(
+        { protocol: FEDERATION_PROTOCOL_VERSION, kind: "forgeax-engine-poll" },
+        new URL(engineEndpoint).origin
+      );
+    }, 250);
+    const onMessage = (event) => {
+      if (event.source !== iframe.current?.contentWindow || !isEnginePreviewStatus(event.data))
+        return;
+      setEngine(event.data);
+    };
+    window.addEventListener("message", onMessage);
+    return () => {
+      window.clearInterval(pollTimer);
+      window.removeEventListener("message", onMessage);
+    };
+  }, [engineEndpoint, open]);
+  const control = () => {
+    if (realm?.engine.binding === "external") {
+      iframe.current?.contentWindow?.postMessage(
+        {
+          protocol: FEDERATION_PROTOCOL_VERSION,
+          kind: "forgeax-engine-control",
+          action: "toggle"
+        },
+        new URL(realm.engine.endpoint).origin
+      );
+      return;
+    }
+    void fetch(`${FEDERATION_ROUTE_PREFIX}/engine/control`, { method: "POST" }).then(
+      () => readRealm()
+    );
+  };
+  const projection = realm?.engine.binding === "external" ? engine : realm?.engine.binding === "embedded" ? realm.engine : void 0;
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+    "section",
+    {
+      "data-forgeax-panel": "mounted",
+      style: {
+        position: "fixed",
+        right: 18,
+        bottom: 18,
+        zIndex: 100,
+        width: open ? 680 : 210,
+        border: "1px solid rgba(94, 234, 212, 0.42)",
+        borderRadius: 16,
+        overflow: "hidden",
+        color: "#e6fffb",
+        background: "rgba(5, 14, 25, 0.96)",
+        boxShadow: "0 24px 70px rgba(0, 0, 0, 0.55)",
+        pointerEvents: "auto",
+        fontFamily: "ui-sans-serif, system-ui, sans-serif"
+      },
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+          "header",
+          {
+            style: {
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "space-between",
+              padding: "11px 14px",
+              background: "linear-gradient(90deg, rgba(13,148,136,.28), rgba(37,99,235,.18))"
+            },
+            children: [
+              /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { style: { fontSize: 14 }, children: "ForgeaX Engine" }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                  "span",
+                  {
+                    "data-forgeax-ready": realm?.ready === true ? "true" : "false",
+                    style: {
+                      marginLeft: 9,
+                      color: realm?.ready === true ? "#5eead4" : "#fbbf24",
+                      fontSize: 12
+                    },
+                    children: realm?.ready === true ? "\u25CF bridge ready" : "\u25CB connecting"
+                  }
+                )
+              ] }),
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "button", onClick: () => setOpen((value) => !value), style: buttonStyle, children: open ? "Hide preview" : "Show preview" })
+            ]
+          }
+        ),
+        open ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { padding: 12 }, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+            "div",
+            {
+              "data-forgeax-status": "live",
+              style: {
+                display: "grid",
+                gridTemplateColumns: "repeat(4, 1fr)",
+                gap: 8,
+                marginBottom: 10
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Fact, { label: "binding", value: realm?.engine.binding ?? "pending" }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Fact, { label: "frameId", value: String(projection?.frameId ?? 0) }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Fact, { label: "tick", value: String(projection?.tick ?? 0) }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Fact, { label: "state", value: String(projection?.state ?? 0) })
+              ]
+            }
+          ),
+          engineEndpoint !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            "iframe",
+            {
+              ref: iframe,
+              "data-forgeax-engine-frame": "real",
+              src: engineEndpoint,
+              title: "Running ForgeaX Engine",
+              onLoad: () => {
+                iframe.current?.contentWindow?.postMessage(
+                  { protocol: FEDERATION_PROTOCOL_VERSION, kind: "forgeax-engine-poll" },
+                  new URL(engineEndpoint).origin
+                );
+              },
+              style: {
+                display: "block",
+                width: "100%",
+                height: 390,
+                border: "1px solid rgba(148,163,184,.25)",
+                borderRadius: 10,
+                background: "#020617"
+              }
+            }
+          ) : /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+            "div",
+            {
+              "data-forgeax-headless": "true",
+              style: {
+                display: "grid",
+                placeItems: "center",
+                height: 180,
+                borderRadius: 10,
+                color: "#94a3b8",
+                background: "radial-gradient(circle at center, #123047, #020617 70%)"
+              },
+              children: "Embedded headless Engine \xB7 no placeholder pixels"
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
+            "footer",
+            {
+              style: {
+                display: "flex",
+                alignItems: "center",
+                justifyContent: "space-between",
+                marginTop: 10
+              },
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: { color: "#94a3b8", fontSize: 12 }, children: [
+                  "DSH native Loader \xB7 lease ",
+                  realm?.leases ?? 0,
+                  " \xB7 protocol ",
+                  realm?.protocol ?? "\u2013"
+                ] }),
+                /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+                  "button",
+                  {
+                    "data-forgeax-control": "toggle",
+                    type: "button",
+                    onClick: control,
+                    style: buttonStyle,
+                    children: "Toggle Engine state"
+                  }
+                )
+              ]
+            }
+          )
+        ] }) : null
+      ]
+    }
+  );
+}
+function Fact({
+  label,
+  value
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { padding: "7px 9px", borderRadius: 8, background: "rgba(15, 23, 42, .9)" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "div",
+      {
+        style: {
+          color: "#64748b",
+          fontSize: 10,
+          textTransform: "uppercase",
+          letterSpacing: ".08em"
+        },
+        children: label
+      }
+    ),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { style: { color: "#f8fafc", fontSize: 13, fontVariantNumeric: "tabular-nums" }, children: value })
+  ] });
+}
+var buttonStyle = {
+  padding: "6px 10px",
+  border: "1px solid rgba(94,234,212,.35)",
+  borderRadius: 8,
+  color: "#ccfbf1",
+  background: "rgba(15,118,110,.25)",
+  cursor: "pointer",
+  fontSize: 12
+};
+return module.exports; } });
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.tsx","../src/protocol.ts"],"sourcesContent":["import type React from 'react';\nimport { useCallback, useEffect, useRef, useState } from 'react';\n\nimport {\n  type EnginePreviewStatus,\n  FEDERATION_PROTOCOL_VERSION,\n  FEDERATION_ROUTE_PREFIX,\n  type FederationStatus,\n  isEnginePreviewStatus,\n  isFederationStatus,\n} from './protocol';\n\ninterface SlotService {\n  inject(name: string, callback: () => () => void): void;\n  register(options: Readonly<Record<string, unknown>>, component: React.ComponentType): () => void;\n}\n\ninterface ClientContext {\n  readonly slots: SlotService;\n}\n\nexport const inject = ['slots'];\n\nexport function apply(ctx: ClientContext): void {\n  ctx.slots.inject('shell.overlay', () =>\n    ctx.slots.register(\n      {\n        name: 'shell.overlay',\n        id: 'forgeax-engine',\n        order: 80,\n        label: 'ForgeaX Engine',\n      },\n      ForgeaXPanel,\n    ),\n  );\n}\n\nfunction ForgeaXPanel(): React.JSX.Element {\n  const [open, setOpen] = useState(true);\n  const [realm, setRealm] = useState<FederationStatus>();\n  const [engine, setEngine] = useState<EnginePreviewStatus>();\n  const iframe = useRef<HTMLIFrameElement>(null);\n\n  const readRealm = useCallback(async (): Promise<void> => {\n    const response = await fetch(`${FEDERATION_ROUTE_PREFIX}/status`, { cache: 'no-store' });\n    if (!response.ok) return;\n    const value: unknown = await response.json();\n    if (isFederationStatus(value)) setRealm(value);\n  }, []);\n\n  const engineEndpoint = realm?.engine.binding === 'external' ? realm.engine.endpoint : undefined;\n\n  useEffect(() => {\n    if (!open) return;\n    void readRealm();\n    const realmTimer = window.setInterval(() => void readRealm(), 1_000);\n    return () => window.clearInterval(realmTimer);\n  }, [open, readRealm]);\n\n  useEffect(() => {\n    if (!open || engineEndpoint === undefined) return;\n    const pollTimer = window.setInterval(() => {\n      const target = iframe.current?.contentWindow;\n      if (target == null) return;\n      target.postMessage(\n        { protocol: FEDERATION_PROTOCOL_VERSION, kind: 'forgeax-engine-poll' },\n        new URL(engineEndpoint).origin,\n      );\n    }, 250);\n    const onMessage = (event: MessageEvent): void => {\n      if (event.source !== iframe.current?.contentWindow || !isEnginePreviewStatus(event.data))\n        return;\n      setEngine(event.data);\n    };\n    window.addEventListener('message', onMessage);\n    return () => {\n      window.clearInterval(pollTimer);\n      window.removeEventListener('message', onMessage);\n    };\n  }, [engineEndpoint, open]);\n\n  const control = (): void => {\n    if (realm?.engine.binding === 'external') {\n      iframe.current?.contentWindow?.postMessage(\n        {\n          protocol: FEDERATION_PROTOCOL_VERSION,\n          kind: 'forgeax-engine-control',\n          action: 'toggle',\n        },\n        new URL(realm.engine.endpoint).origin,\n      );\n      return;\n    }\n    void fetch(`${FEDERATION_ROUTE_PREFIX}/engine/control`, { method: 'POST' }).then(() =>\n      readRealm(),\n    );\n  };\n\n  const projection =\n    realm?.engine.binding === 'external'\n      ? engine\n      : realm?.engine.binding === 'embedded'\n        ? realm.engine\n        : undefined;\n\n  return (\n    <section\n      data-forgeax-panel=\"mounted\"\n      style={{\n        position: 'fixed',\n        right: 18,\n        bottom: 18,\n        zIndex: 100,\n        width: open ? 680 : 210,\n        border: '1px solid rgba(94, 234, 212, 0.42)',\n        borderRadius: 16,\n        overflow: 'hidden',\n        color: '#e6fffb',\n        background: 'rgba(5, 14, 25, 0.96)',\n        boxShadow: '0 24px 70px rgba(0, 0, 0, 0.55)',\n        pointerEvents: 'auto',\n        fontFamily: 'ui-sans-serif, system-ui, sans-serif',\n      }}\n    >\n      <header\n        style={{\n          display: 'flex',\n          alignItems: 'center',\n          justifyContent: 'space-between',\n          padding: '11px 14px',\n          background: 'linear-gradient(90deg, rgba(13,148,136,.28), rgba(37,99,235,.18))',\n        }}\n      >\n        <div>\n          <strong style={{ fontSize: 14 }}>ForgeaX Engine</strong>\n          <span\n            data-forgeax-ready={realm?.ready === true ? 'true' : 'false'}\n            style={{\n              marginLeft: 9,\n              color: realm?.ready === true ? '#5eead4' : '#fbbf24',\n              fontSize: 12,\n            }}\n          >\n            {realm?.ready === true ? '● bridge ready' : '○ connecting'}\n          </span>\n        </div>\n        <button type=\"button\" onClick={() => setOpen((value) => !value)} style={buttonStyle}>\n          {open ? 'Hide preview' : 'Show preview'}\n        </button>\n      </header>\n      {open ? (\n        <div style={{ padding: 12 }}>\n          <div\n            data-forgeax-status=\"live\"\n            style={{\n              display: 'grid',\n              gridTemplateColumns: 'repeat(4, 1fr)',\n              gap: 8,\n              marginBottom: 10,\n            }}\n          >\n            <Fact label=\"binding\" value={realm?.engine.binding ?? 'pending'} />\n            <Fact label=\"frameId\" value={String(projection?.frameId ?? 0)} />\n            <Fact label=\"tick\" value={String(projection?.tick ?? 0)} />\n            <Fact label=\"state\" value={String(projection?.state ?? 0)} />\n          </div>\n          {engineEndpoint !== undefined ? (\n            <iframe\n              ref={iframe}\n              data-forgeax-engine-frame=\"real\"\n              src={engineEndpoint}\n              title=\"Running ForgeaX Engine\"\n              onLoad={() => {\n                iframe.current?.contentWindow?.postMessage(\n                  { protocol: FEDERATION_PROTOCOL_VERSION, kind: 'forgeax-engine-poll' },\n                  new URL(engineEndpoint).origin,\n                );\n              }}\n              style={{\n                display: 'block',\n                width: '100%',\n                height: 390,\n                border: '1px solid rgba(148,163,184,.25)',\n                borderRadius: 10,\n                background: '#020617',\n              }}\n            />\n          ) : (\n            <div\n              data-forgeax-headless=\"true\"\n              style={{\n                display: 'grid',\n                placeItems: 'center',\n                height: 180,\n                borderRadius: 10,\n                color: '#94a3b8',\n                background: 'radial-gradient(circle at center, #123047, #020617 70%)',\n              }}\n            >\n              Embedded headless Engine · no placeholder pixels\n            </div>\n          )}\n          <footer\n            style={{\n              display: 'flex',\n              alignItems: 'center',\n              justifyContent: 'space-between',\n              marginTop: 10,\n            }}\n          >\n            <span style={{ color: '#94a3b8', fontSize: 12 }}>\n              DSH native Loader · lease {realm?.leases ?? 0} · protocol {realm?.protocol ?? '–'}\n            </span>\n            <button\n              data-forgeax-control=\"toggle\"\n              type=\"button\"\n              onClick={control}\n              style={buttonStyle}\n            >\n              Toggle Engine state\n            </button>\n          </footer>\n        </div>\n      ) : null}\n    </section>\n  );\n}\n\nfunction Fact({\n  label,\n  value,\n}: {\n  readonly label: string;\n  readonly value: string;\n}): React.JSX.Element {\n  return (\n    <div style={{ padding: '7px 9px', borderRadius: 8, background: 'rgba(15, 23, 42, .9)' }}>\n      <div\n        style={{\n          color: '#64748b',\n          fontSize: 10,\n          textTransform: 'uppercase',\n          letterSpacing: '.08em',\n        }}\n      >\n        {label}\n      </div>\n      <div style={{ color: '#f8fafc', fontSize: 13, fontVariantNumeric: 'tabular-nums' }}>\n        {value}\n      </div>\n    </div>\n  );\n}\n\nconst buttonStyle: React.CSSProperties = {\n  padding: '6px 10px',\n  border: '1px solid rgba(94,234,212,.35)',\n  borderRadius: 8,\n  color: '#ccfbf1',\n  background: 'rgba(15,118,110,.25)',\n  cursor: 'pointer',\n  fontSize: 12,\n};\n","export const FEDERATION_PROTOCOL_VERSION = 1 as const;\nexport const FEDERATION_ROUTE_PREFIX = '/forgeax-federation/v1' as const;\n\nexport type FederationBinding = 'attach' | 'external' | 'embedded';\nexport type FederationOwnership = 'lease' | 'instance';\n\nexport interface FederationStatus {\n  readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n  readonly identity: string;\n  readonly ready: true;\n  readonly realm: 'dsh';\n  readonly capabilities: readonly string[];\n  readonly leases: number;\n  readonly engine: EngineProjection;\n}\n\nexport type EngineProjection = EngineEndpointProjection | EmbeddedEngineProjection;\n\nexport interface EngineEndpointProjection {\n  readonly binding: 'external';\n  readonly endpoint: string;\n  readonly ready: true;\n}\n\nexport interface EmbeddedEngineProjection {\n  readonly binding: 'embedded';\n  readonly ready: true;\n  readonly frameId: number;\n  readonly tick: number;\n  readonly state: number;\n}\n\nexport interface FederationLease {\n  readonly leaseId: string;\n}\n\nexport interface FederationCommunityCapability {\n  readonly id: string;\n  readonly value: string;\n}\n\nexport interface FederationActivityResult {\n  readonly output: string;\n}\n\nexport function isFederationCommunityCapability(\n  value: unknown,\n): value is FederationCommunityCapability {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Record<string, unknown>;\n  return typeof record.id === 'string' && typeof record.value === 'string';\n}\n\nexport interface EnginePreviewStatus {\n  readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n  readonly kind: 'forgeax-engine-status';\n  readonly binding: 'external';\n  readonly ready: true;\n  readonly frameId: number;\n  readonly tick: number;\n  readonly state: number;\n}\n\nexport interface EnginePreviewPoll {\n  readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n  readonly kind: 'forgeax-engine-poll';\n}\n\nexport interface EnginePreviewControl {\n  readonly protocol: typeof FEDERATION_PROTOCOL_VERSION;\n  readonly kind: 'forgeax-engine-control';\n  readonly action: 'toggle';\n}\n\nexport type EnginePreviewRequest = EnginePreviewPoll | EnginePreviewControl;\n\nexport function isEnginePreviewRequest(value: unknown): value is EnginePreviewRequest {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Record<string, unknown>;\n  if (record.protocol !== FEDERATION_PROTOCOL_VERSION) return false;\n  if (record.kind === 'forgeax-engine-poll') return true;\n  return record.kind === 'forgeax-engine-control' && record.action === 'toggle';\n}\n\nexport function isEnginePreviewStatus(value: unknown): value is EnginePreviewStatus {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Record<string, unknown>;\n  return (\n    record.protocol === FEDERATION_PROTOCOL_VERSION &&\n    record.kind === 'forgeax-engine-status' &&\n    record.binding === 'external' &&\n    record.ready === true &&\n    typeof record.frameId === 'number' &&\n    typeof record.tick === 'number' &&\n    typeof record.state === 'number'\n  );\n}\n\nexport function isFederationStatus(value: unknown): value is FederationStatus {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Record<string, unknown>;\n  return (\n    record.protocol === FEDERATION_PROTOCOL_VERSION &&\n    record.realm === 'dsh' &&\n    record.ready === true &&\n    typeof record.identity === 'string' &&\n    Array.isArray(record.capabilities) &&\n    record.capabilities.every((capability) => typeof capability === 'string') &&\n    Number.isInteger(record.leases) &&\n    (record.leases as number) >= 0 &&\n    isEngineProjection(record.engine)\n  );\n}\n\nfunction isEngineProjection(value: unknown): value is EngineProjection {\n  if (typeof value !== 'object' || value === null) return false;\n  const record = value as Record<string, unknown>;\n  if (record.ready !== true) return false;\n  if (record.binding === 'external') return typeof record.endpoint === 'string';\n  return (\n    record.binding === 'embedded' &&\n    typeof record.frameId === 'number' &&\n    typeof record.tick === 'number' &&\n    typeof record.state === 'number'\n  );\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@forgeax/engine-dsh",
+  "version": "0.1.2",
+  "private": false,
+  "type": "module",
+  "license": "Apache-2.0",
+  "sideEffects": false,
+  "description": "Lifecycle-safe federation bridge between ForgeaX Engine and DeepSeek Harness.",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./engine-host": {
+      "types": "./dist/engine-host.d.ts",
+      "import": "./dist/engine-host.mjs"
+    },
+    "./engine-preview": {
+      "types": "./dist/engine-preview.d.ts",
+      "import": "./dist/engine-preview.mjs"
+    },
+    "./intelligence": {
+      "types": "./dist/intelligence.d.ts",
+      "import": "./dist/intelligence.mjs"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ],
+      "platform": "web"
+    }
+  },
+  "dependencies": {
+    "@forgeax/engine-ecs": "0.1.2",
+    "@forgeax/engine-intelligence": "0.1.2",
+    "@forgeax/engine-plugin": "0.1.2",
+    "@forgeax/engine-types": "0.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "@types/react": "^19.2.17",
+    "playwright": "^1.56.1",
+    "react": "^19.2.7"
+  },
+  "forgeax": {
+    "metrics": {
+      "bundle-size": {
+        "enabled": true,
+        "path": "dist/engine-host.mjs",
+        "compression": "gzip"
+      },
+      "fps": {
+        "enabled": false,
+        "reason": "federation is an opt-in control-plane connector outside the frame loop"
+      },
+      "bench": {
+        "enabled": false,
+        "reason": "frame-path absence is checked by topology and opt-in integration probes"
+      },
+      "gate": {
+        "enabled": true,
+        "command": "pnpm --filter @forgeax/engine-dsh test"
+      },
+      "spike-report": {
+        "enabled": false,
+        "reason": "not a spike package"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "pretest:integration": "pnpm build",
+    "test:integration": "node scripts/verify-dsh-federation.mjs",
+    "pretest:visual": "pnpm build",
+    "test:visual": "node scripts/verify-dsh-web-ui.mjs"
+  }
+}