@mindfiredigital/ignix-lite-mcp 1.0.0 → 1.2.0

package/package.json

@@ -1,24 +1,38 @@
 {
   "name": "@mindfiredigital/ignix-lite-mcp",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "",
   "type": "module",
   "main": "index.js",
+  "scripts": {
+    "test": "vitest run",
+    "dev": "tsup src/server.ts --watch --format esm --no-clean --onSuccess \"copyfiles -u 2 src/manifests/*.json dist/manifests\"",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "build": "tsup && copyfiles -u 2 src/manifests/*.json dist/manifests && pnpm build:index",
+    "build:index": "tsx src/tools/build-index.ts"
+  },
   "keywords": [],
   "author": "",
   "license": "ISC",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
   "devDependencies": {
-    "tsup": "^8.5.1",
-    "vitest": "^4.1.4",
+    "@types/node": "^25.6.0",
+    "copyfiles": "^2.4.1",
     "eslint": "^10.2.0",
     "prettier": "^3.8.3",
-    "typescript": "^5.4.5"
+    "tiktoken": "^1.0.22",
+    "tsup": "^8.5.1",
+    "typescript": "^5.4.5",
+    "vitest": "^4.1.4"
   },
-  "scripts": {
-    "test": "vitest run",
-    "dev": "tsup src/server.ts --watch",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "build": "tsup"
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "emmet": "^2.4.11",
+    "node-html-parser": "^7.1.0",
+    "zod": "^4.4.3"
   }
-}
+}

package/src/context/api-context.ts

@@ -0,0 +1,14 @@
+import { readFileSync, existsSync } from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Dynamically handle both bundled dist/ and source src/context/ contexts
+let apiPath = path.resolve(__dirname, '../../../api-full.txt')
+if (!existsSync(apiPath)) {
+  apiPath = path.resolve(__dirname, '../../../../api-full.txt')
+}
+
+export const apiContext = readFileSync(apiPath, 'utf8')

package/src/global.d.ts

@@ -0,0 +1,15 @@
+declare module 'emmet' {
+  export default function expand(
+    abbr: string,
+    config?: Record<string, unknown>
+  ): string
+  export function markup(abbr: string, config: Record<string, unknown>): string
+  export function stylesheet(
+    abbr: string,
+    config: Record<string, unknown>
+  ): string
+  export function resolveConfig(
+    config: Record<string, unknown>
+  ): Record<string, unknown>
+  export const stringifyMarkup: (node: unknown) => string
+}

package/src/manifests/accordion.json

@@ -0,0 +1,61 @@
+{
+  "component": "accordion",
+  "version": "2.0",
+
+  "description": "Displays expandable content sections using native HTML details and summary elements. Works without JavaScript and is accessible by default.",
+
+  "element": "details",
+
+  "emmet": "details[open?]>summary{title}+p{content}",
+  
+
+  "props": {
+    "open": {
+      "type": "boolean",
+      "native": true,
+      "agent_hint": "Use open to keep accordion expanded by default."
+    }
+  },
+
+  "states": ["open"],
+
+  "forbidden_props": ["expanded", "isOpen", "collapsed", "variant", "class"],
+
+  "required_props": [],
+
+  "required_slots": [],
+
+  "required_children": ["summary"],
+
+  "do": [
+    "Use summary as the accordion trigger",
+    "Use open to expand by default",
+    "Use native details element for accessibility"
+  ],
+
+  "dont": [
+    "Do not replace details with div",
+    "Do not use JavaScript for open state",
+    "Do not use class attribute"
+  ],
+
+  "examples": [
+    {
+      "label": "Default accordion",
+      "emmet": "details>summary{What is ignix-lite?}+p{Lightweight semantic UI library}",
+      "html": "<details><summary>What is ignix-lite?</summary><p>Lightweight semantic UI library</p></details>"
+    },
+
+    {
+      "label": "Open by default",
+      "emmet": "details[open]>summary{How does this work?}+p{Uses native browser behavior}",
+      "html": "<details open><summary>How does this work?</summary><p>Uses native browser behavior</p></details>"
+    },
+
+    {
+      "label": "FAQ item",
+      "emmet": "details>summary{Does it require JS?}+p{No, it works without JavaScript}",
+      "html": "<details><summary>Does it require JS?</summary><p>No, it works without JavaScript</p></details>"
+    }
+  ]
+}

