@treeui/mcp 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,160 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+interface TreeuiCatalogField {
+    name: string;
+    type?: string;
+    required?: boolean;
+    default?: string;
+    values?: string[];
+    description?: string;
+    note?: string;
+    payload?: string;
+}
+interface TreeuiAlternative {
+    component: string;
+    when: string;
+}
+interface TreeuiSelectionProfile {
+    keywords: string[];
+    useWhen: string[];
+    avoidWhen: string[];
+    alternatives: TreeuiAlternative[];
+}
+interface TreeuiComponentSetup {
+    required: string[];
+    notes: string[];
+}
+interface TreeuiComponentEntry {
+    name: string;
+    legacyAlias?: string;
+    aliases: string[];
+    package: string;
+    kind?: string;
+    category?: string;
+    status?: string;
+    description?: string;
+    purpose?: string;
+    sourceFile?: string;
+    storyFile?: string;
+    storyTitle?: string;
+    manifestFile?: string;
+    props: TreeuiCatalogField[];
+    events: TreeuiCatalogField[];
+    slots: TreeuiCatalogField[];
+    a11y: string[];
+    behavior: string[];
+    selection: TreeuiSelectionProfile;
+    setup: TreeuiComponentSetup;
+    recipes: string[];
+}
+interface TreeuiDecisionGuideOption {
+    use: string;
+    when: string[];
+    notes: string[];
+}
+interface TreeuiDecisionGuide {
+    id: string;
+    question: string;
+    options: TreeuiDecisionGuideOption[];
+}
+interface TreeuiRecipe {
+    id: string;
+    name: string;
+    useWhen: string[];
+    compose: string[];
+    notes: string[];
+}
+interface TreeuiSetupEntry {
+    install: {
+        packageManagerExamples: Record<string, string>;
+        requiredImports: string[];
+    };
+    vueSetup: {
+        pluginInstall: {
+            import: string;
+            usage: string;
+        };
+        individualImports: {
+            import: string;
+        };
+        guidance: string[];
+    };
+    globalRules: string[];
+    componentSetup: Record<string, TreeuiComponentSetup>;
+    appPatterns: {
+        providers: Array<{
+            component: string;
+            placement: string;
+            reason: string;
+        }>;
+        commonCompositions: string[];
+    };
+}
+interface TreeuiCatalog {
+    generatedAt: string;
+    packageName: string;
+    packageVersion: string;
+    decisionGuides: TreeuiDecisionGuide[];
+    recipes: TreeuiRecipe[];
+    setup: TreeuiSetupEntry;
+    components: TreeuiComponentEntry[];
+}
+interface TreeuiSearchResult {
+    component: TreeuiComponentEntry;
+    score: number;
+    reasons: string[];
+}
+interface TreeuiRecipeSearchResult {
+    recipe: TreeuiRecipe;
+    score: number;
+}
+
+declare const catalog: TreeuiCatalog;
+declare const findComponent: (name: string) => TreeuiComponentEntry | undefined;
+declare const searchComponents: (query: string, limit?: number) => TreeuiSearchResult[];
+declare const recommendComponents: (task: string, limit?: number) => TreeuiSearchResult[];
+declare const searchRecipes: (query: string, limit?: number) => TreeuiRecipeSearchResult[];
+declare const formatComponentSummary: (component: TreeuiComponentEntry) => string;
+declare const formatSearchResults: (results: TreeuiSearchResult[]) => string;
+declare const formatRecipeResults: (results: TreeuiRecipeSearchResult[]) => string;
+declare const formatSetupGuide: (componentName?: string) => string;
+
+declare const buildCatalogFromRepo: (repoRoot: string) => TreeuiCatalog;
+declare const getRepoRootFromPackageRoot: (packageRoot: string) => string;
+
+declare const createTreeuiMcpServer: () => Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+
+export { type TreeuiCatalog, type TreeuiCatalogField, type TreeuiComponentEntry, type TreeuiDecisionGuide, type TreeuiRecipe, type TreeuiSearchResult, type TreeuiSetupEntry, buildCatalogFromRepo, catalog, createTreeuiMcpServer, findComponent, formatComponentSummary, formatRecipeResults, formatSearchResults, formatSetupGuide, getRepoRootFromPackageRoot, recommendComponents, searchComponents, searchRecipes };

