react-native-gtkx 0.1.0-alpha.4 → 0.2.0-alpha.2

package/dist/mcp/index.d.ts

@@ -0,0 +1,5 @@
+export { buildTools, createMcpServer, main, SERVER_NAME } from "./server.js";
+export { formatEntity, resolveComponent, type Candidate, type Entity, type ResolveResult, } from "./resolve.js";
+export { listSurface, SURFACE_AREAS, type SurfaceArea } from "./list.js";
+export { searchDocs, type SearchResult } from "./search.js";
+export type { Tool, ToolArgs } from "./tool.js";

package/dist/mcp/index.js

@@ -0,0 +1,9 @@
+// react-native-gtkx/mcp — programmatic access to the same server the
+// react-native-gtkx-mcp bin runs, for embedding or testing (see
+// tests/unit/mcp/). The bin (src/mcp/bin.ts) is the primary way this is
+// consumed; this barrel exists for everything else.
+export { buildTools, createMcpServer, main, SERVER_NAME } from "./server.js";
+export { formatEntity, resolveComponent, } from "./resolve.js";
+export { listSurface, SURFACE_AREAS } from "./list.js";
+export { searchDocs } from "./search.js";
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,gEAAgE;AAChE,wEAAwE;AACxE,oDAAoD;AACpD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC5E,OAAO,EACL,YAAY,EACZ,gBAAgB,GAIjB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAoB,MAAM,WAAW,CAAA;AACxE,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAA","sourcesContent":["// react-native-gtkx/mcp — programmatic access to the same server the\n// react-native-gtkx-mcp bin runs, for embedding or testing (see\n// tests/unit/mcp/). The bin (src/mcp/bin.ts) is the primary way this is\n// consumed; this barrel exists for everything else.\nexport { buildTools, createMcpServer, main, SERVER_NAME } from \"./server.js\"\nexport {\n  formatEntity,\n  resolveComponent,\n  type Candidate,\n  type Entity,\n  type ResolveResult,\n} from \"./resolve.js\"\nexport { listSurface, SURFACE_AREAS, type SurfaceArea } from \"./list.js\"\nexport { searchDocs, type SearchResult } from \"./search.js\"\nexport type { Tool, ToolArgs } from \"./tool.js\"\n"]}

package/dist/mcp/list.d.ts

@@ -0,0 +1,4 @@
+declare const SURFACE_AREAS: readonly ["portable-components", "portable-apis", "gtk-widgets", "adw-widgets", "common"];
+type SurfaceArea = (typeof SURFACE_AREAS)[number];
+declare const listSurface: (area?: SurfaceArea) => string;
+export { listSurface, SURFACE_AREAS, type SurfaceArea };

package/dist/mcp/list.js

@@ -0,0 +1,56 @@
+// rn_gtkx_list_surface: browse the surface without knowing an exact name
+// first — an overview with counts, or the full name list for one area.
+import { ADW_WIDGETS, COMMON_PRIMITIVES, GTK_WIDGETS, PORTABLE_APIS, PORTABLE_COMPONENTS, } from "./data/generated.js";
+const SURFACE_AREAS = [
+    "portable-components",
+    "portable-apis",
+    "gtk-widgets",
+    "adw-widgets",
+    "common",
+];
+const formatWidgetArea = (subpath, widgets) => {
+    const wrapped = widgets.filter((w) => w.wrapped);
+    const raw = widgets.filter((w) => !w.wrapped);
+    const wrappedLines = wrapped.map((w) => `- ${w.name}`).join("\n");
+    const rawLines = raw
+        .map((w) => `- ${w.name} (${w.reason ?? "raw"})`)
+        .join("\n");
+    return (`${subpath} — ${wrapped.length} wrapped (take \`style\`/\`onLayout\`), ${raw.length} raw (exported exactly as gtkx binds them):\n\n` +
+        `Wrapped:\n${wrappedLines}\n\nRaw:\n${rawLines}`);
+};
+const overview = () => {
+    const gtkWrapped = GTK_WIDGETS.filter((w) => w.wrapped).length;
+    const gtkRaw = GTK_WIDGETS.length - gtkWrapped;
+    const adwWrapped = ADW_WIDGETS.filter((w) => w.wrapped).length;
+    const adwRaw = ADW_WIDGETS.length - adwWrapped;
+    return [
+        "react-native-gtkx surface overview",
+        "",
+        `portable-components (${PORTABLE_COMPONENTS.length}): exported from "react-native" — same import path as upstream RN (View, Text, FlatList, ...). Each has RN-compatible differences documented per name.`,
+        `portable-apis (${PORTABLE_APIS.length}): modules exported from "react-native" (StyleSheet, Platform, AppRegistry, ...).`,
+        `gtk-widgets (${gtkWrapped} wrapped + ${gtkRaw} raw): react-native-gtkx/gtk — every GTK4 widget gtkx binds.`,
+        `adw-widgets (${adwWrapped} wrapped + ${adwRaw} raw): react-native-gtkx/adw — every libadwaita widget gtkx binds.`,
+        `common (${COMMON_PRIMITIVES.length}): react-native-gtkx/common — NavigationStack, NavigationStackPage, SlotContent, IntrinsicContent. (Widget, wrapReactNative and useWidgetLayout also live here but are prose-only in the docs — use rn_gtkx_search_docs for those.)`,
+        "",
+        "Call again with `area` to list names, or rn_gtkx_describe_component with a specific name for full details.",
+    ].join("\n");
+};
+const listSurface = (area) => {
+    if (area === undefined) {
+        return overview();
+    }
+    switch (area) {
+        case "portable-components":
+            return PORTABLE_COMPONENTS.map((c) => `- ${c.name} (GTK: ${c.gtkImplementation})`).join("\n");
+        case "portable-apis":
+            return PORTABLE_APIS.map((a) => `- ${a.name}`).join("\n");
+        case "common":
+            return COMMON_PRIMITIVES.map((c) => `- ${c.name} — ${c.summary}`).join("\n");
+        case "gtk-widgets":
+            return formatWidgetArea("react-native-gtkx/gtk", GTK_WIDGETS);
+        case "adw-widgets":
+            return formatWidgetArea("react-native-gtkx/adw", ADW_WIDGETS);
+    }
+};
+export { listSurface, SURFACE_AREAS };
+//# sourceMappingURL=list.js.map