package/src/manifests/alert.json

@@ -0,0 +1,69 @@
+{
+  "component": "alert",
+  "version": "2.0",
+
+  "description": "Displays semantic feedback messages using native <aside> element for warnings, errors, success messages, and informational updates.",
+
+  "element": "aside",
+
+  "emmet": "aside[data-intent=?]{message}",
+  
+
+  "props": {
+    "data-intent": {
+      "type": "enum",
+      "values": ["danger", "warning", "success", "info"],
+      "default": "info",
+      "native": false,
+      "agent_hint": "Use danger for errors, warning for cautions, success for confirmations, info for updates."
+    }
+  },
+
+  "states": [],
+
+  "forbidden_props": [
+    "variant",
+    "color",
+    "appearance",
+    "colorScheme",
+    "severity",
+    "status",
+    "class"
+  ],
+
+  "required_props": [],
+
+  "required_slots": [],
+
+  "do": [
+    "Use data-intent='danger' for error states",
+    "Use data-intent='warning' for caution messages",
+    "Use native aside element for semantic alerts"
+  ],
+
+  "dont": [
+    "Do not use div instead of aside",
+    "Do not use variant or severity props",
+    "Do not use class attribute"
+  ],
+
+  "examples": [
+    {
+      "label": "Danger alert",
+      "emmet": "aside[data-intent=danger]{Something went wrong}",
+      "html": "<aside data-intent=\"danger\">Something went wrong</aside>"
+    },
+
+    {
+      "label": "Warning alert",
+      "emmet": "aside[data-intent=warning]{Session expires soon}",
+      "html": "<aside data-intent=\"warning\">Session expires soon</aside>"
+    },
+
+    {
+      "label": "Success alert",
+      "emmet": "aside[data-intent=success]{Saved successfully}",
+      "html": "<aside data-intent=\"success\">Saved successfully</aside>"
+    }
+  ]
+}

package/src/manifests/avatar.json

@@ -0,0 +1,75 @@
+{
+  "component": "avatar",
+  "version": "2.0",
+
+  "description": "Displays user profile visuals using native img element with text fallback support through span. Supports multiple sizes and loading skeletons.",
+
+  "element": "img | span",
+
+  "emmet": "img[src=? alt=? data-size=?]",
+ 
+
+  "props": {
+    "data-size": {
+      "type": "enum",
+      "values": ["sm", "md", "lg"],
+      "default": "md",
+      "native": false,
+      "agent_hint": "Use sm for compact lists, md for profile previews, lg for detailed cards."
+    },
+
+    "src": {
+      "type": "string",
+      "native": true,
+      "agent_hint": "Image URL for avatar image."
+    },
+
+    "alt": {
+      "type": "string",
+      "native": true,
+      "agent_hint": "Always provide descriptive alt text for accessibility."
+    }
+  },
+
+  "states": ["loading"],
+
+  "forbidden_props": ["size", "variant", "shape", "rounded", "class"],
+
+  "required_props": [],
+
+  "required_slots": [],
+
+  "fallback_element": "span",
+
+  "do": [
+    "Use img for avatar images",
+    "Use span fallback for initials",
+    "Always provide alt text on images"
+  ],
+
+  "dont": [
+    "Do not use class attribute",
+    "Do not use size prop instead of data-size",
+    "Do not omit alt attribute on img"
+  ],
+
+  "examples": [
+    {
+      "label": "Small avatar",
+      "emmet": "img[src=? alt=User data-size=sm]",
+      "html": "<img src=\"https://picsum.photos/100\" alt=\"User\" data-size=\"sm\">"
+    },
+
+    {
+      "label": "Medium avatar",
+      "emmet": "img[src=? alt=Sarah data-size=md]",
+      "html": "<img src=\"https://picsum.photos/100\" alt=\"Sarah\" data-size=\"md\">"
+    },
+
+    {
+      "label": "Fallback initials",
+      "emmet": "span[data-size=md]{JD}",
+      "html": "<span data-size=\"md\">JD</span>"
+    }
+  ]
+}

package/src/manifests/badge.json