package/dist/index.d.ts

@@ -0,0 +1,160 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
+interface TreeuiCatalogField {
+    name: string;
+    type?: string;
+    required?: boolean;
+    default?: string;
+    values?: string[];
+    description?: string;
+    note?: string;
+    payload?: string;
+}
+interface TreeuiAlternative {
+    component: string;
+    when: string;
+}
+interface TreeuiSelectionProfile {
+    keywords: string[];
+    useWhen: string[];
+    avoidWhen: string[];
+    alternatives: TreeuiAlternative[];
+}
+interface TreeuiComponentSetup {
+    required: string[];
+    notes: string[];
+}
+interface TreeuiComponentEntry {
+    name: string;
+    legacyAlias?: string;
+    aliases: string[];
+    package: string;
+    kind?: string;
+    category?: string;
+    status?: string;
+    description?: string;
+    purpose?: string;
+    sourceFile?: string;
+    storyFile?: string;
+    storyTitle?: string;
+    manifestFile?: string;
+    props: TreeuiCatalogField[];
+    events: TreeuiCatalogField[];
+    slots: TreeuiCatalogField[];
+    a11y: string[];
+    behavior: string[];
+    selection: TreeuiSelectionProfile;
+    setup: TreeuiComponentSetup;
+    recipes: string[];
+}
+interface TreeuiDecisionGuideOption {
+    use: string;
+    when: string[];
+    notes: string[];
+}
+interface TreeuiDecisionGuide {
+    id: string;
+    question: string;
+    options: TreeuiDecisionGuideOption[];
+}
+interface TreeuiRecipe {
+    id: string;
+    name: string;
+    useWhen: string[];
+    compose: string[];
+    notes: string[];
+}
+interface TreeuiSetupEntry {
+    install: {
+        packageManagerExamples: Record<string, string>;
+        requiredImports: string[];
+    };
+    vueSetup: {
+        pluginInstall: {
+            import: string;
+            usage: string;
+        };
+        individualImports: {
+            import: string;
+        };
+        guidance: string[];
+    };
+    globalRules: string[];
+    componentSetup: Record<string, TreeuiComponentSetup>;
+    appPatterns: {
+        providers: Array<{
+            component: string;
+            placement: string;
+            reason: string;
+        }>;
+        commonCompositions: string[];
+    };
+}
+interface TreeuiCatalog {
+    generatedAt: string;
+    packageName: string;
+    packageVersion: string;
+    decisionGuides: TreeuiDecisionGuide[];
+    recipes: TreeuiRecipe[];
+    setup: TreeuiSetupEntry;
+    components: TreeuiComponentEntry[];
+}
+interface TreeuiSearchResult {
+    component: TreeuiComponentEntry;
+    score: number;
+    reasons: string[];
+}
+interface TreeuiRecipeSearchResult {
+    recipe: TreeuiRecipe;
+    score: number;
+}
+
+declare const catalog: TreeuiCatalog;
+declare const findComponent: (name: string) => TreeuiComponentEntry | undefined;
+declare const searchComponents: (query: string, limit?: number) => TreeuiSearchResult[];
+declare const recommendComponents: (task: string, limit?: number) => TreeuiSearchResult[];
+declare const searchRecipes: (query: string, limit?: number) => TreeuiRecipeSearchResult[];
+declare const formatComponentSummary: (component: TreeuiComponentEntry) => string;
+declare const formatSearchResults: (results: TreeuiSearchResult[]) => string;
+declare const formatRecipeResults: (results: TreeuiRecipeSearchResult[]) => string;
+declare const formatSetupGuide: (componentName?: string) => string;
+
+declare const buildCatalogFromRepo: (repoRoot: string) => TreeuiCatalog;
+declare const getRepoRootFromPackageRoot: (packageRoot: string) => string;
+
+declare const createTreeuiMcpServer: () => Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>;
+
+export { type TreeuiCatalog, type TreeuiCatalogField, type TreeuiComponentEntry, type TreeuiDecisionGuide, type TreeuiRecipe, type TreeuiSearchResult, type TreeuiSetupEntry, buildCatalogFromRepo, catalog, createTreeuiMcpServer, findComponent, formatComponentSummary, formatRecipeResults, formatSearchResults, formatSetupGuide, getRepoRootFromPackageRoot, recommendComponents, searchComponents, searchRecipes };