package/dist/mcp/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/mcp/list.ts"],"names":[],"mappings":"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","sourcesContent":["// rn_gtkx_list_surface: browse the surface without knowing an exact name\n// first — an overview with counts, or the full name list for one area.\nimport {\n  ADW_WIDGETS,\n  COMMON_PRIMITIVES,\n  GTK_WIDGETS,\n  PORTABLE_APIS,\n  PORTABLE_COMPONENTS,\n  type WidgetRecord,\n} from \"./data/generated.js\"\n\nconst SURFACE_AREAS = [\n  \"portable-components\",\n  \"portable-apis\",\n  \"gtk-widgets\",\n  \"adw-widgets\",\n  \"common\",\n] as const\n\ntype SurfaceArea = (typeof SURFACE_AREAS)[number]\n\nconst formatWidgetArea = (\n  subpath: string,\n  widgets: readonly WidgetRecord[],\n): string => {\n  const wrapped = widgets.filter((w) => w.wrapped)\n  const raw = widgets.filter((w) => !w.wrapped)\n  const wrappedLines = wrapped.map((w) => `- ${w.name}`).join(\"\\n\")\n  const rawLines = raw\n    .map((w) => `- ${w.name} (${w.reason ?? \"raw\"})`)\n    .join(\"\\n\")\n  return (\n    `${subpath} — ${wrapped.length} wrapped (take \\`style\\`/\\`onLayout\\`), ${raw.length} raw (exported exactly as gtkx binds them):\\n\\n` +\n    `Wrapped:\\n${wrappedLines}\\n\\nRaw:\\n${rawLines}`\n  )\n}\n\nconst overview = (): string => {\n  const gtkWrapped = GTK_WIDGETS.filter((w) => w.wrapped).length\n  const gtkRaw = GTK_WIDGETS.length - gtkWrapped\n  const adwWrapped = ADW_WIDGETS.filter((w) => w.wrapped).length\n  const adwRaw = ADW_WIDGETS.length - adwWrapped\n\n  return [\n    \"react-native-gtkx surface overview\",\n    \"\",\n    `portable-components (${PORTABLE_COMPONENTS.length}): exported from \"react-native\" — same import path as upstream RN (View, Text, FlatList, ...). Each has RN-compatible differences documented per name.`,\n    `portable-apis (${PORTABLE_APIS.length}): modules exported from \"react-native\" (StyleSheet, Platform, AppRegistry, ...).`,\n    `gtk-widgets (${gtkWrapped} wrapped + ${gtkRaw} raw): react-native-gtkx/gtk — every GTK4 widget gtkx binds.`,\n    `adw-widgets (${adwWrapped} wrapped + ${adwRaw} raw): react-native-gtkx/adw — every libadwaita widget gtkx binds.`,\n    `common (${COMMON_PRIMITIVES.length}): react-native-gtkx/common — NavigationStack, NavigationStackPage, SlotContent, IntrinsicContent. (Widget, wrapReactNative and useWidgetLayout also live here but are prose-only in the docs — use rn_gtkx_search_docs for those.)`,\n    \"\",\n    \"Call again with `area` to list names, or rn_gtkx_describe_component with a specific name for full details.\",\n  ].join(\"\\n\")\n}\n\nconst listSurface = (area?: SurfaceArea): string => {\n  if (area === undefined) {\n    return overview()\n  }\n  switch (area) {\n    case \"portable-components\":\n      return PORTABLE_COMPONENTS.map(\n        (c) => `- ${c.name} (GTK: ${c.gtkImplementation})`,\n      ).join(\"\\n\")\n    case \"portable-apis\":\n      return PORTABLE_APIS.map((a) => `- ${a.name}`).join(\"\\n\")\n    case \"common\":\n      return COMMON_PRIMITIVES.map((c) => `- ${c.name} — ${c.summary}`).join(\n        \"\\n\",\n      )\n    case \"gtk-widgets\":\n      return formatWidgetArea(\"react-native-gtkx/gtk\", GTK_WIDGETS)\n    case \"adw-widgets\":\n      return formatWidgetArea(\"react-native-gtkx/adw\", ADW_WIDGETS)\n  }\n}\n\nexport { listSurface, SURFACE_AREAS, type SurfaceArea }\n"]}

package/dist/mcp/resolve.d.ts

@@ -0,0 +1,55 @@
+import { type CommonRecord, type PortableRecord, type WidgetRecord } from "./data/generated.js";
+type Entity = {
+    kind: "portable-component";
+    record: PortableRecord;
+} | {
+    kind: "portable-api";
+    record: PortableRecord;
+} | {
+    kind: "common";
+    record: CommonRecord;
+} | {
+    kind: "gtk-widget";
+    record: WidgetRecord;
+} | {
+    kind: "adw-widget";
+    record: WidgetRecord;
+};
+type Candidate = {
+    name: string;
+    subpath: string;
+    kind: Entity["kind"];
+};
+type ResolvedEntity = {
+    status: "resolved";
+    entity: Entity;
+    matchedBy: "exact" | "case-insensitive" | "prefix" | "substring";
+};
+type AmbiguousResult = {
+    status: "ambiguous";
+    query: string;
+    candidates: readonly Candidate[];
+};
+type NotFoundResult = {
+    status: "not-found";
+    query: string;
+    suggestions: readonly Candidate[];
+};
+type ResolveResult = ResolvedEntity | AmbiguousResult | NotFoundResult;
+/**
+ * Resolves a free-form name to exactly one surface entity:
+ * 1. exact match, then case-insensitive exact match;
+ * 2. Gtk<name>/Adw<name> exact match — tried BEFORE substring search, so
+ *    "Popover" resolves cleanly to GtkPopover instead of landing ambiguous
+ *    against GtkPopoverBin/GtkPopoverMenu/GtkPopoverMenuBar too;
+ * 3. substring search (case-insensitive): one hit resolves, several are
+ *    reported as ambiguous candidates (never guessed), zero fall through
+ *    to a not-found response with the closest known names by edit
+ *    distance.
+ */
+declare const resolveComponent: (query: string) => ResolveResult;
+/** Formats a resolved entity into the plain object the tool returns as
+ * JSON text — one shape per kind, matching what docs/api.md and
+ * docs/platform-layer.md actually document for it. */
+declare const formatEntity: (entity: Entity) => Record<string, unknown>;
+export { formatEntity, resolveComponent, type Candidate, type Entity, type ResolveResult, };