@@ -0,0 +1,74 @@
+{
+  "component": "badge",
+  "version": "2.0",
+  "description": "Status indicator using mark or span[role=status] with intent styling.",
+
+  "element": "badge",
+
+  "emmet": "mark[data-intent=?]{Label}",
+  "tokens": 3,
+
+  "props": {
+    "data-intent": {
+      "type": "enum",
+      "values": ["success", "danger", "warning", "neutral"],
+      "default": "neutral",
+      "native": false,
+      "agent_hint": "Controls badge color"
+    },
+
+    "role": {
+      "type": "enum",
+      "values": ["status"],
+      "native": true,
+      "agent_hint": "Required when using span"
+    }
+  },
+
+  "allowed_elements": ["mark", "span"],
+
+  "required_conditions": ["span must have role=status"],
+
+  "states": [],
+
+  "required_props": [],
+
+  "forbidden_props": ["class", "variant", "color", "style", "onclick"],
+
+  "do": [
+    "Use mark for standard badges",
+    "Use span with role=status for accessibility cases",
+    "Use data-intent to convey meaning",
+    "Keep text short"
+  ],
+
+  "dont": [
+    "Do not use class attribute",
+    "Do not use variant or color props",
+    "Do not attach JS handlers",
+    "Do not use span without role=status"
+  ],
+
+  "examples": [
+    {
+      "label": "Basic badge",
+      "emmet": "mark[data-intent=neutral]{Active}",
+      "html": "<mark data-intent=\"neutral\">Active</mark>"
+    },
+    {
+      "label": "Success badge",
+      "emmet": "mark[data-intent=success]{Active}",
+      "html": "<mark data-intent=\"success\">Active</mark>"
+    },
+    {
+      "label": "Danger badge",
+      "emmet": "mark[data-intent=danger]{Error}",
+      "html": "<mark data-intent=\"danger\">Error</mark>"
+    },
+    {
+      "label": "Status badge",
+      "emmet": "span[role=status data-intent=success]{Active}",
+      "html": "<span role=\"status\" data-intent=\"success\">Active</span>"
+    }
+  ]
+}

package/src/manifests/breadcrumb.json

@@ -0,0 +1,87 @@
+{
+  "component": "breadcrumb",
+  "version": "2.0",
+  "description": "Displays hierarchical navigation path using native nav > ol > li > a structure.",
+
+  "element": "nav",
+
+  "emmet": "nav[aria-label=Breadcrumb]>ol>(li>a[href=?])*3",
+
+  "props": {
+    "data-style": {
+      "type": "enum",
+
+      "values": ["chevron", "slash", "guillemet", "arrow", "thread", "pipe"],
+
+      "default": "chevron",
+      "native": false,
+      "agent_hint": "Controls breadcrumb separator style."
+    },
+
+    "data-intent": {
+      "type": "enum",
+
+      "values": ["primary", "success", "warning", "danger", "gradient"],
+
+      "default": "primary",
+      "native": false,
+      "agent_hint": "Controls active breadcrumb color intent."
+    },
+
+    "aria-label": {
+      "type": "string",
+      "native": true,
+      "required": true,
+      "agent_hint": "Use aria-label='Breadcrumb' for accessibility."
+    }
+  },
+
+  "states": [],
+  "slots": {},
+
+  "forbidden_props": [
+    "variant",
+    "color",
+    "appearance",
+    "separator",
+    "items",
+    "activeItem",
+    "class"
+  ],
+
+  "required_props": ["aria-label"],
+
+  "required_slots": [],
+
+  "do": [
+    "Use nav as breadcrumb container",
+    "Use ordered list structure",
+    "Mark current page using aria-current='page'"
+  ],
+
+  "dont": [
+    "Do not use class attribute",
+    "Do not replace nav with div",
+    "Do not pass breadcrumb items as props"
+  ],
+
+  "examples": [
+    {
+      "label": "Default breadcrumb",
+      "emmet": "nav[aria-label=Breadcrumb]>ol>(li>a[href=?])*3",
+      "html": "<nav aria-label=\"Breadcrumb\"><ol><li><a href=\"#\">Home</a></li><li><a href=\"#\">Docs</a></li><li><a aria-current=\"page\">Breadcrumb</a></li></ol></nav>"
+    },
+
+    {
+      "label": "Slash style",
+      "emmet": "nav[aria-label=Breadcrumb data-style=slash]>ol>(li>a[href=?])*3",
+      "html": "<nav aria-label=\"Breadcrumb\" data-style=\"slash\"></nav>"
+    },
+
+    {
+      "label": "Danger intent",
+      "emmet": "nav[aria-label=Breadcrumb data-intent=danger]>ol>(li>a[href=?])*3",
+      "html": "<nav aria-label=\"Breadcrumb\" data-intent=\"danger\"></nav>"
+    }
+  ]
+}

