trueicon 0.1.0

package/dist/providers/jsLiteral.d.ts

@@ -0,0 +1,20 @@
+export type JsValue = string | number | boolean | null | JsValue[] | {
+    [key: string]: JsValue;
+};
+export declare class LiteralCursor {
+    readonly src: string;
+    pos: number;
+    constructor(src: string, pos?: number);
+    skipWs(): void;
+    peek(): string | undefined;
+    eat(token: string): boolean;
+    expect(token: string): void;
+    fail(message: string): never;
+    identifier(): string;
+    string(): string;
+    value(): JsValue;
+    array(): JsValue[];
+    object(): {
+        [key: string]: JsValue;
+    };
+}

package/dist/providers/jsLiteral.js

@@ -0,0 +1,137 @@
+/*
+ * Minimal reader for the JavaScript literals found in compiled icon modules: strings,
+ * numbers, booleans, null, arrays and objects with bare or quoted keys. It is not a general
+ * JS parser; it only needs to cover what icon build tools emit, and throws on anything else.
+ */
+const IDENTIFIER = /[A-Za-z_$][\w$]*/y;
+const NUMBER = /-?(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?/y;
+export class LiteralCursor {
+    src;
+    pos;
+    constructor(src, pos = 0) {
+        this.src = src;
+        this.pos = pos;
+    }
+    // Skips whitespace and comments (including /*#__PURE__*/ annotations).
+    skipWs() {
+        for (;;) {
+            while (this.pos < this.src.length && /\s/.test(this.src[this.pos]))
+                this.pos++;
+            if (this.src.startsWith("/*", this.pos)) {
+                const end = this.src.indexOf("*/", this.pos + 2);
+                this.pos = end < 0 ? this.src.length : end + 2;
+            }
+            else if (this.src.startsWith("//", this.pos)) {
+                const end = this.src.indexOf("\n", this.pos);
+                this.pos = end < 0 ? this.src.length : end + 1;
+            }
+            else {
+                return;
+            }
+        }
+    }
+    peek() {
+        this.skipWs();
+        return this.src[this.pos];
+    }
+    // Consumes `token` if it comes next; returns whether it did.
+    eat(token) {
+        this.skipWs();
+        if (!this.src.startsWith(token, this.pos))
+            return false;
+        this.pos += token.length;
+        return true;
+    }
+    expect(token) {
+        if (!this.eat(token))
+            this.fail(`expected "${token}"`);
+    }
+    fail(message) {
+        const context = this.src.slice(this.pos, this.pos + 40);
+        throw new Error(`Parse error at offset ${this.pos}: ${message} (near ${JSON.stringify(context)})`);
+    }
+    identifier() {
+        this.skipWs();
+        IDENTIFIER.lastIndex = this.pos;
+        const match = IDENTIFIER.exec(this.src);
+        if (!match)
+            this.fail("expected identifier");
+        this.pos += match[0].length;
+        return match[0];
+    }
+    string() {
+        this.skipWs();
+        const quote = this.src[this.pos];
+        if (quote !== '"' && quote !== "'")
+            this.fail("expected string");
+        let out = "";
+        let i = this.pos + 1;
+        while (i < this.src.length && this.src[i] !== quote) {
+            if (this.src[i] === "\\") {
+                const next = this.src[i + 1];
+                if (next === "u") {
+                    out += String.fromCharCode(parseInt(this.src.slice(i + 2, i + 6), 16));
+                    i += 6;
+                    continue;
+                }
+                out += next === "n" ? "\n" : next === "t" ? "\t" : next === "r" ? "\r" : (next ?? "");
+                i += 2;
+            }
+            else {
+                out += this.src[i];
+                i++;
+            }
+        }
+        if (i >= this.src.length)
+            this.fail("unterminated string");
+        this.pos = i + 1;
+        return out;
+    }
+    value() {
+        const ch = this.peek();
+        if (ch === '"' || ch === "'")
+            return this.string();
+        if (ch === "[")
+            return this.array();
+        if (ch === "{")
+            return this.object();
+        NUMBER.lastIndex = this.pos;
+        const num = NUMBER.exec(this.src);
+        if (num) {
+            this.pos += num[0].length;
+            return Number(num[0]);
+        }
+        const word = this.identifier();
+        if (word === "true")
+            return true;
+        if (word === "false")
+            return false;
+        if (word === "null")
+            return null;
+        this.fail(`unsupported value "${word}"`);
+    }
+    array() {
+        this.expect("[");
+        const out = [];
+        while (!this.eat("]")) {
+            out.push(this.value());
+            if (!this.eat(",") && this.peek() !== "]")
+                this.fail('expected "," or "]"');
+        }
+        return out;
+    }
+    object() {
+        this.expect("{");
+        const out = {};
+        while (!this.eat("}")) {
+            const ch = this.peek();
+            const key = ch === '"' || ch === "'" ? this.string() : this.identifier();
+            this.expect(":");
+            out[key] = this.value();
+            if (!this.eat(",") && this.peek() !== "}")
+                this.fail('expected "," or "}"');
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=jsLiteral.js.map

package/dist/providers/jsLiteral.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsLiteral.js","sourceRoot":"","sources":["../../src/providers/jsLiteral.ts"],"names":[],"mappings":"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"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,9 @@
+export interface Provider {
+    /** Stable identifier used by trueicon tools. */
+    id: string;
+    /** npm package the icons are read from. */
+    package: string;
+    description: string;
+}
+export declare const PROVIDERS: readonly Provider[];
+export declare function getProvider(idOrPackage: string): Provider | undefined;

package/dist/providers/registry.js

@@ -0,0 +1,23 @@
+// Icon providers supported in v1.
+export const PROVIDERS = [
+    {
+        id: "react-icons",
+        package: "react-icons",
+        description: "Aggregated icon sets (Font Awesome, Material, Feather, and more) as React components",
+    },
+    {
+        id: "lucide",
+        package: "lucide-react",
+        description: "Lucide icons as React components",
+    },
+    {
+        id: "heroicons",
+        package: "@heroicons/react",
+        description: "Heroicons by the Tailwind CSS team as React components",
+    },
+];
+// Finds a provider by its id or by its npm package name.
+export function getProvider(idOrPackage) {
+    return PROVIDERS.find((p) => p.id === idOrPackage || p.package === idOrPackage);
+}
+//# sourceMappingURL=registry.js.map

package/dist/providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AAQA,kCAAkC;AAClC,MAAM,CAAC,MAAM,SAAS,GAAwB;IAC5C;QACE,EAAE,EAAE,aAAa;QACjB,OAAO,EAAE,aAAa;QACtB,WAAW,EAAE,sFAAsF;KACpG;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,OAAO,EAAE,cAAc;QACvB,WAAW,EAAE,kCAAkC;KAChD;IACD;QACE,EAAE,EAAE,WAAW;QACf,OAAO,EAAE,kBAAkB;QAC3B,WAAW,EAAE,wDAAwD;KACtE;CACF,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC7C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC;AAClF,CAAC"}

package/dist/providers/svg.d.ts

@@ -0,0 +1,9 @@
+import type { JsValue } from "./jsLiteral.js";
+export interface SvgNode {
+    tag: string;
+    attr: Record<string, string | number>;
+    child: SvgNode[];
+}
+export declare function svgAttrName(reactName: string): string;
+export declare function renderSvg(nodes: readonly SvgNode[]): string;
+export declare function toSvgAttrs(value: JsValue | undefined): Record<string, string | number>;

package/dist/providers/svg.js

@@ -0,0 +1,97 @@
+// SVG attributes whose names are camelCase in SVG itself, so React names must be kept as-is.
+const CASE_SENSITIVE_ATTRS = new Set([
+    "viewBox",
+    "preserveAspectRatio",
+    "baseProfile",
+    "pathLength",
+    "textLength",
+    "lengthAdjust",
+    "startOffset",
+    "spreadMethod",
+    "gradientUnits",
+    "gradientTransform",
+    "patternUnits",
+    "patternContentUnits",
+    "patternTransform",
+    "clipPathUnits",
+    "maskUnits",
+    "maskContentUnits",
+    "filterUnits",
+    "primitiveUnits",
+    "markerUnits",
+    "markerWidth",
+    "markerHeight",
+    "refX",
+    "refY",
+    "stdDeviation",
+    "baseFrequency",
+    "numOctaves",
+    "stitchTiles",
+    "kernelMatrix",
+    "kernelUnitLength",
+    "tableValues",
+    "surfaceScale",
+    "specularConstant",
+    "specularExponent",
+    "diffuseConstant",
+    "edgeMode",
+    "targetX",
+    "targetY",
+    "xChannelSelector",
+    "yChannelSelector",
+    "limitingConeAngle",
+    "pointsAtX",
+    "pointsAtY",
+    "pointsAtZ",
+    "attributeName",
+    "attributeType",
+    "repeatCount",
+    "calcMode",
+    "keyTimes",
+    "keySplines",
+]);
+const SPECIAL_ATTRS = {
+    className: "class",
+    xlinkHref: "xlink:href",
+    xmlnsXlink: "xmlns:xlink",
+    xmlSpace: "xml:space",
+};
+// React-only props that are not SVG attributes.
+const DROPPED_ATTRS = new Set(["key", "ref", "children"]);
+// Maps a React prop name (strokeWidth) to its SVG attribute name (stroke-width).
+export function svgAttrName(reactName) {
+    if (SPECIAL_ATTRS[reactName])
+        return SPECIAL_ATTRS[reactName];
+    if (CASE_SENSITIVE_ATTRS.has(reactName))
+        return reactName;
+    return reactName.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+function escapeAttr(value) {
+    return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
+}
+// Serializes nodes to SVG markup, e.g. [{tag: "path", attr: {d: "M0 0"}}] -> '<path d="M0 0"/>'.
+export function renderSvg(nodes) {
+    return nodes
+        .map((node) => {
+        const attrs = Object.entries(node.attr)
+            .filter(([name]) => !DROPPED_ATTRS.has(name))
+            .map(([name, value]) => ` ${svgAttrName(name)}="${escapeAttr(String(value))}"`)
+            .join("");
+        return node.child.length > 0
+            ? `<${node.tag}${attrs}>${renderSvg(node.child)}</${node.tag}>`
+            : `<${node.tag}${attrs}/>`;
+    })
+        .join("");
+}
+// Keeps only string/number attribute values from a parsed object literal.
+export function toSvgAttrs(value) {
+    const attrs = {};
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        for (const [key, v] of Object.entries(value)) {
+            if (typeof v === "string" || typeof v === "number")
+                attrs[key] = v;
+        }
+    }
+    return attrs;
+}
+//# sourceMappingURL=svg.js.map

package/dist/providers/svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.js","sourceRoot":"","sources":["../../src/providers/svg.ts"],"names":[],"mappings":"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"}

package/dist/search/search.d.ts

@@ -0,0 +1,26 @@
+import type { IconRecord, IndexMeta, Synonyms } from "../indexer/types.js";
+export interface LoadedIndex {
+    records: IconRecord[];
+    meta: IndexMeta;
+}
+export interface SearchOptions {
+    /** Exact (case-insensitive) provider id filter, e.g. "lucide". */
+    provider?: string;
+    /** Exact (case-insensitive) style filter, e.g. "outline". */
+    style?: string;
+    /** Exact (case-insensitive) set filter, e.g. "fa6". */
+    set?: string;
+    /** Maximum number of results, applied after ranking. */
+    limit?: number;
+}
+export interface SearchResult {
+    record: IconRecord;
+    /** Fuse.js score: 0 is a perfect match, 1 is no match. */
+    score: number;
+}
+/** Reads index.json and meta.json from an index directory written by writeIndex. */
+export declare function loadIndex(cacheDir: string): Promise<LoadedIndex>;
+/** True when an index was built with different synonyms or an older index format. */
+export declare function indexNeedsRebuild(meta: IndexMeta, synonyms: Synonyms): boolean;
+/** Filters records by provider/style/set exactly, then ranks them against the query with Fuse.js. */
+export declare function searchIcons(records: readonly IconRecord[], query: string, options?: SearchOptions): SearchResult[];

package/dist/search/search.js

@@ -0,0 +1,45 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import Fuse from "fuse.js";
+import { hashSynonyms, INDEX_FILE, INDEX_VERSION, META_FILE } from "../indexer/buildIndex.js";
+/** Reads index.json and meta.json from an index directory written by writeIndex. */
+export async function loadIndex(cacheDir) {
+    const [index, meta] = await Promise.all([
+        readFile(join(cacheDir, INDEX_FILE), "utf8"),
+        readFile(join(cacheDir, META_FILE), "utf8"),
+    ]);
+    return { records: JSON.parse(index), meta: JSON.parse(meta) };
+}
+/** True when an index was built with different synonyms or an older index format. */
+export function indexNeedsRebuild(meta, synonyms) {
+    return meta.indexVersion !== INDEX_VERSION || meta.synonymsHash !== hashSynonyms(synonyms);
+}
+const FUSE_OPTIONS = {
+    keys: [
+        { name: "name", weight: 3 },
+        { name: "importName", weight: 2 },
+        { name: "keywords", weight: 2 },
+        { name: "tags", weight: 1 },
+    ],
+    includeScore: true,
+    // Match anywhere in the field; 0.4 tolerates a couple of typos in short words ("detele" -> "delete").
+    ignoreLocation: true,
+    threshold: 0.4,
+    minMatchCharLength: 2,
+};
+function matches(value, filter) {
+    return filter === undefined || value?.toLowerCase() === filter.toLowerCase();
+}
+/** Filters records by provider/style/set exactly, then ranks them against the query with Fuse.js. */
+export function searchIcons(records, query, options = {}) {
+    const trimmed = query.trim();
+    if (!trimmed)
+        return [];
+    const { provider, style, set, limit } = options;
+    const filtered = records.filter((r) => matches(r.provider, provider) && matches(r.style, style) && matches(r.set, set));
+    const results = new Fuse(filtered, FUSE_OPTIONS)
+        .search(trimmed)
+        .map((result) => ({ record: result.item, score: result.score ?? 0 }));
+    return limit === undefined ? results : results.slice(0, Math.max(0, limit));
+}
+//# sourceMappingURL=search.js.map

package/dist/search/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/search/search.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const SERVER_NAME = "trueicon";
+export declare const SERVER_VERSION = "0.1.0";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,17 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerGetIconTool } from "./tools/getIcon.js";
+import { registerListProvidersTool } from "./tools/listProviders.js";
+import { registerPingTool } from "./tools/ping.js";
+import { registerSearchIconsTool } from "./tools/searchIcons.js";
+export const SERVER_NAME = "trueicon";
+export const SERVER_VERSION = "0.1.0";
+// Builds the MCP server with all tools registered. Transport wiring lives in index.ts.
+export function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    registerPingTool(server);
+    registerSearchIconsTool(server);
+    registerListProvidersTool(server);
+    registerGetIconTool(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,uFAAuF;AACvF,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAE7E,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAChC,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAClC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/synonyms/loadSynonyms.d.ts

@@ -0,0 +1,5 @@
+import type { Synonyms } from "../indexer/types.js";
+/** Checks that `value` is an object mapping lowercase terms to arrays of lowercase strings. */
+export declare function parseSynonyms(value: unknown): Synonyms;
+/** Loads the synonyms bundled with the package (src/synonyms/synonyms.json). */
+export declare function loadSynonyms(): Synonyms;

package/dist/synonyms/loadSynonyms.js

@@ -0,0 +1,20 @@
+import bundled from "./synonyms.json" with { type: "json" };
+/** Checks that `value` is an object mapping lowercase terms to arrays of lowercase strings. */
+export function parseSynonyms(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error("Synonyms must be an object of term -> string[]");
+    }
+    const synonyms = {};
+    for (const [term, alternates] of Object.entries(value)) {
+        if (!Array.isArray(alternates) || !alternates.every((a) => typeof a === "string")) {
+            throw new Error(`Synonyms for "${term}" must be an array of strings`);
+        }
+        synonyms[term.toLowerCase()] = alternates.map((a) => a.toLowerCase());
+    }
+    return synonyms;
+}
+/** Loads the synonyms bundled with the package (src/synonyms/synonyms.json). */
+export function loadSynonyms() {
+    return parseSynonyms(bundled);
+}
+//# sourceMappingURL=loadSynonyms.js.map

package/dist/synonyms/loadSynonyms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadSynonyms.js","sourceRoot":"","sources":["../../src/synonyms/loadSynonyms.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE5D,+FAA+F;AAC/F,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC/F,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,+BAA+B,CAAC,CAAC;QACxE,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/synonyms/synonyms.json

@@ -0,0 +1,80 @@
+{
+    "trash": ["delete", "remove", "bin", "garbage", "rubbish"],
+    "delete": ["trash", "remove", "bin"],
+    "logout": ["sign-out", "signout", "exit", "leave"],
+    "login": ["sign-in", "signin", "enter"],
+    "exit": ["logout", "leave", "quit"],
+    "photo": ["image", "picture", "gallery"],
+    "image": ["photo", "picture", "gallery"],
+    "settings": ["gear", "cog", "preferences", "config"],
+    "gear": ["settings", "cog", "preferences"],
+    "cog": ["settings", "gear", "preferences"],
+    "home": ["house", "dashboard"],
+    "house": ["home"],
+    "search": ["magnify", "magnifying-glass", "find", "lookup"],
+    "magnify": ["search", "find"],
+    "magnifying": ["search", "find"],
+    "user": ["person", "account", "profile", "avatar"],
+    "person": ["user", "account", "profile"],
+    "account": ["user", "person", "profile"],
+    "profile": ["user", "person", "account"],
+    "edit": ["pencil", "pen", "write", "modify"],
+    "pencil": ["edit", "write"],
+    "plus": ["add", "new", "create"],
+    "add": ["plus", "new", "create"],
+    "minus": ["subtract", "remove", "less"],
+    "close": ["x", "cancel", "dismiss"],
+    "x": ["close", "cancel", "dismiss"],
+    "xmark": ["close", "x", "cancel"],
+    "menu": ["hamburger", "bars", "navigation"],
+    "bars": ["menu", "hamburger"],
+    "arrow": ["direction", "pointer"],
+    "up": ["north", "top"],
+    "down": ["south", "bottom"],
+    "left": ["west", "back", "previous"],
+    "right": ["east", "forward", "next"],
+    "chevron": ["caret", "angle", "arrow"],
+    "caret": ["chevron", "angle", "arrow"],
+    "check": ["tick", "done", "success", "confirm"],
+    "tick": ["check", "done"],
+    "warning": ["alert", "caution", "danger", "exclamation"],
+    "alert": ["warning", "caution", "exclamation"],
+    "info": ["information", "help", "about"],
+    "help": ["question", "info", "support"],
+    "heart": ["like", "love", "favorite"],
+    "star": ["favorite", "rating", "bookmark"],
+    "lock": ["secure", "private", "password", "locked"],
+    "unlock": ["open", "unlocked", "unsecure"],
+    "mail": ["email", "envelope", "message", "inbox"],
+    "email": ["mail", "envelope", "message"],
+    "envelope": ["mail", "email", "message"],
+    "phone": ["call", "telephone", "mobile"],
+    "calendar": ["date", "schedule", "event"],
+    "clock": ["time", "watch", "schedule"],
+    "download": ["save", "export"],
+    "upload": ["import", "send"],
+    "share": ["send", "export"],
+    "link": ["url", "chain", "hyperlink"],
+    "filter": ["funnel", "refine"],
+    "sort": ["order", "arrange"],
+    "refresh": ["reload", "sync", "update", "rotate"],
+    "reload": ["refresh", "sync"],
+    "sync": ["refresh", "reload"],
+    "play": ["start", "run", "resume"],
+    "pause": ["hold", "wait"],
+    "stop": ["halt", "end"],
+    "volume": ["sound", "speaker", "audio"],
+    "wifi": ["wireless", "network", "internet"],
+    "battery": ["power", "charge"],
+    "camera": ["photo", "snapshot"],
+    "map": ["location", "navigation"],
+    "location": ["pin", "marker", "place", "map"],
+    "pin": ["location", "marker", "place"],
+    "cart": ["basket", "shopping", "checkout"],
+    "basket": ["cart", "shopping"],
+    "shopping": ["cart", "basket", "bag"],
+    "bell": ["notification", "alarm", "alert"],
+    "chat": ["message", "comment", "conversation"],
+    "copy": ["duplicate", "clone"],
+    "eye": ["view", "visible", "show"]
+}

package/dist/tools/context.d.ts

@@ -0,0 +1,26 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type ProjectConfig } from "../config/loadConfig.js";
+import type { IconRecord, Synonyms } from "../indexer/types.js";
+/** Everything the icon tools need from their environment. */
+export interface ToolContext {
+    projectDir: string;
+    cacheRoot: string;
+    synonyms: Synonyms;
+}
+export type VersionSource = "iconmcp.json" | "package.json";
+export interface ResolvedVersion {
+    version: string;
+    source: VersionSource;
+}
+/** Resolves the context from $TRUEICON_PROJECT_DIR (else cwd), the cache root and the bundled synonyms. */
+export declare function resolveContext(): ToolContext;
+/** The import statement for an icon, e.g. "import { Trash2 } from 'lucide-react';". */
+export declare function usageSnippet(record: IconRecord): string;
+/**
+ * Version for packageName: the .iconmcp.json pin, else the range in package.json.
+ * Returns null when neither is available.
+ */
+export declare function resolveVersion(projectDir: string, config: ProjectConfig, packageName: string): ResolvedVersion | null;
+export declare function errorMessage(error: unknown): string;
+/** Runs a tool body and wraps its result (or error) as MCP JSON text content. */
+export declare function jsonToolResult(run: () => unknown): Promise<CallToolResult>;

package/dist/tools/context.js

@@ -0,0 +1,43 @@
+import { resolveCacheRoot } from "../cache/downloader.js";
+import { detectVersion } from "../config/loadConfig.js";
+import { loadSynonyms } from "../synonyms/loadSynonyms.js";
+/** Resolves the context from $TRUEICON_PROJECT_DIR (else cwd), the cache root and the bundled synonyms. */
+export function resolveContext() {
+    return {
+        projectDir: process.env.TRUEICON_PROJECT_DIR ?? process.cwd(),
+        cacheRoot: resolveCacheRoot({}),
+        synonyms: loadSynonyms(),
+    };
+}
+/** The import statement for an icon, e.g. "import { Trash2 } from 'lucide-react';". */
+export function usageSnippet(record) {
+    return `import { ${record.importName} } from '${record.importPath}';`;
+}
+/**
+ * Version for packageName: the .iconmcp.json pin, else the range in package.json.
+ * Returns null when neither is available.
+ */
+export function resolveVersion(projectDir, config, packageName) {
+    const pinned = config.providers.find((p) => p.package === packageName)?.version;
+    if (pinned !== undefined)
+        return { version: pinned, source: "iconmcp.json" };
+    try {
+        return { version: detectVersion(projectDir, packageName), source: "package.json" };
+    }
+    catch {
+        return null;
+    }
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/** Runs a tool body and wraps its result (or error) as MCP JSON text content. */
+export async function jsonToolResult(run) {
+    try {
+        return { content: [{ type: "text", text: JSON.stringify(await run()) }] };
+    }
+    catch (error) {
+        return { content: [{ type: "text", text: JSON.stringify({ error: errorMessage(error) }) }], isError: true };
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAsB,MAAM,yBAAyB,CAAC;AAE5E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAgB3D,2GAA2G;AAC3G,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE;QAC7D,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC;QAC/B,QAAQ,EAAE,YAAY,EAAE;KACzB,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,OAAO,YAAY,MAAM,CAAC,UAAU,YAAY,MAAM,CAAC,UAAU,IAAI,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,MAAqB,EAAE,WAAmB;IAC3F,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,EAAE,OAAO,CAAC;IAChF,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC7E,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAkB;IACrD,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC9G,CAAC;AACH,CAAC"}

package/dist/tools/getIcon.d.ts

@@ -0,0 +1,16 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { IconRecord } from "../indexer/types.js";
+import { type ToolContext } from "./context.js";
+export interface GetIconInput {
+    /** Icon name ("trash-2") or import name ("Trash2"). */
+    name: string;
+    /** Provider id or npm package name. */
+    provider: string;
+    version?: string;
+}
+export type GetIconOutput = IconRecord & {
+    usage: string;
+};
+/** Looks up one icon by name or import name and returns its full record plus an import snippet. */
+export declare function getIconTool(input: GetIconInput, ctx: ToolContext): Promise<GetIconOutput>;
+export declare function registerGetIconTool(server: McpServer): void;