package/dist/mcp/resolve.js

@@ -0,0 +1,151 @@
+// Name resolution for rn_gtkx_describe_component: turns a free-form name
+// into exactly one of the surface's entities, or says clearly why it
+// could not (ambiguous vs. not-found) instead of guessing.
+import { ADW_WIDGETS, COMMON_PRIMITIVES, GTK_WIDGETS, PORTABLE_APIS, PORTABLE_COMPONENTS, } from "./data/generated.js";
+const ALL_ENTITIES = [
+    ...PORTABLE_COMPONENTS.map((record) => ({
+        kind: "portable-component",
+        record,
+    })),
+    ...PORTABLE_APIS.map((record) => ({ kind: "portable-api", record })),
+    ...COMMON_PRIMITIVES.map((record) => ({ kind: "common", record })),
+    ...GTK_WIDGETS.map((record) => ({ kind: "gtk-widget", record })),
+    ...ADW_WIDGETS.map((record) => ({ kind: "adw-widget", record })),
+];
+const candidateOf = (entity) => ({
+    name: entity.record.name,
+    subpath: entity.record.subpath,
+    kind: entity.kind,
+});
+// Unweighted Levenshtein distance — 200-odd short names, no need for
+// anything fancier to rank "closest known name" suggestions.
+const levenshtein = (a, b) => {
+    const rows = a.length + 1;
+    const cols = b.length + 1;
+    const dp = Array.from({ length: rows }, () => new Array(cols).fill(0));
+    for (let i = 0; i < rows; i++) {
+        dp[i][0] = i;
+    }
+    for (let j = 0; j < cols; j++) {
+        dp[0][j] = j;
+    }
+    for (let i = 1; i < rows; i++) {
+        for (let j = 1; j < cols; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[rows - 1][cols - 1];
+};
+const MAX_CANDIDATES = 20;
+const MAX_SUGGESTIONS = 5;
+const PREFIXES = ["Gtk", "Adw"];
+/**
+ * Resolves a free-form name to exactly one surface entity:
+ * 1. exact match, then case-insensitive exact match;
+ * 2. Gtk<name>/Adw<name> exact match — tried BEFORE substring search, so
+ *    "Popover" resolves cleanly to GtkPopover instead of landing ambiguous
+ *    against GtkPopoverBin/GtkPopoverMenu/GtkPopoverMenuBar too;
+ * 3. substring search (case-insensitive): one hit resolves, several are
+ *    reported as ambiguous candidates (never guessed), zero fall through
+ *    to a not-found response with the closest known names by edit
+ *    distance.
+ */
+const resolveComponent = (query) => {
+    const trimmed = query.trim();
+    const lower = trimmed.toLowerCase();
+    if (lower.length === 0) {
+        return { status: "not-found", query: trimmed, suggestions: [] };
+    }
+    const exact = ALL_ENTITIES.find((e) => e.record.name === trimmed);
+    if (exact) {
+        return { status: "resolved", entity: exact, matchedBy: "exact" };
+    }
+    const caseInsensitive = ALL_ENTITIES.find((e) => e.record.name.toLowerCase() === lower);
+    if (caseInsensitive) {
+        return {
+            status: "resolved",
+            entity: caseInsensitive,
+            matchedBy: "case-insensitive",
+        };
+    }
+    if (!/^(gtk|adw)/i.test(trimmed)) {
+        for (const prefix of PREFIXES) {
+            const prefixedLower = `${prefix}${trimmed}`.toLowerCase();
+            const match = ALL_ENTITIES.find((e) => e.record.name.toLowerCase() === prefixedLower);
+            if (match) {
+                return { status: "resolved", entity: match, matchedBy: "prefix" };
+            }
+        }
+    }
+    const substringMatches = ALL_ENTITIES.filter((e) => e.record.name.toLowerCase().includes(lower));
+    if (substringMatches.length === 1) {
+        return {
+            status: "resolved",
+            entity: substringMatches[0],
+            matchedBy: "substring",
+        };
+    }
+    if (substringMatches.length > 1) {
+        return {
+            status: "ambiguous",
+            query: trimmed,
+            candidates: substringMatches.slice(0, MAX_CANDIDATES).map(candidateOf),
+        };
+    }
+    const suggestions = ALL_ENTITIES.map((entity) => ({
+        entity,
+        distance: levenshtein(lower, entity.record.name.toLowerCase()),
+    }))
+        .sort((a, b) => a.distance - b.distance)
+        .slice(0, MAX_SUGGESTIONS)
+        .map(({ entity }) => candidateOf(entity));
+    return { status: "not-found", query: trimmed, suggestions };
+};
+/** Formats a resolved entity into the plain object the tool returns as
+ * JSON text — one shape per kind, matching what docs/api.md and
+ * docs/platform-layer.md actually document for it. */
+const formatEntity = (entity) => {
+    switch (entity.kind) {
+        case "portable-component":
+        case "portable-api": {
+            const record = entity.record;
+            return {
+                kind: entity.kind,
+                name: record.name,
+                subpath: record.subpath,
+                ...(record.gtkImplementation !== undefined
+                    ? { gtkImplementation: record.gtkImplementation }
+                    : {}),
+                supported: record.supported,
+                differences: record.differences,
+            };
+        }
+        case "common": {
+            const record = entity.record;
+            return {
+                kind: entity.kind,
+                name: record.name,
+                subpath: record.subpath,
+                summary: record.summary,
+            };
+        }
+        case "gtk-widget":
+        case "adw-widget": {
+            const record = entity.record;
+            const note = record.wrapped
+                ? "Takes `style` + `onLayout`; React Native layout positions and styles it. Outside RN layout (e.g. inside an AdwHeaderBar slot) it steps aside and renders as the bare widget."
+                : `Raw export — exactly as gtkx binds it, no \`style\`/\`onLayout\` (wrap it yourself with wrapReactNative from react-native-gtkx/gtk if you need RN layout to drive it).${record.reason ? ` Why raw: ${record.reason}` : ""}`;
+            return {
+                kind: entity.kind,
+                name: record.name,
+                subpath: record.subpath,
+                wrapped: record.wrapped,
+                ...(record.reason !== undefined ? { reason: record.reason } : {}),
+                note,
+            };
+        }
+    }
+};
+export { formatEntity, resolveComponent, };
+//# sourceMappingURL=resolve.js.map

package/dist/mcp/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/mcp/resolve.ts"],"names":[],"mappings":"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","sourcesContent":["// Name resolution for rn_gtkx_describe_component: turns a free-form name\n// into exactly one of the surface's entities, or says clearly why it\n// could not (ambiguous vs. not-found) instead of guessing.\nimport {\n  ADW_WIDGETS,\n  COMMON_PRIMITIVES,\n  GTK_WIDGETS,\n  PORTABLE_APIS,\n  PORTABLE_COMPONENTS,\n  type CommonRecord,\n  type PortableRecord,\n  type WidgetRecord,\n} from \"./data/generated.js\"\n\ntype Entity =\n  | { kind: \"portable-component\"; record: PortableRecord }\n  | { kind: \"portable-api\"; record: PortableRecord }\n  | { kind: \"common\"; record: CommonRecord }\n  | { kind: \"gtk-widget\"; record: WidgetRecord }\n  | { kind: \"adw-widget\"; record: WidgetRecord }\n\ntype Candidate = { name: string; subpath: string; kind: Entity[\"kind\"] }\n\ntype ResolvedEntity = {\n  status: \"resolved\"\n  entity: Entity\n  matchedBy: \"exact\" | \"case-insensitive\" | \"prefix\" | \"substring\"\n}\ntype AmbiguousResult = {\n  status: \"ambiguous\"\n  query: string\n  candidates: readonly Candidate[]\n}\ntype NotFoundResult = {\n  status: \"not-found\"\n  query: string\n  suggestions: readonly Candidate[]\n}\ntype ResolveResult = ResolvedEntity | AmbiguousResult | NotFoundResult\n\nconst ALL_ENTITIES: readonly Entity[] = [\n  ...PORTABLE_COMPONENTS.map((record): Entity => ({\n    kind: \"portable-component\",\n    record,\n  })),\n  ...PORTABLE_APIS.map((record): Entity => ({ kind: \"portable-api\", record })),\n  ...COMMON_PRIMITIVES.map((record): Entity => ({ kind: \"common\", record })),\n  ...GTK_WIDGETS.map((record): Entity => ({ kind: \"gtk-widget\", record })),\n  ...ADW_WIDGETS.map((record): Entity => ({ kind: \"adw-widget\", record })),\n]\n\nconst candidateOf = (entity: Entity): Candidate => ({\n  name: entity.record.name,\n  subpath: entity.record.subpath,\n  kind: entity.kind,\n})\n\n// Unweighted Levenshtein distance — 200-odd short names, no need for\n// anything fancier to rank \"closest known name\" suggestions.\nconst levenshtein = (a: string, b: string): number => {\n  const rows = a.length + 1\n  const cols = b.length + 1\n  const dp: number[][] = Array.from({ length: rows }, () =>\n    new Array<number>(cols).fill(0),\n  )\n  for (let i = 0; i < rows; i++) {\n    dp[i]![0] = i\n  }\n  for (let j = 0; j < cols; j++) {\n    dp[0]![j] = j\n  }\n  for (let i = 1; i < rows; i++) {\n    for (let j = 1; j < cols; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1\n      dp[i]![j] = Math.min(\n        dp[i - 1]![j]! + 1,\n        dp[i]![j - 1]! + 1,\n        dp[i - 1]![j - 1]! + cost,\n      )\n    }\n  }\n  return dp[rows - 1]![cols - 1]!\n}\n\nconst MAX_CANDIDATES = 20\nconst MAX_SUGGESTIONS = 5\nconst PREFIXES = [\"Gtk\", \"Adw\"] as const\n\n/**\n * Resolves a free-form name to exactly one surface entity:\n * 1. exact match, then case-insensitive exact match;\n * 2. Gtk<name>/Adw<name> exact match — tried BEFORE substring search, so\n *    \"Popover\" resolves cleanly to GtkPopover instead of landing ambiguous\n *    against GtkPopoverBin/GtkPopoverMenu/GtkPopoverMenuBar too;\n * 3. substring search (case-insensitive): one hit resolves, several are\n *    reported as ambiguous candidates (never guessed), zero fall through\n *    to a not-found response with the closest known names by edit\n *    distance.\n */\nconst resolveComponent = (query: string): ResolveResult => {\n  const trimmed = query.trim()\n  const lower = trimmed.toLowerCase()\n\n  if (lower.length === 0) {\n    return { status: \"not-found\", query: trimmed, suggestions: [] }\n  }\n\n  const exact = ALL_ENTITIES.find((e) => e.record.name === trimmed)\n  if (exact) {\n    return { status: \"resolved\", entity: exact, matchedBy: \"exact\" }\n  }\n\n  const caseInsensitive = ALL_ENTITIES.find(\n    (e) => e.record.name.toLowerCase() === lower,\n  )\n  if (caseInsensitive) {\n    return {\n      status: \"resolved\",\n      entity: caseInsensitive,\n      matchedBy: \"case-insensitive\",\n    }\n  }\n\n  if (!/^(gtk|adw)/i.test(trimmed)) {\n    for (const prefix of PREFIXES) {\n      const prefixedLower = `${prefix}${trimmed}`.toLowerCase()\n      const match = ALL_ENTITIES.find(\n        (e) => e.record.name.toLowerCase() === prefixedLower,\n      )\n      if (match) {\n        return { status: \"resolved\", entity: match, matchedBy: \"prefix\" }\n      }\n    }\n  }\n\n  const substringMatches = ALL_ENTITIES.filter((e) =>\n    e.record.name.toLowerCase().includes(lower),\n  )\n  if (substringMatches.length === 1) {\n    return {\n      status: \"resolved\",\n      entity: substringMatches[0]!,\n      matchedBy: \"substring\",\n    }\n  }\n  if (substringMatches.length > 1) {\n    return {\n      status: \"ambiguous\",\n      query: trimmed,\n      candidates: substringMatches.slice(0, MAX_CANDIDATES).map(candidateOf),\n    }\n  }\n\n  const suggestions = ALL_ENTITIES.map((entity) => ({\n    entity,\n    distance: levenshtein(lower, entity.record.name.toLowerCase()),\n  }))\n    .sort((a, b) => a.distance - b.distance)\n    .slice(0, MAX_SUGGESTIONS)\n    .map(({ entity }) => candidateOf(entity))\n\n  return { status: \"not-found\", query: trimmed, suggestions }\n}\n\n/** Formats a resolved entity into the plain object the tool returns as\n * JSON text — one shape per kind, matching what docs/api.md and\n * docs/platform-layer.md actually document for it. */\nconst formatEntity = (entity: Entity): Record<string, unknown> => {\n  switch (entity.kind) {\n    case \"portable-component\":\n    case \"portable-api\": {\n      const record = entity.record\n      return {\n        kind: entity.kind,\n        name: record.name,\n        subpath: record.subpath,\n        ...(record.gtkImplementation !== undefined\n          ? { gtkImplementation: record.gtkImplementation }\n          : {}),\n        supported: record.supported,\n        differences: record.differences,\n      }\n    }\n    case \"common\": {\n      const record = entity.record\n      return {\n        kind: entity.kind,\n        name: record.name,\n        subpath: record.subpath,\n        summary: record.summary,\n      }\n    }\n    case \"gtk-widget\":\n    case \"adw-widget\": {\n      const record = entity.record\n      const note = record.wrapped\n        ? \"Takes `style` + `onLayout`; React Native layout positions and styles it. Outside RN layout (e.g. inside an AdwHeaderBar slot) it steps aside and renders as the bare widget.\"\n        : `Raw export — exactly as gtkx binds it, no \\`style\\`/\\`onLayout\\` (wrap it yourself with wrapReactNative from react-native-gtkx/gtk if you need RN layout to drive it).${record.reason ? ` Why raw: ${record.reason}` : \"\"}`\n      return {\n        kind: entity.kind,\n        name: record.name,\n        subpath: record.subpath,\n        wrapped: record.wrapped,\n        ...(record.reason !== undefined ? { reason: record.reason } : {}),\n        note,\n      }\n    }\n  }\n}\n\nexport {\n  formatEntity,\n  resolveComponent,\n  type Candidate,\n  type Entity,\n  type ResolveResult,\n}\n"]}

package/dist/mcp/search.d.ts

@@ -0,0 +1,13 @@
+import { type DocChunk } from "./data/generated.js";
+type SearchResult = DocChunk & {
+    score: number;
+};
+/**
+ * Scores every doc chunk by how many times each query term occurs in it
+ * (body text: 1 point per occurrence; the same term appearing in the
+ * heading: +3, so a chunk that is literally ABOUT the query ranks above
+ * one that merely mentions it in passing). No stemming, no synonyms — this
+ * is deliberately the least clever tool: a fallback, not the star.
+ */
+declare const searchDocs: (query: string, limit: number) => readonly SearchResult[];
+export { searchDocs, type SearchResult };

package/dist/mcp/search.js

@@ -0,0 +1,48 @@
+// rn_gtkx_search_docs: free-text fallback for anything the structured
+// tools (list_surface, describe_component) do not cover by name — symptoms
+// ("list blanks on scroll"), cross-cutting workarounds, prose-only
+// sections (navigation options, the escape hatch, ...).
+import { DOC_CHUNKS } from "./data/generated.js";
+const tokenize = (text) => text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+const countOccurrences = (haystack, needle) => {
+    if (needle.length === 0) {
+        return 0;
+    }
+    let count = 0;
+    let index = haystack.indexOf(needle);
+    while (index !== -1) {
+        count++;
+        index = haystack.indexOf(needle, index + needle.length);
+    }
+    return count;
+};
+const HEADING_MATCH_WEIGHT = 3;
+/**
+ * Scores every doc chunk by how many times each query term occurs in it
+ * (body text: 1 point per occurrence; the same term appearing in the
+ * heading: +3, so a chunk that is literally ABOUT the query ranks above
+ * one that merely mentions it in passing). No stemming, no synonyms — this
+ * is deliberately the least clever tool: a fallback, not the star.
+ */
+const searchDocs = (query, limit) => {
+    const terms = tokenize(query);
+    if (terms.length === 0) {
+        return [];
+    }
+    const scored = DOC_CHUNKS.map((chunk) => {
+        const headingLower = chunk.heading.toLowerCase();
+        const bodyLower = chunk.text.toLowerCase();
+        let score = 0;
+        for (const term of terms) {
+            score += countOccurrences(bodyLower, term);
+            score += countOccurrences(headingLower, term) * HEADING_MATCH_WEIGHT;
+        }
+        return { ...chunk, score };
+    });
+    return scored
+        .filter((chunk) => chunk.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+};
+export { searchDocs };
+//# sourceMappingURL=search.js.map

package/dist/mcp/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/mcp/search.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2EAA2E;AAC3E,mEAAmE;AACnE,wDAAwD;AACxD,OAAO,EAAE,UAAU,EAAiB,MAAM,qBAAqB,CAAA;AAI/D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAY,EAAE,CAC1C,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;AAE9C,MAAM,gBAAgB,GAAG,CAAC,QAAgB,EAAE,MAAc,EAAU,EAAE;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,CAAA;IACV,CAAC;IACD,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACpC,OAAO,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,KAAK,EAAE,CAAA;QACP,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAE9B;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,KAAa,EAA2B,EAAE;IAC3E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,MAAM,GAAmB,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACtD,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;QAChD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAA;QAC1C,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,IAAI,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAC1C,KAAK,IAAI,gBAAgB,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,oBAAoB,CAAA;QACtE,CAAC;QACD,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAA;IAC5B,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AACpB,CAAC,CAAA;AAED,OAAO,EAAE,UAAU,EAAqB,CAAA","sourcesContent":["// rn_gtkx_search_docs: free-text fallback for anything the structured\n// tools (list_surface, describe_component) do not cover by name — symptoms\n// (\"list blanks on scroll\"), cross-cutting workarounds, prose-only\n// sections (navigation options, the escape hatch, ...).\nimport { DOC_CHUNKS, type DocChunk } from \"./data/generated.js\"\n\ntype SearchResult = DocChunk & { score: number }\n\nconst tokenize = (text: string): string[] =>\n  text.toLowerCase().match(/[a-z0-9]+/g) ?? []\n\nconst countOccurrences = (haystack: string, needle: string): number => {\n  if (needle.length === 0) {\n    return 0\n  }\n  let count = 0\n  let index = haystack.indexOf(needle)\n  while (index !== -1) {\n    count++\n    index = haystack.indexOf(needle, index + needle.length)\n  }\n  return count\n}\n\nconst HEADING_MATCH_WEIGHT = 3\n\n/**\n * Scores every doc chunk by how many times each query term occurs in it\n * (body text: 1 point per occurrence; the same term appearing in the\n * heading: +3, so a chunk that is literally ABOUT the query ranks above\n * one that merely mentions it in passing). No stemming, no synonyms — this\n * is deliberately the least clever tool: a fallback, not the star.\n */\nconst searchDocs = (query: string, limit: number): readonly SearchResult[] => {\n  const terms = tokenize(query)\n  if (terms.length === 0) {\n    return []\n  }\n\n  const scored: SearchResult[] = DOC_CHUNKS.map((chunk) => {\n    const headingLower = chunk.heading.toLowerCase()\n    const bodyLower = chunk.text.toLowerCase()\n    let score = 0\n    for (const term of terms) {\n      score += countOccurrences(bodyLower, term)\n      score += countOccurrences(headingLower, term) * HEADING_MATCH_WEIGHT\n    }\n    return { ...chunk, score }\n  })\n\n  return scored\n    .filter((chunk) => chunk.score > 0)\n    .sort((a, b) => b.score - a.score)\n    .slice(0, limit)\n}\n\nexport { searchDocs, type SearchResult }\n"]}

package/dist/mcp/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Tool } from "./tool.js";
+declare const SERVER_NAME = "react-native-gtkx-mcp";
+declare const buildTools: () => Tool[];
+declare const createMcpServer: () => McpServer;
+declare const main: () => Promise<void>;
+export { buildTools, createMcpServer, main, SERVER_NAME };

package/dist/mcp/server.js

@@ -0,0 +1,135 @@
+// The MCP server itself: three tools over stdio, backed entirely by the
+// generated data in ./data/generated.ts — no @gtkx/* import anywhere in
+// this module or its dependents, so this runs on any OS without GTK
+// installed (an agent reading a react-native-gtkx project on a Mac, for
+// instance). See docs/getting-started.md for how a consumer registers it.
+import { createRequire } from "node:module";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { listSurface, SURFACE_AREAS } from "./list.js";
+import { formatEntity, resolveComponent } from "./resolve.js";
+import { searchDocs } from "./search.js";
+import { defineTool, registerTool, textContent, textError, } from "./tool.js";
+const require = createRequire(import.meta.url);
+// Package root is two levels up from dist/mcp/server.js (dist/mcp -> dist
+// -> package root). package.json ships in every npm tarball regardless of
+// the "files" allowlist, so this needs no extra packaging step.
+const { version } = require("../../package.json");
+const SERVER_NAME = "react-native-gtkx-mcp";
+const DEFAULT_SEARCH_LIMIT = 10;
+const MAX_SEARCH_LIMIT = 20;
+const listSurfaceShape = {
+    area: z
+        .enum(SURFACE_AREAS)
+        .optional()
+        .describe("Area to list. Omit for an overview with counts across all areas: " +
+        SURFACE_AREAS.join(", ") +
+        "."),
+};
+const describeComponentShape = {
+    name: z
+        .string()
+        .describe("A component/API/widget name: a portable react-native export (e.g. " +
+        '"FlatList"), a react-native-gtkx/gtk or /adw widget with or ' +
+        'without its Gtk/Adw prefix (e.g. "Popover" resolves to ' +
+        '"GtkPopover"), or a react-native-gtkx/common export (e.g. ' +
+        '"NavigationStack"). Case-insensitive.'),
+};
+const searchDocsShape = {
+    query: z
+        .string()
+        .describe("Free-text query — a symptom, a GTK term, an option name. Use this " +
+        "when rn_gtkx_describe_component does not have a name to look up, " +
+        'e.g. "known issues", "chrome content", "windowSize".'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_SEARCH_LIMIT)
+        .optional()
+        .describe(`Maximum number of results (default ${DEFAULT_SEARCH_LIMIT}, max ${MAX_SEARCH_LIMIT}).`),
+};
+const listSurfaceTool = () => defineTool({
+    name: "rn_gtkx_list_surface",
+    title: "List the react-native-gtkx surface",
+    description: "Browse the react-native-gtkx surface without knowing an exact name first: " +
+        "portable react-native components/APIs, the react-native-gtkx/gtk and " +
+        "/adw widget lists (wrapped vs. raw), and react-native-gtkx/common. " +
+        "Without `area`, returns counts and where to look next.",
+    inputSchema: listSurfaceShape,
+    handler: ({ area }) => textContent(listSurface(area)),
+});
+const describeComponentTool = () => defineTool({
+    name: "rn_gtkx_describe_component",
+    title: "Describe a react-native-gtkx component",
+    description: "Look up one component/widget/API by name: does it exist, which " +
+        "subpath it is exported from, what GTK widget backs it (for " +
+        "portable components), what differs from React Native, and whether " +
+        "a gtk/adw widget is wrapped (takes `style`/`onLayout`) or raw. The " +
+        "single most useful tool here — start with this before " +
+        "rn_gtkx_search_docs.",
+    inputSchema: describeComponentShape,
+    handler: ({ name }) => {
+        const result = resolveComponent(name);
+        if (result.status === "resolved") {
+            const body = {
+                matchedBy: result.matchedBy,
+                ...formatEntity(result.entity),
+            };
+            return textContent(JSON.stringify(body, null, 2));
+        }
+        if (result.status === "ambiguous") {
+            const lines = result.candidates
+                .map((c) => `- ${c.name} (${c.subpath}, ${c.kind})`)
+                .join("\n");
+            return textError(`"${result.query}" matches ${result.candidates.length} names — call again with one of:\n${lines}`);
+        }
+        const lines = result.suggestions
+            .map((c) => `- ${c.name} (${c.subpath}, ${c.kind})`)
+            .join("\n");
+        return textError(`No component named "${result.query}".` +
+            (lines.length > 0
+                ? ` Closest known names:\n${lines}`
+                : " rn_gtkx_list_surface has the full index."));
+    },
+});
+const searchDocsTool = () => defineTool({
+    name: "rn_gtkx_search_docs",
+    title: "Search react-native-gtkx docs",
+    description: "Free-text search over the docs (getting-started, the platform layer, " +
+        "gtkx rc.3 workarounds/quirks, navigation). The fallback tool: use it " +
+        "for symptoms and known-issue questions that rn_gtkx_describe_component " +
+        "cannot answer by name (workarounds are keyed by mechanism, not by " +
+        "component).",
+    inputSchema: searchDocsShape,
+    handler: ({ query, limit }) => {
+        const results = searchDocs(query, limit ?? DEFAULT_SEARCH_LIMIT);
+        if (results.length === 0) {
+            return textContent(`No matches for "${query}". Try rn_gtkx_list_surface or rn_gtkx_describe_component instead.`);
+        }
+        const body = results
+            .map((r) => `## ${r.doc} — ${r.heading}\n\n${r.text}`)
+            .join("\n\n---\n\n");
+        return textContent(body);
+    },
+});
+const buildTools = () => [
+    listSurfaceTool(),
+    describeComponentTool(),
+    searchDocsTool(),
+];
+const createMcpServer = () => {
+    const server = new McpServer({ name: SERVER_NAME, version });
+    for (const tool of buildTools()) {
+        registerTool(server, tool);
+    }
+    return server;
+};
+const main = async () => {
+    const server = createMcpServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+};
+export { buildTools, createMcpServer, main, SERVER_NAME };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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","sourcesContent":["// The MCP server itself: three tools over stdio, backed entirely by the\n// generated data in ./data/generated.ts — no @gtkx/* import anywhere in\n// this module or its dependents, so this runs on any OS without GTK\n// installed (an agent reading a react-native-gtkx project on a Mac, for\n// instance). See docs/getting-started.md for how a consumer registers it.\nimport { createRequire } from \"node:module\"\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport { listSurface, SURFACE_AREAS } from \"./list.js\"\nimport { formatEntity, resolveComponent } from \"./resolve.js\"\nimport { searchDocs } from \"./search.js\"\nimport {\n  defineTool,\n  registerTool,\n  textContent,\n  textError,\n  type Tool,\n} from \"./tool.js\"\n\nconst require = createRequire(import.meta.url)\n// Package root is two levels up from dist/mcp/server.js (dist/mcp -> dist\n// -> package root). package.json ships in every npm tarball regardless of\n// the \"files\" allowlist, so this needs no extra packaging step.\nconst { version } = require(\"../../package.json\") as { version: string }\n\nconst SERVER_NAME = \"react-native-gtkx-mcp\"\nconst DEFAULT_SEARCH_LIMIT = 10\nconst MAX_SEARCH_LIMIT = 20\n\nconst listSurfaceShape = {\n  area: z\n    .enum(SURFACE_AREAS)\n    .optional()\n    .describe(\n      \"Area to list. Omit for an overview with counts across all areas: \" +\n        SURFACE_AREAS.join(\", \") +\n        \".\",\n    ),\n}\n\nconst describeComponentShape = {\n  name: z\n    .string()\n    .describe(\n      \"A component/API/widget name: a portable react-native export (e.g. \" +\n        '\"FlatList\"), a react-native-gtkx/gtk or /adw widget with or ' +\n        'without its Gtk/Adw prefix (e.g. \"Popover\" resolves to ' +\n        '\"GtkPopover\"), or a react-native-gtkx/common export (e.g. ' +\n        '\"NavigationStack\"). Case-insensitive.',\n    ),\n}\n\nconst searchDocsShape = {\n  query: z\n    .string()\n    .describe(\n      \"Free-text query — a symptom, a GTK term, an option name. Use this \" +\n        \"when rn_gtkx_describe_component does not have a name to look up, \" +\n        'e.g. \"known issues\", \"chrome content\", \"windowSize\".',\n    ),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(MAX_SEARCH_LIMIT)\n    .optional()\n    .describe(\n      `Maximum number of results (default ${DEFAULT_SEARCH_LIMIT}, max ${MAX_SEARCH_LIMIT}).`,\n    ),\n}\n\nconst listSurfaceTool = (): Tool =>\n  defineTool({\n    name: \"rn_gtkx_list_surface\",\n    title: \"List the react-native-gtkx surface\",\n    description:\n      \"Browse the react-native-gtkx surface without knowing an exact name first: \" +\n      \"portable react-native components/APIs, the react-native-gtkx/gtk and \" +\n      \"/adw widget lists (wrapped vs. raw), and react-native-gtkx/common. \" +\n      \"Without `area`, returns counts and where to look next.\",\n    inputSchema: listSurfaceShape,\n    handler: ({ area }) => textContent(listSurface(area)),\n  })\n\nconst describeComponentTool = (): Tool =>\n  defineTool({\n    name: \"rn_gtkx_describe_component\",\n    title: \"Describe a react-native-gtkx component\",\n    description:\n      \"Look up one component/widget/API by name: does it exist, which \" +\n      \"subpath it is exported from, what GTK widget backs it (for \" +\n      \"portable components), what differs from React Native, and whether \" +\n      \"a gtk/adw widget is wrapped (takes `style`/`onLayout`) or raw. The \" +\n      \"single most useful tool here — start with this before \" +\n      \"rn_gtkx_search_docs.\",\n    inputSchema: describeComponentShape,\n    handler: ({ name }) => {\n      const result = resolveComponent(name)\n      if (result.status === \"resolved\") {\n        const body = {\n          matchedBy: result.matchedBy,\n          ...formatEntity(result.entity),\n        }\n        return textContent(JSON.stringify(body, null, 2))\n      }\n      if (result.status === \"ambiguous\") {\n        const lines = result.candidates\n          .map((c) => `- ${c.name} (${c.subpath}, ${c.kind})`)\n          .join(\"\\n\")\n        return textError(\n          `\"${result.query}\" matches ${result.candidates.length} names — call again with one of:\\n${lines}`,\n        )\n      }\n      const lines = result.suggestions\n        .map((c) => `- ${c.name} (${c.subpath}, ${c.kind})`)\n        .join(\"\\n\")\n      return textError(\n        `No component named \"${result.query}\".` +\n          (lines.length > 0\n            ? ` Closest known names:\\n${lines}`\n            : \" rn_gtkx_list_surface has the full index.\"),\n      )\n    },\n  })\n\nconst searchDocsTool = (): Tool =>\n  defineTool({\n    name: \"rn_gtkx_search_docs\",\n    title: \"Search react-native-gtkx docs\",\n    description:\n      \"Free-text search over the docs (getting-started, the platform layer, \" +\n      \"gtkx rc.3 workarounds/quirks, navigation). The fallback tool: use it \" +\n      \"for symptoms and known-issue questions that rn_gtkx_describe_component \" +\n      \"cannot answer by name (workarounds are keyed by mechanism, not by \" +\n      \"component).\",\n    inputSchema: searchDocsShape,\n    handler: ({ query, limit }) => {\n      const results = searchDocs(query, limit ?? DEFAULT_SEARCH_LIMIT)\n      if (results.length === 0) {\n        return textContent(\n          `No matches for \"${query}\". Try rn_gtkx_list_surface or rn_gtkx_describe_component instead.`,\n        )\n      }\n      const body = results\n        .map((r) => `## ${r.doc} — ${r.heading}\\n\\n${r.text}`)\n        .join(\"\\n\\n---\\n\\n\")\n      return textContent(body)\n    },\n  })\n\nconst buildTools = (): Tool[] => [\n  listSurfaceTool(),\n  describeComponentTool(),\n  searchDocsTool(),\n]\n\nconst createMcpServer = (): McpServer => {\n  const server = new McpServer({ name: SERVER_NAME, version })\n  for (const tool of buildTools()) {\n    registerTool(server, tool)\n  }\n  return server\n}\n\nconst main = async (): Promise<void> => {\n  const server = createMcpServer()\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n}\n\nexport { buildTools, createMcpServer, main, SERVER_NAME }\n"]}

package/dist/mcp/tool.d.ts

@@ -0,0 +1,21 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { z } from "zod";
+type ToolArgs<Shape extends Record<string, z.ZodType>> = {
+    [K in keyof Shape]: z.output<Shape[K]>;
+};
+type Tool<Shape extends Record<string, z.ZodType> = Record<string, z.ZodType>> = {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Shape;
+    handler: (args: ToolArgs<Shape>) => CallToolResult;
+};
+declare const textContent: (text: string) => CallToolResult;
+declare const textError: (text: string) => CallToolResult;
+/** Identity function with a narrower input type — keeps tool definitions
+ * readable (named fields) while erasing the generic Shape at the call site,
+ * matching the pattern registerTool below expects. */
+declare const defineTool: <Shape extends Record<string, z.ZodType>>(tool: Tool<Shape>) => Tool;
+declare const registerTool: (server: McpServer, tool: Tool) => void;
+export { defineTool, registerTool, textContent, textError, type Tool, type ToolArgs, };

package/dist/mcp/tool.js

@@ -0,0 +1,36 @@
+const textContent = (text) => ({
+    content: [{ type: "text", text }],
+});
+const textError = (text) => ({
+    content: [{ type: "text", text }],
+    isError: true,
+});
+const errorToResult = (error) => textError(error instanceof Error ? error.message : String(error));
+const runTool = (handler, args) => {
+    try {
+        return handler(args);
+    }
+    catch (error) {
+        return errorToResult(error);
+    }
+};
+/** Identity function with a narrower input type — keeps tool definitions
+ * readable (named fields) while erasing the generic Shape at the call site,
+ * matching the pattern registerTool below expects. */
+const defineTool = (tool) => tool;
+const registerTool = (server, tool) => {
+    const callback = ((args) => runTool(tool.handler, args));
+    server.registerTool(tool.name, {
+        title: tool.title,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        annotations: {
+            title: tool.title,
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+    }, callback);
+};
+export { defineTool, registerTool, textContent, textError, };
+//# sourceMappingURL=tool.js.map