package/src/manifests/button.json

@@ -0,0 +1,85 @@
+{
+  "component": "button",
+  "version": "2.0",
+  "description": "Triggers an action. Renders as native <button>.",
+
+  "element": "button",
+
+  "emmet": "button[data-intent=?]{label}",
+  
+
+  "props": {
+    "data-intent": {
+      "type": "enum",
+      "values": ["primary", "danger", "warning", "success", "neutral", "ghost"],
+      "default": "primary",
+      "native": false,
+      "agent_hint": "Use danger for destructive actions. Use ghost for secondary actions."
+    },
+
+    "disabled": {
+      "type": "boolean",
+      "native": true,
+      "agent_hint": "Use native disabled attribute"
+    },
+
+    "aria-busy": {
+      "type": "boolean",
+      "native": true,
+      "agent_hint": "Use for loading state"
+    },
+
+    "type": {
+      "type": "enum",
+      "values": ["button", "submit", "reset"],
+      "default": "button",
+      "native": true
+    }
+  },
+
+  "states": ["disabled", "aria-busy"],
+
+  "forbidden_props": [
+    "variant",
+    "color",
+    "appearance",
+    "colorScheme",
+    "isLoading",
+    "isDisabled",
+    "size",
+    "class"
+  ],
+
+  "required_props": [],
+  "required_slots": [],
+
+  "do": [
+    "Use data-intent='danger' for destructive actions",
+    "Use aria-busy='true' for loading state",
+    "Use type='submit' inside forms"
+  ],
+
+  "dont": [
+    "Do not use class attribute",
+    "Do not use variant or color props",
+    "Do not use isLoading or isDisabled"
+  ],
+
+  "examples": [
+    {
+      "label": "Primary button",
+      "emmet": "button[data-intent=primary]{Save}",
+      "html": "<button data-intent=\"primary\">Save</button>"
+    },
+    {
+      "label": "Danger button",
+      "emmet": "button[data-intent=danger]{Delete}",
+      "html": "<button data-intent=\"danger\">Delete</button>"
+    },
+    {
+      "label": "Loading button",
+      "emmet": "button[aria-busy=true]{Saving...}",
+      "html": "<button aria-busy=\"true\">Saving...</button>"
+    }
+  ]
+}

package/src/manifests/card.json

@@ -0,0 +1,91 @@
+{
+  "component": "card",
+  "version": "2.0",
+  "description": "Displays structured content using semantic slots for avatar, title, metadata, body, actions, and footer. Renders as native article element.",
+
+  "element": "article",
+
+  "emmet": "article>(img[slot=avatar])+(span[slot=title])+(p[slot=body])",
+  
+
+  "props": {},
+
+  "states": [],
+
+  "slots": {
+    "avatar": {
+      "required": false,
+
+      "element": ["img", "span"],
+
+      "agent_hint": "Avatar image or visual content."
+    },
+
+    "title": {
+      "required": true,
+
+      "element": ["span", "h1", "h2", "h3"],
+
+      "agent_hint": "Primary card heading."
+    },
+
+    "meta": {
+      "required": false,
+
+      "element": ["span", "small"],
+
+      "agent_hint": "Subtitle or metadata."
+    },
+
+    "body": {
+      "required": true,
+
+      "element": ["p"],
+
+      "agent_hint": "Main content area."
+    },
+
+    "action": {
+      "required": false,
+
+      "element": ["button", "a"],
+
+      "agent_hint": "Primary action area."
+    },
+
+    "footer": {
+      "required": false,
+
+      "element": ["span", "small"],
+
+      "agent_hint": "Footer metadata."
+    }
+  },
+
+  "forbidden_props": [
+    "title",
+    "subtitle",
+    "avatar",
+    "image",
+    "body",
+    "footer",
+    "actionLabel",
+    "class"
+  ],
+
+  "required_props": [],
+
+  "required_slots": ["title", "body"],
+
+  "do": [
+    "Use slot attributes for content placement",
+    "Use article as card container",
+    "Place actions inside slot='action'"
+  ],
+
+  "dont": [
+    "Do not pass title or body as props",
+    "Do not replace slots with attributes",
+    "Do not use class attribute"
+  ]
+}