package/dist/index.js

@@ -0,0 +1,372 @@
+import {
+  catalog,
+  createTreeuiMcpServer,
+  findComponent,
+  formatComponentSummary,
+  formatRecipeResults,
+  formatSearchResults,
+  formatSetupGuide,
+  recommendComponents,
+  searchComponents,
+  searchRecipes
+} from "./chunk-SNF26WKA.js";
+
+// src/catalog-source.ts
+import fs from "fs";
+import path from "path";
+import { parseAllDocuments } from "yaml";
+var readText = (filePath) => fs.readFileSync(filePath, "utf8");
+var normalizeWhitespace = (value) => value.replace(/\s+/g, " ").trim();
+var stringifyValue = (value) => {
+  if (value === void 0 || value === null) {
+    return void 0;
+  }
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  return JSON.stringify(value);
+};
+var normalizeStringList = (value) => {
+  if (value === void 0 || value === null) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => normalizeStringList(item));
+  }
+  if (typeof value === "string") {
+    return [value];
+  }
+  if (typeof value === "object") {
+    return Object.entries(value).map(
+      ([key, entryValue]) => normalizeWhitespace(`${key}: ${stringifyValue(entryValue) ?? ""}`)
+    );
+  }
+  return [String(value)];
+};
+var normalizeComponentName = (rawName) => {
+  if (typeof rawName !== "string" || !rawName.trim()) {
+    return void 0;
+  }
+  const value = rawName.trim();
+  if (value.startsWith("T")) {
+    return value;
+  }
+  if (value.startsWith("Tree")) {
+    return `T${value.slice(4)}`;
+  }
+  return `T${value}`;
+};
+var normalizeSourceFile = (rawValue) => {
+  if (typeof rawValue !== "string" || !rawValue.trim()) {
+    return void 0;
+  }
+  if (rawValue.startsWith("packages/")) {
+    return rawValue;
+  }
+  if (rawValue.endsWith(".vue")) {
+    return `packages/vue/src/components/${rawValue}`;
+  }
+  return rawValue;
+};
+var normalizeFieldMap = (value) => {
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (entry) => typeof entry === "string" ? { name: entry } : {
+        name: stringifyValue(entry.name) ?? "unnamed",
+        type: stringifyValue(entry.type),
+        description: stringifyValue(entry.description)
+      }
+    );
+  }
+  if (typeof value !== "object") {
+    return [];
+  }
+  return Object.entries(value).map(([name, entry]) => {
+    if (typeof entry === "string") {
+      return { name, description: entry };
+    }
+    if (Array.isArray(entry)) {
+      return { name, values: entry.map((item) => String(item)) };
+    }
+    const record = entry ?? {};
+    const values = Array.isArray(record.values) ? record.values.map((item) => String(item)) : void 0;
+    return {
+      name,
+      type: stringifyValue(record.type),
+      required: typeof record.required === "boolean" ? record.required : void 0,
+      default: stringifyValue(record.default),
+      values,
+      description: stringifyValue(record.description),
+      note: stringifyValue(record.note),
+      payload: stringifyValue(record.payload)
+    };
+  });
+};
+var normalizeEventList = (value) => {
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (entry) => typeof entry === "string" ? { name: entry } : {
+        name: stringifyValue(entry.name) ?? "unnamed",
+        description: stringifyValue(entry.description),
+        payload: stringifyValue(entry.payload)
+      }
+    );
+  }
+  if (typeof value !== "object") {
+    return [];
+  }
+  return Object.entries(value).map(([name, entry]) => {
+    if (typeof entry === "string") {
+      return { name, description: entry };
+    }
+    const record = entry ?? {};
+    return {
+      name,
+      description: stringifyValue(record.description),
+      payload: stringifyValue(record.payload)
+    };
+  });
+};
+var normalizeSlotList = (value) => {
+  if (!value) {
+    return [];
+  }
+  if (Array.isArray(value)) {
+    return value.map(
+      (entry) => typeof entry === "string" ? { name: entry } : {
+        name: stringifyValue(entry.name) ?? "unnamed",
+        description: stringifyValue(entry.description),
+        note: stringifyValue(entry.bindings)
+      }
+    );
+  }
+  if (typeof value !== "object") {
+    return [];
+  }
+  return Object.entries(value).map(([name, entry]) => {
+    if (typeof entry === "string") {
+      return { name, description: entry };
+    }
+    const record = entry ?? {};
+    return {
+      name,
+      description: stringifyValue(record.description),
+      note: stringifyValue(record.bindings)
+    };
+  });
+};
+var normalizeSelectionProfile = (value) => {
+  const record = value ?? {};
+  const alternatives = Array.isArray(record.alternatives) ? record.alternatives.map((entry) => {
+    const alternative = entry;
+    const component = stringifyValue(alternative.component);
+    const when = stringifyValue(alternative.when);
+    if (!component || !when) {
+      return void 0;
+    }
+    return { component, when };
+  }).filter((entry) => Boolean(entry)) : [];
+  return {
+    keywords: normalizeStringList(record.keywords),
+    useWhen: normalizeStringList(record.use_when),
+    avoidWhen: normalizeStringList(record.avoid_when),
+    alternatives
+  };
+};
+var normalizeSetupEntry = (value) => {
+  const record = value ?? {};
+  return {
+    required: normalizeStringList(record.required),
+    notes: normalizeStringList(record.notes)
+  };
+};
+var normalizeDecisionGuides = (value) => {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map((guide) => {
+    const record = guide;
+    const options = Array.isArray(record.options) ? record.options.map((option) => {
+      const optionRecord = option;
+      return {
+        use: String(optionRecord.use),
+        when: normalizeStringList(optionRecord.when),
+        notes: normalizeStringList(optionRecord.notes)
+      };
+    }) : [];
+    return {
+      id: String(record.id),
+      question: String(record.question),
+      options
+    };
+  });
+};
+var normalizeRecipes = (value) => {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map((recipe) => {
+    const record = recipe;
+    return {
+      id: String(record.id),
+      name: String(record.name),
+      useWhen: normalizeStringList(record.use_when),
+      compose: normalizeStringList(record.compose),
+      notes: normalizeStringList(record.notes)
+    };
+  });
+};
+var loadYamlDocuments = (filePath) => parseAllDocuments(readText(filePath)).map((document) => document.toJSON()).filter((document) => Boolean(document));
+var buildStoryIndex = (repoRoot) => {
+  const storiesDir = path.join(repoRoot, "apps/docs/src/stories");
+  const index = /* @__PURE__ */ new Map();
+  for (const fileName of fs.readdirSync(storiesDir)) {
+    if (!fileName.endsWith(".stories.ts")) {
+      continue;
+    }
+    const filePath = path.join(storiesDir, fileName);
+    const source = readText(filePath);
+    const componentMatch = source.match(/component:\s*(T[A-Za-z0-9]+)/);
+    if (!componentMatch) {
+      continue;
+    }
+    const componentName = componentMatch[1];
+    const titleMatch = source.match(/title:\s*'([^']+)'/);
+    const storyTitle = titleMatch?.[1];
+    const titleParts = storyTitle?.split("/") ?? [];
+    const category = titleParts.length > 2 ? titleParts.slice(1, -1).join(" / ") : titleParts[1];
+    index.set(componentName, {
+      storyFile: path.relative(repoRoot, filePath),
+      storyTitle,
+      category
+    });
+  }
+  return index;
+};
+var buildCatalogFromRepo = (repoRoot) => {
+  const docsDir = path.join(repoRoot, "docs/ai");
+  const componentsDir = path.join(docsDir, "COMPONENTS");
+  const storyIndex = buildStoryIndex(repoRoot);
+  const vuePackage = JSON.parse(
+    readText(path.join(repoRoot, "packages/vue/package.json"))
+  );
+  const selectionDoc = loadYamlDocuments(path.join(docsDir, "SELECTION.yaml"))[0] ?? {};
+  const setupDoc = loadYamlDocuments(path.join(docsDir, "SETUP.yaml"))[0] ?? {};
+  const recipesDoc = loadYamlDocuments(path.join(docsDir, "RECIPES.yaml"))[0] ?? {};
+  const contractsDoc = loadYamlDocuments(path.join(docsDir, "CONTRACTS.yaml"))[0] ?? {};
+  const componentProfiles = selectionDoc.component_profiles ?? {};
+  const componentSetup = setupDoc.component_setup ?? {};
+  const aliasMap = contractsDoc.compatibility_aliases ?? {};
+  const recipes = normalizeRecipes(recipesDoc.recipes);
+  const components = fs.readdirSync(componentsDir).filter((fileName) => fileName.endsWith(".yaml")).flatMap((fileName) => {
+    const filePath = path.join(componentsDir, fileName);
+    return loadYamlDocuments(filePath).flatMap((document) => {
+      const name = normalizeComponentName(document.name ?? document.component);
+      if (!name) {
+        return [];
+      }
+      const story = storyIndex.get(name);
+      const selection = normalizeSelectionProfile(componentProfiles[name]);
+      const setup2 = normalizeSetupEntry(componentSetup[name]);
+      const aliases = Array.from(
+        new Set(
+          [
+            ...normalizeStringList(document.aliases),
+            aliasMap[name],
+            name.startsWith("T") ? `Tree${name.slice(1)}` : void 0
+          ].filter((value) => Boolean(value))
+        )
+      );
+      const componentRecipes = recipes.filter((recipe) => recipe.compose.includes(name)).map((recipe) => recipe.id);
+      const entry = {
+        name,
+        legacyAlias: aliasMap[name] ?? aliases.find((alias) => alias.startsWith("Tree")),
+        aliases,
+        package: stringifyValue(document.package) ?? vuePackage.name,
+        kind: stringifyValue(document.kind),
+        category: story?.category,
+        status: stringifyValue(document.status),
+        description: stringifyValue(document.description),
+        purpose: stringifyValue(document.purpose),
+        sourceFile: normalizeSourceFile(document.source_file ?? document.source ?? document.provider_source_file),
+        storyFile: story?.storyFile,
+        storyTitle: story?.storyTitle,
+        manifestFile: path.relative(repoRoot, filePath),
+        props: normalizeFieldMap(document.props),
+        events: normalizeEventList(document.events ?? document.toast_events),
+        slots: normalizeSlotList(document.slots),
+        a11y: normalizeStringList(document.a11y ?? document.accessibility),
+        behavior: normalizeStringList(document.behavior),
+        selection,
+        setup: setup2,
+        recipes: componentRecipes
+      };
+      return [entry];
+    });
+  }).sort((left, right) => left.name.localeCompare(right.name));
+  const setup = {
+    install: {
+      packageManagerExamples: (setupDoc.install ?? {}).package_manager_examples,
+      requiredImports: normalizeStringList(
+        (setupDoc.install ?? {}).required_imports
+      )
+    },
+    vueSetup: {
+      pluginInstall: {
+        import: String((setupDoc.vue_setup ?? {}).plugin_install.import),
+        usage: String((setupDoc.vue_setup ?? {}).plugin_install.usage)
+      },
+      individualImports: {
+        import: String((setupDoc.vue_setup ?? {}).individual_imports.import)
+      },
+      guidance: normalizeStringList((setupDoc.vue_setup ?? {}).guidance)
+    },
+    globalRules: normalizeStringList(setupDoc.global_rules),
+    componentSetup: Object.fromEntries(
+      Object.keys(componentSetup).map((name) => [name, normalizeSetupEntry(componentSetup[name])])
+    ),
+    appPatterns: {
+      providers: Array.isArray((setupDoc.app_patterns ?? {}).providers) ? (setupDoc.app_patterns ?? {}).providers.map((entry) => ({
+        component: String(entry.component),
+        placement: String(entry.placement),
+        reason: String(entry.reason)
+      })) : [],
+      commonCompositions: normalizeStringList(
+        (setupDoc.app_patterns ?? {}).common_compositions
+      )
+    }
+  };
+  return {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    packageName: vuePackage.name,
+    packageVersion: vuePackage.version,
+    decisionGuides: normalizeDecisionGuides(selectionDoc.decision_guides),
+    recipes,
+    setup,
+    components
+  };
+};
+var getRepoRootFromPackageRoot = (packageRoot) => path.resolve(packageRoot, "../..");
+export {
+  buildCatalogFromRepo,
+  catalog,
+  createTreeuiMcpServer,
+  findComponent,
+  formatComponentSummary,
+  formatRecipeResults,
+  formatSearchResults,
+  formatSetupGuide,
+  getRepoRootFromPackageRoot,
+  recommendComponents,
+  searchComponents,
+  searchRecipes
+};