@rio-cloud/uikit-mcp 1.0.0

package/server/lib/search-index.mjs

@@ -0,0 +1,49 @@
+import FlexSearch from 'flexsearch';
+
+/**
+ * Build a FlexSearch document index keyed by doc id.
+ * @param {Map<string, UiKitDoc>} docs
+ * @returns {FlexSearch.Document}
+ */
+export function buildSearchIndex(docs) {
+  const index = new FlexSearch.Document({
+    document: {
+      id: 'id',
+      index: [
+        { field: 'title', tokenize: 'forward' },
+        { field: 'lead', tokenize: 'forward' },
+        { field: 'summary', tokenize: 'forward' },
+        { field: 'searchText', tokenize: 'forward' },
+        { field: 'boost', tokenize: 'forward' }
+      ],
+      store: ['id', 'title', 'summary', 'route', 'category', 'section']
+    },
+    tokenize: 'forward'
+  });
+
+  for (const doc of docs.values()) {
+    const boost = [
+      doc.title ?? '',
+      doc.id ?? '',
+      doc.route ?? '',
+      doc.category ?? '',
+      doc.section ?? ''
+    ]
+      .filter(Boolean)
+      .join(' ');
+
+    index.add({
+      id: doc.id,
+      title: doc.title ?? doc.id,
+      summary: doc.summary,
+      searchText: doc.searchText,
+      lead: doc.lead ?? '',
+      route: doc.route,
+      category: doc.category ?? '',
+      section: doc.section ?? '',
+      boost
+    });
+  }
+
+  return index;
+}

package/server/lib/types.js

@@ -0,0 +1,99 @@
+/**
+ * Raw content schema emitted by the Playwright capture scripts.
+ *
+ * @typedef {Object} RawDoc
+ * @property {{ captured_at: string, source: string, category: string | null, section: string | null, slug: string }} metadata
+ * @property {string | null} [title]
+ * @property {string | null} [lead]
+ * @property {Array<RawDocSection>} content
+ * @property {Array<{ label: string, href: string }>} [see_also]
+ */
+
+/**
+ * @typedef {Object} RawDocSection
+ * @property {string} heading
+ * @property {string} [body]
+ * @property {Array<RawDocExample>} examples
+ */
+
+/**
+ * @typedef {Object} RawDocExample
+ * @property {string | null} caption
+ * @property {string} rendered_html
+ * @property {Array<RawDocTab>} tabs
+ */
+
+/**
+ * @typedef {Object} RawDocTab
+ * @property {string} label
+ * @property {string} language
+ * @property {string | null} [code]
+ * @property {Array<RawPropsTable>} [props]
+ */
+
+/**
+ * @typedef {Object} RawPropsTable
+ * @property {string | null} heading
+ * @property {Array<RawPropRow>} rows
+ */
+
+/**
+ * @typedef {Object} RawPropRow
+ * @property {string} name
+ * @property {string} type
+ * @property {string} default
+ * @property {string} description
+ */
+
+/**
+ * Normalised record consumed by the MCP server.
+ *
+ * @typedef {Object} UiKitDoc
+ * @property {string} id              Identifier used by MCP (e.g. `components/button`)
+ * @property {string} route           Hash route fragment (e.g. `#components/button`)
+ * @property {string | null} category Top navigation label
+ * @property {string | null} section  Sidebar section label
+ * @property {string | null} title    Main heading
+ * @property {string | null} lead     Introductory copy
+ * @property {Array<UiKitSection>} sections
+ * @property {Array<{ label: string, href: string }>} seeAlso
+ * @property {string} sourceUrl
+ * @property {string} capturedAt
+ * @property {string} slug
+ * @property {string} summary         First non-empty paragraph or fallback text
+ * @property {string} searchText      Aggregated text (title + lead + sections + props)
+ */
+
+/**
+ * @typedef {Object} UiKitSection
+ * @property {string} heading
+ * @property {string} bodyMarkdown
+ * @property {string} bodyPlainText
+ * @property {Array<UiKitExample>} examples
+ */
+
+/**
+ * @typedef {Object} UiKitExample
+ * @property {string} caption
+ * @property {string} html
+ * @property {string} plainText
+ * @property {Array<UiKitCodeTab>} codeTabs
+ * @property {Array<UiKitPropsTable>} propsTables
+ */
+
+/**
+ * @typedef {Object} UiKitCodeTab
+ * @property {string} label
+ * @property {string} language
+ * @property {string} code
+ */
+
+/**
+ * @typedef {Object} UiKitPropsTable
+ * @property {string | null} heading
+ * @property {Array<RawPropRow>} rows
+ * @property {string} markdown
+ */
+
+export {};
+