@meissa_a/meissa 0.1.0

package/dist/server.js

@@ -0,0 +1,303 @@
+// src/server/markdown.ts
+function resolvePath(data, path) {
+  const parts = path.split(".");
+  let current = data;
+  for (const part of parts) {
+    if (current === null || current === undefined)
+      return;
+    if (typeof current === "object") {
+      current = current[part];
+    } else {
+      return;
+    }
+  }
+  return current;
+}
+function resolveBindings(text, data) {
+  return text.replace(/\{\{([^}]+)\}\}/g, (_, path) => {
+    const value = resolvePath(data, path.trim());
+    if (value === undefined || value === null)
+      return "";
+    return String(value);
+  });
+}
+function componentToMarkdown(component, data) {
+  const type = component.type;
+  switch (type) {
+    case "heading": {
+      const level = typeof component.level === "number" ? component.level : 2;
+      const text = resolveBindings(String(component.text ?? ""), data);
+      return `${"#".repeat(level)} ${text}`;
+    }
+    case "text": {
+      const content = resolveBindings(String(component.content ?? component.text ?? ""), data);
+      return content;
+    }
+    case "table": {
+      const columns = component.columns;
+      const rows = component.rows;
+      const dataKey = component.data;
+      const resolvedRows = rows ?? (dataKey ? resolvePath(data, dataKey) : []) ?? [];
+      if (!columns || !Array.isArray(columns) || columns.length === 0) {
+        return "";
+      }
+      const headers = columns.map((col) => col.header ?? col.key ?? "");
+      const keys = columns.map((col) => col.key ?? col.header ?? "");
+      const headerRow = `| ${headers.join(" | ")} |`;
+      const separator = `| ${headers.map(() => "---").join(" | ")} |`;
+      const dataRows = Array.isArray(resolvedRows) ? resolvedRows.map((row) => {
+        const cells = keys.map((key) => {
+          const val = row[key];
+          return val !== undefined && val !== null ? String(val) : "";
+        });
+        return `| ${cells.join(" | ")} |`;
+      }) : [];
+      return [headerRow, separator, ...dataRows].join(`
+`);
+    }
+    case "stat": {
+      const label = resolveBindings(String(component.label ?? ""), data);
+      const value = resolveBindings(String(component.value ?? ""), data);
+      const trend = component.trend ? ` (${resolveBindings(String(component.trend), data)})` : "";
+      return `**${label}**: ${value}${trend}`;
+    }
+    case "list": {
+      const items = component.items;
+      const dataKey = component.data;
+      const ordered = component.ordered === true;
+      const resolvedItems = items ?? (dataKey ? resolvePath(data, dataKey) : []) ?? [];
+      if (!Array.isArray(resolvedItems))
+        return "";
+      return resolvedItems.map((item, i) => {
+        const text = typeof item === "string" ? item : item?.text ?? "";
+        const resolved = resolveBindings(text, data);
+        return ordered ? `${i + 1}. ${resolved}` : `- ${resolved}`;
+      }).join(`
+`);
+    }
+    case "btn": {
+      const label = resolveBindings(String(component.label ?? component.text ?? ""), data);
+      const action = String(component.action ?? component.tool ?? "");
+      return `[${label}](action:${action})`;
+    }
+    case "chart": {
+      const chartType = String(component.chartType ?? component.variant ?? "unknown");
+      const title = component.title ? resolveBindings(String(component.title), data) : "";
+      const titlePart = title ? ` — ${title}` : "";
+      return `(Chart: ${chartType}${titlePart})`;
+    }
+    case "code": {
+      const language = String(component.language ?? component.lang ?? "");
+      const content = resolveBindings(String(component.content ?? component.code ?? ""), data);
+      return `\`\`\`${language}
+${content}
+\`\`\``;
+    }
+    case "img": {
+      const alt = resolveBindings(String(component.alt ?? ""), data);
+      const src = resolveBindings(String(component.src ?? component.url ?? ""), data);
+      return `![${alt}](${src})`;
+    }
+    case "divider": {
+      return "---";
+    }
+    case "alert": {
+      const variant = String(component.variant ?? "info");
+      const content = resolveBindings(String(component.content ?? component.text ?? ""), data);
+      const emojiMap = {
+        info: "ℹ️",
+        warning: "⚠️",
+        error: "❌",
+        success: "✅"
+      };
+      const emoji = emojiMap[variant] ?? emojiMap["info"];
+      return `> ${emoji} ${content}`;
+    }
+    case "badge": {
+      const text = resolveBindings(String(component.text ?? component.label ?? ""), data);
+      return `\`${text}\``;
+    }
+    case "progress": {
+      const value = component.value ?? 0;
+      const label = component.label ? resolveBindings(String(component.label), data) : "";
+      return label ? `${label}: ${value}%` : `${value}%`;
+    }
+    case "toggle":
+    case "input":
+    case "select": {
+      const label = resolveBindings(String(component.label ?? ""), data);
+      return label ? `[${label}]` : "";
+    }
+    case "tabs": {
+      const tabItems = component.tabs;
+      if (!Array.isArray(tabItems))
+        return "";
+      return tabItems.map((tab) => {
+        const label = resolveBindings(String(tab.label ?? ""), data);
+        const content = tab.content ? schemaToMarkdown(tab.content, data) : "";
+        return `### ${label}
+
+${content}`;
+      }).join(`
+
+`);
+    }
+    case "accordion": {
+      const items = component.items;
+      if (!Array.isArray(items))
+        return "";
+      return items.map((item) => {
+        const title = resolveBindings(String(item.title ?? ""), data);
+        const content = item.content ? schemaToMarkdown(item.content, data) : "";
+        return `**${title}**
+
+${content}`;
+      }).join(`
+
+`);
+    }
+    case "row":
+    case "col":
+    case "grid":
+    case "split": {
+      const children = component.children;
+      if (!Array.isArray(children))
+        return "";
+      return schemaToMarkdown(children, data);
+    }
+    default:
+      return "";
+  }
+}
+function schemaToMarkdown(schema, data) {
+  return schema.map((component) => componentToMarkdown(component, data)).filter((line) => line !== "").join(`
+
+`);
+}
+function toMarkdown(schema, data = {}) {
+  return schemaToMarkdown(schema, data);
+}
+
+// src/server/validator.ts
+var ALLOWED_COMPONENT_TYPES = new Set([
+  "heading",
+  "text",
+  "btn",
+  "table",
+  "chart",
+  "stat",
+  "list",
+  "img",
+  "divider",
+  "badge",
+  "code",
+  "alert",
+  "progress",
+  "toggle",
+  "input",
+  "select",
+  "tabs",
+  "accordion",
+  "row",
+  "col",
+  "grid",
+  "split"
+]);
+var MAX_NESTING_DEPTH = 10;
+var MAX_COMPONENT_COUNT = 500;
+var MAX_SCHEMA_SIZE_BYTES = 64 * 1024;
+function countComponents(schema, depth, errors) {
+  if (depth > MAX_NESTING_DEPTH) {
+    errors.push(`Nesting depth exceeds maximum of ${MAX_NESTING_DEPTH}`);
+    return 0;
+  }
+  let count = 0;
+  for (const component of schema) {
+    count++;
+    if (!component.type || typeof component.type !== "string") {
+      errors.push(`Component missing valid "type" field`);
+      continue;
+    }
+    if (!ALLOWED_COMPONENT_TYPES.has(component.type)) {
+      errors.push(`Unknown component type: "${component.type}"`);
+    }
+    if (component.children && Array.isArray(component.children)) {
+      count += countComponents(component.children, depth + 1, errors);
+    }
+    if (component.type === "tabs" && Array.isArray(component.tabs)) {
+      for (const tab of component.tabs) {
+        if (tab.content && Array.isArray(tab.content)) {
+          count += countComponents(tab.content, depth + 1, errors);
+        }
+      }
+    }
+    if (component.type === "accordion" && Array.isArray(component.items)) {
+      for (const item of component.items) {
+        if (item.content && Array.isArray(item.content)) {
+          count += countComponents(item.content, depth + 1, errors);
+        }
+      }
+    }
+  }
+  return count;
+}
+function validate(schema) {
+  const errors = [];
+  if (!Array.isArray(schema)) {
+    errors.push("Schema must be an array");
+    return { valid: false, errors };
+  }
+  const serialized = JSON.stringify(schema);
+  if (serialized.length > MAX_SCHEMA_SIZE_BYTES) {
+    errors.push(`Schema size (${serialized.length} bytes) exceeds maximum of ${MAX_SCHEMA_SIZE_BYTES} bytes (64KB)`);
+  }
+  const totalCount = countComponents(schema, 1, errors);
+  if (totalCount > MAX_COMPONENT_COUNT) {
+    errors.push(`Total component count (${totalCount}) exceeds maximum of ${MAX_COMPONENT_COUNT}`);
+  }
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+// src/server/server.ts
+class MeissaServer {
+  render(schema, data = {}, opts) {
+    const fallback = opts?.fallback ?? toMarkdown(schema, data);
+    const contentBlock = {
+      type: "meissa",
+      schema,
+      data,
+      fallback
+    };
+    if (opts?.theme) {
+      contentBlock.theme = opts.theme;
+    }
+    return {
+      content: [contentBlock]
+    };
+  }
+  patch(target, patches) {
+    return {
+      content: [
+        {
+          type: "meissa/patch",
+          target,
+          patches
+        }
+      ]
+    };
+  }
+  toMarkdown(schema, data = {}) {
+    return toMarkdown(schema, data);
+  }
+  validate(schema) {
+    return validate(schema);
+  }
+}
+export {
+  validate,
+  toMarkdown,
+  MeissaServer
+};

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@meissa_a/meissa",
+  "version": "0.1.0",
+  "description": "Meissa — token-efficient generative UI for MCP: React renderer, client SDK, server SDK, and sandboxed-iframe apps adapter",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/meissa-ai/meissa"
+  },
+  "keywords": [
+    "generative-ui",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "react",
+    "ui-schema",
+    "declarative-ui"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/renderer/index.d.ts",
+      "import": "./dist/renderer.js",
+      "require": "./dist/renderer.cjs"
+    },
+    "./renderer": {
+      "types": "./dist/renderer/index.d.ts",
+      "import": "./dist/renderer.js",
+      "require": "./dist/renderer.cjs"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server.js",
+      "require": "./dist/server.cjs"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client.js",
+      "require": "./dist/client.cjs"
+    },
+    "./apps": {
+      "types": "./dist/apps/index.d.ts",
+      "import": "./dist/apps.js",
+      "require": "./dist/apps.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun run build.ts",
+    "dev": "bun run build.ts --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.6.0",
+    "recharts": "^2.15.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "@testing-library/react": "^16.1.0",
+    "@happy-dom/global-registrator": "^15.0.0",
+    "tailwindcss": "^4.0.0"
+  }
+}