@a2ui-vue3-elementplus/runtime-core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,397 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  applyMessage: () => applyMessage,
+  createA2Runtime: () => createA2Runtime,
+  createEventBus: () => createEventBus,
+  createSurfaceStore: () => createSurfaceStore,
+  getByJsonPointer: () => getByJsonPointer,
+  parseJsonPointer: () => parseJsonPointer,
+  removeByJsonPointer: () => removeByJsonPointer,
+  setByJsonPointer: () => setByJsonPointer
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/events.ts
+function createEventBus() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    subscribe(event, handler) {
+      const eventHandlers = handlers.get(event) ?? /* @__PURE__ */ new Set();
+      eventHandlers.add(handler);
+      handlers.set(event, eventHandlers);
+      return () => {
+        eventHandlers.delete(handler);
+        if (eventHandlers.size === 0) handlers.delete(event);
+      };
+    },
+    emit(event, payload) {
+      handlers.get(event)?.forEach((handler) => handler(payload));
+    }
+  };
+}
+
+// src/jsonPointer.ts
+var pointerTokenPattern = /~1|~0/g;
+function parseJsonPointer(path) {
+  if (path === "") return [];
+  if (!path.startsWith("/")) {
+    throw new Error(`JSON Pointer must be empty or start with "/": ${path}`);
+  }
+  return path.slice(1).split("/").map((token) => token.replace(pointerTokenPattern, (match) => match === "~1" ? "/" : "~"));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneJson(value) {
+  if (Array.isArray(value)) return value.map((item) => cloneJson(item));
+  if (isRecord(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, cloneJson(item)]));
+  }
+  return value;
+}
+function createContainer(nextToken) {
+  return nextToken !== void 0 && /^\d+$/.test(nextToken) ? [] : {};
+}
+function getByJsonPointer(root, path) {
+  let current = root;
+  for (const token of parseJsonPointer(path)) {
+    if (Array.isArray(current)) {
+      const index = Number(token);
+      current = Number.isInteger(index) ? current[index] : void 0;
+    } else if (isRecord(current)) {
+      current = current[token];
+    } else {
+      return void 0;
+    }
+  }
+  return current;
+}
+function setByJsonPointer(root, path, value) {
+  const tokens = parseJsonPointer(path);
+  if (tokens.length === 0) return cloneJson(value);
+  const nextRoot = cloneJson(root);
+  let current = nextRoot;
+  tokens.forEach((token, index) => {
+    const isLast = index === tokens.length - 1;
+    if (Array.isArray(current)) {
+      const arrayIndex = token === "-" ? current.length : Number(token);
+      if (!Number.isInteger(arrayIndex) || arrayIndex < 0) {
+        throw new Error(`Invalid array index in JSON Pointer: ${token}`);
+      }
+      if (isLast) {
+        current[arrayIndex] = cloneJson(value);
+        return;
+      }
+      if (current[arrayIndex] === void 0 || current[arrayIndex] === null) {
+        current[arrayIndex] = createContainer(tokens[index + 1]);
+      }
+      current = current[arrayIndex];
+      return;
+    }
+    if (!isRecord(current)) {
+      throw new Error(`Cannot set JSON Pointer through non-object value at "${token}"`);
+    }
+    if (isLast) {
+      current[token] = cloneJson(value);
+      return;
+    }
+    if (current[token] === void 0 || current[token] === null) {
+      current[token] = createContainer(tokens[index + 1]);
+    }
+    current = current[token];
+  });
+  return nextRoot;
+}
+function removeByJsonPointer(root, path) {
+  const tokens = parseJsonPointer(path);
+  if (tokens.length === 0) return {};
+  const nextRoot = cloneJson(root);
+  let current = nextRoot;
+  for (let index = 0; index < tokens.length - 1; index += 1) {
+    const token = tokens[index];
+    if (Array.isArray(current)) {
+      current = current[Number(token)];
+    } else if (isRecord(current)) {
+      current = current[token];
+    } else {
+      return nextRoot;
+    }
+  }
+  const lastToken = tokens[tokens.length - 1];
+  if (Array.isArray(current)) {
+    const arrayIndex = Number(lastToken);
+    if (Number.isInteger(arrayIndex)) current.splice(arrayIndex, 1);
+  } else if (isRecord(current)) {
+    delete current[lastToken];
+  }
+  return nextRoot;
+}
+
+// src/surfaceStore.ts
+var defaultSurfaceId = "main";
+var defaultRootId = "root";
+function normalizeComponents(input) {
+  const components = /* @__PURE__ */ new Map();
+  if (!input) return components;
+  const values = Array.isArray(input) ? input : Object.values(input);
+  values.forEach((component) => {
+    components.set(component.id, { ...component });
+  });
+  return components;
+}
+function snapshot(surface) {
+  return {
+    id: surface.id,
+    surfaceId: surface.id,
+    rootId: surface.rootId,
+    catalogId: surface.catalogId,
+    sendDataModel: surface.sendDataModel,
+    components: Object.fromEntries(Array.from(surface.components.entries()).map(([id, component]) => [id, { ...component }])),
+    dataModel: surface.dataModel
+  };
+}
+function surfaceIdFrom(payload) {
+  return payload?.surfaceId ?? payload?.id ?? defaultSurfaceId;
+}
+function normalizeDataPath(path) {
+  return !path || path === "/" ? "" : path;
+}
+function createSurfaceStore() {
+  const surfaces = /* @__PURE__ */ new Map();
+  function requireSurface(surfaceId) {
+    const surface = surfaces.get(surfaceId);
+    if (!surface) throw new Error(`Surface not found: ${surfaceId}`);
+    return surface;
+  }
+  return {
+    createSurface(payload = {}) {
+      const id = surfaceIdFrom(payload);
+      const surface = {
+        id,
+        rootId: payload.rootId ?? defaultRootId,
+        catalogId: payload.catalogId,
+        sendDataModel: payload.sendDataModel,
+        components: normalizeComponents(payload.components),
+        dataModel: payload.dataModel ?? {}
+      };
+      surfaces.set(id, surface);
+      return snapshot(surface);
+    },
+    updateComponents(payload) {
+      const surface = requireSurface(surfaceIdFrom(payload));
+      const nextComponents = normalizeComponents(payload.components);
+      if (payload.replace) {
+        surface.components = nextComponents;
+      } else {
+        nextComponents.forEach((component, id) => surface.components.set(id, component));
+      }
+      return snapshot(surface);
+    },
+    updateDataModel(payload) {
+      const surface = requireSurface(surfaceIdFrom(payload));
+      surface.dataModel = setByJsonPointer(surface.dataModel, normalizeDataPath(payload.path), payload.value);
+      return snapshot(surface);
+    },
+    deleteSurface(payload) {
+      const surfaceId = surfaceIdFrom(typeof payload === "string" ? { surfaceId: payload } : payload);
+      return surfaces.delete(surfaceId);
+    },
+    getSurface(surfaceId) {
+      const surface = surfaces.get(surfaceId);
+      return surface ? snapshot(surface) : void 0;
+    },
+    listSurfaces() {
+      return Array.from(surfaces.values()).map(snapshot);
+    },
+    getDataModelValue(surfaceId, path) {
+      return getByJsonPointer(requireSurface(surfaceId).dataModel, normalizeDataPath(path));
+    },
+    removeDataModelValue(surfaceId, path) {
+      const surface = requireSurface(surfaceId);
+      surface.dataModel = removeByJsonPointer(surface.dataModel, normalizeDataPath(path));
+      return snapshot(surface);
+    },
+    reset() {
+      surfaces.clear();
+    }
+  };
+}
+
+// src/runtime.ts
+function messageType(message) {
+  if ("createSurface" in message) return "createSurface";
+  if ("updateComponents" in message) return "updateComponents";
+  if ("updateDataModel" in message) return "updateDataModel";
+  if ("deleteSurface" in message) return "deleteSurface";
+  return message.type ?? message.kind ?? message.action;
+}
+function payloadOf(message) {
+  if ("createSurface" in message) return message.createSurface;
+  if ("updateComponents" in message) return message.updateComponents;
+  if ("updateDataModel" in message) return message.updateDataModel;
+  if ("deleteSurface" in message) return message.deleteSurface;
+  return message.payload ?? message;
+}
+function surfaceIdFrom2(payload) {
+  if (typeof payload === "string") return payload;
+  return payload?.surfaceId ?? payload?.id ?? "main";
+}
+function createA2Runtime(options = {}) {
+  const store = options.store ?? createSurfaceStore();
+  const events = createEventBus();
+  const now = options.now ?? Date.now;
+  const runtime = {
+    store,
+    createSurface(payload) {
+      const result = store.createSurface(payload);
+      events.emit("surfaceCreated", result);
+      return result;
+    },
+    updateComponents(payload) {
+      const result = store.updateComponents(payload);
+      events.emit("componentsUpdated", result);
+      return result;
+    },
+    updateDataModel(payload) {
+      const result = store.updateDataModel(payload);
+      events.emit("dataModelUpdated", {
+        surfaceId: payload.surfaceId ?? payload.id ?? "default",
+        path: payload.path,
+        value: payload.value,
+        surface: result
+      });
+      return result;
+    },
+    deleteSurface(payload) {
+      const surfaceId = surfaceIdFrom2(payload);
+      const deleted = store.deleteSurface(surfaceId);
+      if (deleted) events.emit("surfaceDeleted", { surfaceId });
+      return deleted;
+    },
+    applyMessage(message) {
+      try {
+        const result = applyMessage(runtime, message);
+        events.emit("messageApplied", { message, result });
+        return result;
+      } catch (error) {
+        events.emit("error", error);
+        throw error;
+      }
+    },
+    getSurface(surfaceId = "main") {
+      return store.getSurface(surfaceId);
+    },
+    getComponent(surfaceId = "main", componentId) {
+      return store.getSurface(surfaceId)?.components[componentId];
+    },
+    getData(surfaceId = "main", path) {
+      return store.getDataModelValue(surfaceId, path);
+    },
+    setData(surfaceId = "main", path, value) {
+      if (!path) {
+        return void 0;
+      }
+      const result = runtime.updateDataModel({
+        surfaceId,
+        path,
+        value
+      });
+      return result.dataModel;
+    },
+    reset() {
+      store.reset();
+      events.emit("reset", void 0);
+    },
+    createActionPayload(input) {
+      const surface = store.getSurface(input.surfaceId);
+      const name = input.name ?? input.action ?? "action";
+      return {
+        type: "event",
+        version: "v0.9",
+        surfaceId: input.surfaceId,
+        componentId: input.componentId,
+        name,
+        context: input.context ?? input.payload,
+        dataModel: surface?.sendDataModel ? surface.dataModel : void 0,
+        timestamp: new Date(now()).toISOString()
+      };
+    },
+    emitAction(input) {
+      const payload = runtime.createActionPayload(input);
+      events.emit("action", payload);
+      return payload;
+    },
+    onAction(handler) {
+      return events.subscribe("action", handler);
+    },
+    onError(handler) {
+      return events.subscribe("error", handler);
+    },
+    subscribe(eventOrHandler, handler) {
+      if (typeof eventOrHandler === "function") {
+        const offMessage = events.subscribe("messageApplied", eventOrHandler);
+        const offCreated = events.subscribe("surfaceCreated", eventOrHandler);
+        const offComponents = events.subscribe("componentsUpdated", eventOrHandler);
+        const offData = events.subscribe("dataModelUpdated", eventOrHandler);
+        const offDeleted = events.subscribe("surfaceDeleted", eventOrHandler);
+        const offReset = events.subscribe("reset", eventOrHandler);
+        return () => {
+          offMessage();
+          offCreated();
+          offComponents();
+          offData();
+          offDeleted();
+          offReset();
+        };
+      }
+      return events.subscribe(eventOrHandler, handler);
+    },
+    emit: events.emit
+  };
+  return runtime;
+}
+function applyMessage(runtime, message) {
+  switch (messageType(message)) {
+    case "createSurface":
+      return runtime.createSurface(payloadOf(message));
+    case "updateComponents":
+      return runtime.updateComponents(payloadOf(message));
+    case "updateDataModel":
+      return runtime.updateDataModel(payloadOf(message));
+    case "deleteSurface":
+      return runtime.deleteSurface(payloadOf(message));
+    default:
+      throw new Error(`Unsupported runtime message type: ${messageType(message) ?? "unknown"}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  applyMessage,
+  createA2Runtime,
+  createEventBus,
+  createSurfaceStore,
+  getByJsonPointer,
+  parseJsonPointer,
+  removeByJsonPointer,
+  setByJsonPointer
+});

package/dist/index.d.cts

@@ -0,0 +1,182 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+type JsonObject = {
+    [key: string]: JsonValue | undefined;
+};
+type JsonArray = JsonValue[];
+interface A2Component {
+    id: string;
+    type?: string;
+    component?: string;
+    child?: string;
+    props?: Record<string, unknown>;
+    children?: string[] | Record<string, unknown>;
+    slots?: Record<string, string[]>;
+    [key: string]: unknown;
+}
+type ComponentInput = A2Component[] | Record<string, A2Component>;
+interface SurfaceSnapshot {
+    id: string;
+    surfaceId: string;
+    rootId: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    components: Record<string, A2Component>;
+    dataModel: JsonValue;
+}
+interface CreateSurfacePayload {
+    surfaceId?: string;
+    id?: string;
+    rootId?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    components?: ComponentInput;
+    dataModel?: JsonValue;
+}
+interface UpdateComponentsPayload {
+    surfaceId?: string;
+    id?: string;
+    components: ComponentInput;
+    replace?: boolean;
+}
+interface UpdateDataModelPayload {
+    surfaceId?: string;
+    id?: string;
+    path?: string;
+    value: JsonValue;
+}
+interface DeleteSurfacePayload {
+    surfaceId?: string;
+    id?: string;
+}
+type A2RuntimeMessage = {
+    version?: string;
+    a2ui?: string;
+    createSurface: CreateSurfacePayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    updateComponents: UpdateComponentsPayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    updateDataModel: UpdateDataModelPayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    deleteSurface: DeleteSurfacePayload;
+} | {
+    type: 'createSurface';
+    payload?: CreateSurfacePayload;
+} | {
+    type: 'updateComponents';
+    payload: UpdateComponentsPayload;
+} | {
+    type: 'updateDataModel';
+    payload: UpdateDataModelPayload;
+} | {
+    type: 'deleteSurface';
+    payload?: DeleteSurfacePayload;
+} | ({
+    type?: string;
+    kind?: string;
+    action?: string;
+    payload?: unknown;
+} & Record<string, unknown>);
+interface A2ActionPayload<TPayload = unknown> {
+    type: 'event';
+    version: string;
+    surfaceId: string;
+    componentId: string;
+    name: string;
+    context?: TPayload;
+    dataModel?: JsonValue;
+    timestamp: string;
+}
+type RuntimeEventMap = {
+    surfaceCreated: SurfaceSnapshot;
+    componentsUpdated: SurfaceSnapshot;
+    dataModelUpdated: {
+        surfaceId: string;
+        path: string;
+        value: JsonValue;
+        surface: SurfaceSnapshot;
+    };
+    surfaceDeleted: {
+        surfaceId: string;
+    };
+    action: A2ActionPayload;
+    messageApplied: {
+        message: A2RuntimeMessage;
+        result: unknown;
+    };
+};
+type RuntimeEventName = keyof RuntimeEventMap | string;
+type RuntimeEventHandler<T = unknown> = (payload: T) => void;
+
+interface EventBus {
+    subscribe<T = unknown>(event: RuntimeEventName, handler: RuntimeEventHandler<T>): () => void;
+    emit<T = unknown>(event: RuntimeEventName, payload: T): void;
+}
+declare function createEventBus(): EventBus;
+
+declare function parseJsonPointer(path: string): string[];
+declare function getByJsonPointer(root: JsonValue, path: string): JsonValue | undefined;
+declare function setByJsonPointer(root: JsonValue, path: string, value: JsonValue): JsonValue;
+declare function removeByJsonPointer(root: JsonValue, path: string): JsonValue;
+
+interface SurfaceStore {
+    createSurface(payload?: CreateSurfacePayload): SurfaceSnapshot;
+    updateComponents(payload: UpdateComponentsPayload): SurfaceSnapshot;
+    updateDataModel(payload: UpdateDataModelPayload): SurfaceSnapshot;
+    deleteSurface(payload?: DeleteSurfacePayload | string): boolean;
+    getSurface(surfaceId: string): SurfaceSnapshot | undefined;
+    listSurfaces(): SurfaceSnapshot[];
+    getDataModelValue(surfaceId: string, path: string): JsonValue | undefined;
+    removeDataModelValue(surfaceId: string, path: string): SurfaceSnapshot;
+    reset(): void;
+}
+declare function createSurfaceStore(): SurfaceStore;
+
+interface A2Runtime {
+    store: SurfaceStore;
+    createSurface(payload?: CreateSurfacePayload): ReturnType<SurfaceStore['createSurface']>;
+    updateComponents(payload: UpdateComponentsPayload): ReturnType<SurfaceStore['updateComponents']>;
+    updateDataModel(payload: UpdateDataModelPayload): ReturnType<SurfaceStore['updateDataModel']>;
+    deleteSurface(payload?: DeleteSurfacePayload | string): boolean;
+    applyMessage(message: A2RuntimeMessage): unknown;
+    getSurface(surfaceId?: string): ReturnType<SurfaceStore['getSurface']>;
+    getComponent(surfaceId: string | undefined, componentId: string): Record<string, unknown> | undefined;
+    getData(surfaceId: string | undefined, path: string): unknown;
+    setData(surfaceId: string | undefined, path: string | undefined, value: unknown, meta?: Record<string, unknown>): unknown;
+    reset(): void;
+    createActionPayload<TPayload = unknown>(input: {
+        surfaceId: string;
+        componentId: string;
+        action?: string;
+        name?: string;
+        payload?: TPayload;
+        context?: TPayload;
+    }): A2ActionPayload<TPayload>;
+    emitAction<TPayload = unknown>(input: {
+        surfaceId: string;
+        componentId: string;
+        action?: string;
+        name?: string;
+        payload?: TPayload;
+        context?: TPayload;
+    }): A2ActionPayload<TPayload>;
+    onAction(handler: RuntimeEventHandler<RuntimeEventMap['action']>): () => void;
+    onError(handler: RuntimeEventHandler<unknown>): () => void;
+    subscribe(handler: RuntimeEventHandler<RuntimeEventMap['messageApplied']>): () => void;
+    subscribe<K extends keyof RuntimeEventMap>(event: K, handler: RuntimeEventHandler<RuntimeEventMap[K]>): () => void;
+    subscribe<T = unknown>(event: RuntimeEventName, handler: RuntimeEventHandler<T>): () => void;
+    emit<T = unknown>(event: RuntimeEventName, payload: T): void;
+}
+declare function createA2Runtime(options?: {
+    store?: SurfaceStore;
+    now?: () => number;
+}): A2Runtime;
+declare function applyMessage(runtime: Pick<A2Runtime, 'createSurface' | 'updateComponents' | 'updateDataModel' | 'deleteSurface'>, message: A2RuntimeMessage): unknown;
+
+export { type A2ActionPayload, type A2Component, type A2Runtime, type A2RuntimeMessage, type ComponentInput, type CreateSurfacePayload, type DeleteSurfacePayload, type EventBus, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type RuntimeEventHandler, type RuntimeEventMap, type RuntimeEventName, type SurfaceSnapshot, type SurfaceStore, type UpdateComponentsPayload, type UpdateDataModelPayload, applyMessage, createA2Runtime, createEventBus, createSurfaceStore, getByJsonPointer, parseJsonPointer, removeByJsonPointer, setByJsonPointer };

package/dist/index.d.ts

@@ -0,0 +1,182 @@
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+type JsonObject = {
+    [key: string]: JsonValue | undefined;
+};
+type JsonArray = JsonValue[];
+interface A2Component {
+    id: string;
+    type?: string;
+    component?: string;
+    child?: string;
+    props?: Record<string, unknown>;
+    children?: string[] | Record<string, unknown>;
+    slots?: Record<string, string[]>;
+    [key: string]: unknown;
+}
+type ComponentInput = A2Component[] | Record<string, A2Component>;
+interface SurfaceSnapshot {
+    id: string;
+    surfaceId: string;
+    rootId: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    components: Record<string, A2Component>;
+    dataModel: JsonValue;
+}
+interface CreateSurfacePayload {
+    surfaceId?: string;
+    id?: string;
+    rootId?: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    components?: ComponentInput;
+    dataModel?: JsonValue;
+}
+interface UpdateComponentsPayload {
+    surfaceId?: string;
+    id?: string;
+    components: ComponentInput;
+    replace?: boolean;
+}
+interface UpdateDataModelPayload {
+    surfaceId?: string;
+    id?: string;
+    path?: string;
+    value: JsonValue;
+}
+interface DeleteSurfacePayload {
+    surfaceId?: string;
+    id?: string;
+}
+type A2RuntimeMessage = {
+    version?: string;
+    a2ui?: string;
+    createSurface: CreateSurfacePayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    updateComponents: UpdateComponentsPayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    updateDataModel: UpdateDataModelPayload;
+} | {
+    version?: string;
+    a2ui?: string;
+    deleteSurface: DeleteSurfacePayload;
+} | {
+    type: 'createSurface';
+    payload?: CreateSurfacePayload;
+} | {
+    type: 'updateComponents';
+    payload: UpdateComponentsPayload;
+} | {
+    type: 'updateDataModel';
+    payload: UpdateDataModelPayload;
+} | {
+    type: 'deleteSurface';
+    payload?: DeleteSurfacePayload;
+} | ({
+    type?: string;
+    kind?: string;
+    action?: string;
+    payload?: unknown;
+} & Record<string, unknown>);
+interface A2ActionPayload<TPayload = unknown> {
+    type: 'event';
+    version: string;
+    surfaceId: string;
+    componentId: string;
+    name: string;
+    context?: TPayload;
+    dataModel?: JsonValue;
+    timestamp: string;
+}
+type RuntimeEventMap = {
+    surfaceCreated: SurfaceSnapshot;
+    componentsUpdated: SurfaceSnapshot;
+    dataModelUpdated: {
+        surfaceId: string;
+        path: string;
+        value: JsonValue;
+        surface: SurfaceSnapshot;
+    };
+    surfaceDeleted: {
+        surfaceId: string;
+    };
+    action: A2ActionPayload;
+    messageApplied: {
+        message: A2RuntimeMessage;
+        result: unknown;
+    };
+};
+type RuntimeEventName = keyof RuntimeEventMap | string;
+type RuntimeEventHandler<T = unknown> = (payload: T) => void;
+
+interface EventBus {
+    subscribe<T = unknown>(event: RuntimeEventName, handler: RuntimeEventHandler<T>): () => void;
+    emit<T = unknown>(event: RuntimeEventName, payload: T): void;
+}
+declare function createEventBus(): EventBus;
+
+declare function parseJsonPointer(path: string): string[];
+declare function getByJsonPointer(root: JsonValue, path: string): JsonValue | undefined;
+declare function setByJsonPointer(root: JsonValue, path: string, value: JsonValue): JsonValue;
+declare function removeByJsonPointer(root: JsonValue, path: string): JsonValue;
+
+interface SurfaceStore {
+    createSurface(payload?: CreateSurfacePayload): SurfaceSnapshot;
+    updateComponents(payload: UpdateComponentsPayload): SurfaceSnapshot;
+    updateDataModel(payload: UpdateDataModelPayload): SurfaceSnapshot;
+    deleteSurface(payload?: DeleteSurfacePayload | string): boolean;
+    getSurface(surfaceId: string): SurfaceSnapshot | undefined;
+    listSurfaces(): SurfaceSnapshot[];
+    getDataModelValue(surfaceId: string, path: string): JsonValue | undefined;
+    removeDataModelValue(surfaceId: string, path: string): SurfaceSnapshot;
+    reset(): void;
+}
+declare function createSurfaceStore(): SurfaceStore;
+
+interface A2Runtime {
+    store: SurfaceStore;
+    createSurface(payload?: CreateSurfacePayload): ReturnType<SurfaceStore['createSurface']>;
+    updateComponents(payload: UpdateComponentsPayload): ReturnType<SurfaceStore['updateComponents']>;
+    updateDataModel(payload: UpdateDataModelPayload): ReturnType<SurfaceStore['updateDataModel']>;
+    deleteSurface(payload?: DeleteSurfacePayload | string): boolean;
+    applyMessage(message: A2RuntimeMessage): unknown;
+    getSurface(surfaceId?: string): ReturnType<SurfaceStore['getSurface']>;
+    getComponent(surfaceId: string | undefined, componentId: string): Record<string, unknown> | undefined;
+    getData(surfaceId: string | undefined, path: string): unknown;
+    setData(surfaceId: string | undefined, path: string | undefined, value: unknown, meta?: Record<string, unknown>): unknown;
+    reset(): void;
+    createActionPayload<TPayload = unknown>(input: {
+        surfaceId: string;
+        componentId: string;
+        action?: string;
+        name?: string;
+        payload?: TPayload;
+        context?: TPayload;
+    }): A2ActionPayload<TPayload>;
+    emitAction<TPayload = unknown>(input: {
+        surfaceId: string;
+        componentId: string;
+        action?: string;
+        name?: string;
+        payload?: TPayload;
+        context?: TPayload;
+    }): A2ActionPayload<TPayload>;
+    onAction(handler: RuntimeEventHandler<RuntimeEventMap['action']>): () => void;
+    onError(handler: RuntimeEventHandler<unknown>): () => void;
+    subscribe(handler: RuntimeEventHandler<RuntimeEventMap['messageApplied']>): () => void;
+    subscribe<K extends keyof RuntimeEventMap>(event: K, handler: RuntimeEventHandler<RuntimeEventMap[K]>): () => void;
+    subscribe<T = unknown>(event: RuntimeEventName, handler: RuntimeEventHandler<T>): () => void;
+    emit<T = unknown>(event: RuntimeEventName, payload: T): void;
+}
+declare function createA2Runtime(options?: {
+    store?: SurfaceStore;
+    now?: () => number;
+}): A2Runtime;
+declare function applyMessage(runtime: Pick<A2Runtime, 'createSurface' | 'updateComponents' | 'updateDataModel' | 'deleteSurface'>, message: A2RuntimeMessage): unknown;
+
+export { type A2ActionPayload, type A2Component, type A2Runtime, type A2RuntimeMessage, type ComponentInput, type CreateSurfacePayload, type DeleteSurfacePayload, type EventBus, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type RuntimeEventHandler, type RuntimeEventMap, type RuntimeEventName, type SurfaceSnapshot, type SurfaceStore, type UpdateComponentsPayload, type UpdateDataModelPayload, applyMessage, createA2Runtime, createEventBus, createSurfaceStore, getByJsonPointer, parseJsonPointer, removeByJsonPointer, setByJsonPointer };

package/dist/index.js

@@ -0,0 +1,363 @@
+// src/events.ts
+function createEventBus() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    subscribe(event, handler) {
+      const eventHandlers = handlers.get(event) ?? /* @__PURE__ */ new Set();
+      eventHandlers.add(handler);
+      handlers.set(event, eventHandlers);
+      return () => {
+        eventHandlers.delete(handler);
+        if (eventHandlers.size === 0) handlers.delete(event);
+      };
+    },
+    emit(event, payload) {
+      handlers.get(event)?.forEach((handler) => handler(payload));
+    }
+  };
+}
+
+// src/jsonPointer.ts
+var pointerTokenPattern = /~1|~0/g;
+function parseJsonPointer(path) {
+  if (path === "") return [];
+  if (!path.startsWith("/")) {
+    throw new Error(`JSON Pointer must be empty or start with "/": ${path}`);
+  }
+  return path.slice(1).split("/").map((token) => token.replace(pointerTokenPattern, (match) => match === "~1" ? "/" : "~"));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneJson(value) {
+  if (Array.isArray(value)) return value.map((item) => cloneJson(item));
+  if (isRecord(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, cloneJson(item)]));
+  }
+  return value;
+}
+function createContainer(nextToken) {
+  return nextToken !== void 0 && /^\d+$/.test(nextToken) ? [] : {};
+}
+function getByJsonPointer(root, path) {
+  let current = root;
+  for (const token of parseJsonPointer(path)) {
+    if (Array.isArray(current)) {
+      const index = Number(token);
+      current = Number.isInteger(index) ? current[index] : void 0;
+    } else if (isRecord(current)) {
+      current = current[token];
+    } else {
+      return void 0;
+    }
+  }
+  return current;
+}
+function setByJsonPointer(root, path, value) {
+  const tokens = parseJsonPointer(path);
+  if (tokens.length === 0) return cloneJson(value);
+  const nextRoot = cloneJson(root);
+  let current = nextRoot;
+  tokens.forEach((token, index) => {
+    const isLast = index === tokens.length - 1;
+    if (Array.isArray(current)) {
+      const arrayIndex = token === "-" ? current.length : Number(token);
+      if (!Number.isInteger(arrayIndex) || arrayIndex < 0) {
+        throw new Error(`Invalid array index in JSON Pointer: ${token}`);
+      }
+      if (isLast) {
+        current[arrayIndex] = cloneJson(value);
+        return;
+      }
+      if (current[arrayIndex] === void 0 || current[arrayIndex] === null) {
+        current[arrayIndex] = createContainer(tokens[index + 1]);
+      }
+      current = current[arrayIndex];
+      return;
+    }
+    if (!isRecord(current)) {
+      throw new Error(`Cannot set JSON Pointer through non-object value at "${token}"`);
+    }
+    if (isLast) {
+      current[token] = cloneJson(value);
+      return;
+    }
+    if (current[token] === void 0 || current[token] === null) {
+      current[token] = createContainer(tokens[index + 1]);
+    }
+    current = current[token];
+  });
+  return nextRoot;
+}
+function removeByJsonPointer(root, path) {
+  const tokens = parseJsonPointer(path);
+  if (tokens.length === 0) return {};
+  const nextRoot = cloneJson(root);
+  let current = nextRoot;
+  for (let index = 0; index < tokens.length - 1; index += 1) {
+    const token = tokens[index];
+    if (Array.isArray(current)) {
+      current = current[Number(token)];
+    } else if (isRecord(current)) {
+      current = current[token];
+    } else {
+      return nextRoot;
+    }
+  }
+  const lastToken = tokens[tokens.length - 1];
+  if (Array.isArray(current)) {
+    const arrayIndex = Number(lastToken);
+    if (Number.isInteger(arrayIndex)) current.splice(arrayIndex, 1);
+  } else if (isRecord(current)) {
+    delete current[lastToken];
+  }
+  return nextRoot;
+}
+
+// src/surfaceStore.ts
+var defaultSurfaceId = "main";
+var defaultRootId = "root";
+function normalizeComponents(input) {
+  const components = /* @__PURE__ */ new Map();
+  if (!input) return components;
+  const values = Array.isArray(input) ? input : Object.values(input);
+  values.forEach((component) => {
+    components.set(component.id, { ...component });
+  });
+  return components;
+}
+function snapshot(surface) {
+  return {
+    id: surface.id,
+    surfaceId: surface.id,
+    rootId: surface.rootId,
+    catalogId: surface.catalogId,
+    sendDataModel: surface.sendDataModel,
+    components: Object.fromEntries(Array.from(surface.components.entries()).map(([id, component]) => [id, { ...component }])),
+    dataModel: surface.dataModel
+  };
+}
+function surfaceIdFrom(payload) {
+  return payload?.surfaceId ?? payload?.id ?? defaultSurfaceId;
+}
+function normalizeDataPath(path) {
+  return !path || path === "/" ? "" : path;
+}
+function createSurfaceStore() {
+  const surfaces = /* @__PURE__ */ new Map();
+  function requireSurface(surfaceId) {
+    const surface = surfaces.get(surfaceId);
+    if (!surface) throw new Error(`Surface not found: ${surfaceId}`);
+    return surface;
+  }
+  return {
+    createSurface(payload = {}) {
+      const id = surfaceIdFrom(payload);
+      const surface = {
+        id,
+        rootId: payload.rootId ?? defaultRootId,
+        catalogId: payload.catalogId,
+        sendDataModel: payload.sendDataModel,
+        components: normalizeComponents(payload.components),
+        dataModel: payload.dataModel ?? {}
+      };
+      surfaces.set(id, surface);
+      return snapshot(surface);
+    },
+    updateComponents(payload) {
+      const surface = requireSurface(surfaceIdFrom(payload));
+      const nextComponents = normalizeComponents(payload.components);
+      if (payload.replace) {
+        surface.components = nextComponents;
+      } else {
+        nextComponents.forEach((component, id) => surface.components.set(id, component));
+      }
+      return snapshot(surface);
+    },
+    updateDataModel(payload) {
+      const surface = requireSurface(surfaceIdFrom(payload));
+      surface.dataModel = setByJsonPointer(surface.dataModel, normalizeDataPath(payload.path), payload.value);
+      return snapshot(surface);
+    },
+    deleteSurface(payload) {
+      const surfaceId = surfaceIdFrom(typeof payload === "string" ? { surfaceId: payload } : payload);
+      return surfaces.delete(surfaceId);
+    },
+    getSurface(surfaceId) {
+      const surface = surfaces.get(surfaceId);
+      return surface ? snapshot(surface) : void 0;
+    },
+    listSurfaces() {
+      return Array.from(surfaces.values()).map(snapshot);
+    },
+    getDataModelValue(surfaceId, path) {
+      return getByJsonPointer(requireSurface(surfaceId).dataModel, normalizeDataPath(path));
+    },
+    removeDataModelValue(surfaceId, path) {
+      const surface = requireSurface(surfaceId);
+      surface.dataModel = removeByJsonPointer(surface.dataModel, normalizeDataPath(path));
+      return snapshot(surface);
+    },
+    reset() {
+      surfaces.clear();
+    }
+  };
+}
+
+// src/runtime.ts
+function messageType(message) {
+  if ("createSurface" in message) return "createSurface";
+  if ("updateComponents" in message) return "updateComponents";
+  if ("updateDataModel" in message) return "updateDataModel";
+  if ("deleteSurface" in message) return "deleteSurface";
+  return message.type ?? message.kind ?? message.action;
+}
+function payloadOf(message) {
+  if ("createSurface" in message) return message.createSurface;
+  if ("updateComponents" in message) return message.updateComponents;
+  if ("updateDataModel" in message) return message.updateDataModel;
+  if ("deleteSurface" in message) return message.deleteSurface;
+  return message.payload ?? message;
+}
+function surfaceIdFrom2(payload) {
+  if (typeof payload === "string") return payload;
+  return payload?.surfaceId ?? payload?.id ?? "main";
+}
+function createA2Runtime(options = {}) {
+  const store = options.store ?? createSurfaceStore();
+  const events = createEventBus();
+  const now = options.now ?? Date.now;
+  const runtime = {
+    store,
+    createSurface(payload) {
+      const result = store.createSurface(payload);
+      events.emit("surfaceCreated", result);
+      return result;
+    },
+    updateComponents(payload) {
+      const result = store.updateComponents(payload);
+      events.emit("componentsUpdated", result);
+      return result;
+    },
+    updateDataModel(payload) {
+      const result = store.updateDataModel(payload);
+      events.emit("dataModelUpdated", {
+        surfaceId: payload.surfaceId ?? payload.id ?? "default",
+        path: payload.path,
+        value: payload.value,
+        surface: result
+      });
+      return result;
+    },
+    deleteSurface(payload) {
+      const surfaceId = surfaceIdFrom2(payload);
+      const deleted = store.deleteSurface(surfaceId);
+      if (deleted) events.emit("surfaceDeleted", { surfaceId });
+      return deleted;
+    },
+    applyMessage(message) {
+      try {
+        const result = applyMessage(runtime, message);
+        events.emit("messageApplied", { message, result });
+        return result;
+      } catch (error) {
+        events.emit("error", error);
+        throw error;
+      }
+    },
+    getSurface(surfaceId = "main") {
+      return store.getSurface(surfaceId);
+    },
+    getComponent(surfaceId = "main", componentId) {
+      return store.getSurface(surfaceId)?.components[componentId];
+    },
+    getData(surfaceId = "main", path) {
+      return store.getDataModelValue(surfaceId, path);
+    },
+    setData(surfaceId = "main", path, value) {
+      if (!path) {
+        return void 0;
+      }
+      const result = runtime.updateDataModel({
+        surfaceId,
+        path,
+        value
+      });
+      return result.dataModel;
+    },
+    reset() {
+      store.reset();
+      events.emit("reset", void 0);
+    },
+    createActionPayload(input) {
+      const surface = store.getSurface(input.surfaceId);
+      const name = input.name ?? input.action ?? "action";
+      return {
+        type: "event",
+        version: "v0.9",
+        surfaceId: input.surfaceId,
+        componentId: input.componentId,
+        name,
+        context: input.context ?? input.payload,
+        dataModel: surface?.sendDataModel ? surface.dataModel : void 0,
+        timestamp: new Date(now()).toISOString()
+      };
+    },
+    emitAction(input) {
+      const payload = runtime.createActionPayload(input);
+      events.emit("action", payload);
+      return payload;
+    },
+    onAction(handler) {
+      return events.subscribe("action", handler);
+    },
+    onError(handler) {
+      return events.subscribe("error", handler);
+    },
+    subscribe(eventOrHandler, handler) {
+      if (typeof eventOrHandler === "function") {
+        const offMessage = events.subscribe("messageApplied", eventOrHandler);
+        const offCreated = events.subscribe("surfaceCreated", eventOrHandler);
+        const offComponents = events.subscribe("componentsUpdated", eventOrHandler);
+        const offData = events.subscribe("dataModelUpdated", eventOrHandler);
+        const offDeleted = events.subscribe("surfaceDeleted", eventOrHandler);
+        const offReset = events.subscribe("reset", eventOrHandler);
+        return () => {
+          offMessage();
+          offCreated();
+          offComponents();
+          offData();
+          offDeleted();
+          offReset();
+        };
+      }
+      return events.subscribe(eventOrHandler, handler);
+    },
+    emit: events.emit
+  };
+  return runtime;
+}
+function applyMessage(runtime, message) {
+  switch (messageType(message)) {
+    case "createSurface":
+      return runtime.createSurface(payloadOf(message));
+    case "updateComponents":
+      return runtime.updateComponents(payloadOf(message));
+    case "updateDataModel":
+      return runtime.updateDataModel(payloadOf(message));
+    case "deleteSurface":
+      return runtime.deleteSurface(payloadOf(message));
+    default:
+      throw new Error(`Unsupported runtime message type: ${messageType(message) ?? "unknown"}`);
+  }
+}
+export {
+  applyMessage,
+  createA2Runtime,
+  createEventBus,
+  createSurfaceStore,
+  getByJsonPointer,
+  parseJsonPointer,
+  removeByJsonPointer,
+  setByJsonPointer
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@a2ui-vue3-elementplus/runtime-core",
+  "version": "0.1.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EricLee823/a2ui-vue3-elementplus.git",
+    "directory": "packages/runtime-core"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}