@gtkx/cli 1.4.0 → 1.6.0

package/dist/internal/agent-rules.js

@@ -0,0 +1,106 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { REFERENCE_PATH } from "../codegen/reference.js";
+const AGENTS_FILENAME = "AGENTS.md";
+const CLAUDE_FILENAME = "CLAUDE.md";
+const CLAUDE_CONTENTS = `@${AGENTS_FILENAME}\n`;
+const BEGIN_MARKER = "<!-- BEGIN:gtkx-agent-rules -->";
+const END_MARKER = "<!-- END:gtkx-agent-rules -->";
+const BLOCK_PATTERN = /<!-- BEGIN:gtkx-agent-rules -->[\s\S]*?<!-- END:gtkx-agent-rules -->/;
+const TOP_LEVEL_HEADING = /^# /m;
+const rulesBody = (heading) => [
+    `${heading} GTKX`,
+    "",
+    "This is not the GTK you have seen before. Most GTK code in your training data is C, PyGObject, Vala or " +
+        "GJS, and almost none of it is valid here. Check the rules below against what you are about to write.",
+    "",
+    "- Children are JSX, never `.append()`, `pack_start()`, `set_child()` or `add()`.",
+    '- Signals are props: `onClicked`, not `widget.connect("clicked", ...)`.',
+    "- Props are camelCase: `marginTop`, not `margin-top` or `margin_top`.",
+    "- There is no `Gtk.Template`, no `.ui` XML, and no `GtkBuilder`. The JSX tree is the definition.",
+    "- Elements come from `@gtkx/jsx/<namespace>` and classes, enums and functions from " +
+        "`@gtkx/gi/<namespace>`. Both are generated for this project by `gtkx codegen`, not installed from npm, " +
+        "so they match the GIR libraries this project declares.",
+    "",
+    `Read \`${REFERENCE_PATH}/index.md\` before writing widget code. It is generated from this project's own ` +
+        "GIR libraries and is the authority on which props, signals and methods exist. Do not infer a prop from " +
+        "another toolkit, from a C function name, or from a similar element.",
+    "",
+    "| Command | What it does |",
+    "| --- | --- |",
+    "| `gtkx dev` | Run the app with fast refresh |",
+    "| `gtkx codegen` | Regenerate bindings and this reference |",
+    "| `tsc --noEmit` | Typecheck |",
+    "| `vitest run` | Run the tests |",
+    "",
+    "Never call UI work done without looking at the running app. With `gtkx dev` up, the gtkx MCP server " +
+        "exposes the live widget tree, queries, clicks and screenshots; use them to confirm the change landed.",
+    "",
+    "This block is written by `gtkx codegen`. Anything outside the markers is yours and is left alone, and " +
+        "committing the block with your work keeps the tree clean.",
+];
+const renderBlock = (heading) => [BEGIN_MARKER, "", ...rulesBody(heading), "", END_MARKER].join("\n");
+const headingFor = (contents) => (TOP_LEVEL_HEADING.test(contents) ? "##" : "#");
+const withTrailingNewline = (contents) => (contents.endsWith("\n") ? contents : `${contents}\n`);
+const appendBlock = (contents, block) => {
+    if (contents.trim() === "") {
+        return `${block}\n`;
+    }
+    return `${withTrailingNewline(contents)}\n${block}\n`;
+};
+const replaceBlock = (contents, block) => {
+    const match = BLOCK_PATTERN.exec(contents);
+    if (match === null) {
+        return appendBlock(contents, block);
+    }
+    return contents.slice(0, match.index) + block + contents.slice(match.index + match[0].length);
+};
+const nextContents = (contents) => {
+    const heading = headingFor(contents.replace(BLOCK_PATTERN, ""));
+    return replaceBlock(contents, renderBlock(heading));
+};
+const errorCode = (error) => error instanceof Error ? error.code : undefined;
+const readOrUndefined = (path) => {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (error) {
+        if (errorCode(error) === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+};
+const hasWritten = (path, contents) => {
+    if (readOrUndefined(path) === contents) {
+        return false;
+    }
+    writeFileSync(path, contents);
+    return true;
+};
+const hasWrittenClaudeImport = (root) => {
+    try {
+        writeFileSync(join(root, CLAUDE_FILENAME), CLAUDE_CONTENTS, { flag: "wx" });
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === "EEXIST") {
+            return false;
+        }
+        throw error;
+    }
+};
+const upsertAgentRules = (root) => {
+    const agentsPath = join(root, AGENTS_FILENAME);
+    const existing = readOrUndefined(agentsPath) ?? "";
+    const files = [];
+    if (hasWritten(agentsPath, nextContents(existing))) {
+        files.push(AGENTS_FILENAME);
+    }
+    if (hasWrittenClaudeImport(root)) {
+        files.push(CLAUDE_FILENAME);
+    }
+    return { isWritten: files.length > 0, files };
+};
+export { upsertAgentRules };
+//# sourceMappingURL=agent-rules.js.map

package/dist/internal/agent-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-rules.js","sourceRoot":"","sources":["../../src/internal/agent-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAOzD,MAAM,eAAe,GAAG,WAAW,CAAC;AACpC,MAAM,eAAe,GAAG,WAAW,CAAC;AACpC,MAAM,eAAe,GAAG,IAAI,eAAe,IAAI,CAAC;AAChD,MAAM,YAAY,GAAG,iCAAiC,CAAC;AACvD,MAAM,UAAU,GAAG,+BAA+B,CAAC;AACnD,MAAM,aAAa,GAAG,sEAAsE,CAAC;AAC7F,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,CAAC,OAAe,EAAY,EAAE,CAAC;IAC7C,GAAG,OAAO,OAAO;IACjB,EAAE;IACF,yGAAyG;QACzG,sGAAsG;IACtG,EAAE;IACF,kFAAkF;IAClF,yEAAyE;IACzE,uEAAuE;IACvE,kGAAkG;IAClG,qFAAqF;QACrF,yGAAyG;QACzG,wDAAwD;IACxD,EAAE;IACF,UAAU,cAAc,kFAAkF;QAC1G,yGAAyG;QACzG,qEAAqE;IACrE,EAAE;IACF,4BAA4B;IAC5B,eAAe;IACf,gDAAgD;IAChD,6DAA6D;IAC7D,gCAAgC;IAChC,kCAAkC;IAClC,EAAE;IACF,sGAAsG;QACtG,uGAAuG;IACvG,EAAE;IACF,wGAAwG;QACxG,2DAA2D;CAC9D,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,OAAe,EAAU,EAAE,CAC5C,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEzE,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACjG,MAAM,mBAAmB,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC,CAAC;AAEjH,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,KAAa,EAAU,EAAE;IAC5D,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,OAAO,GAAG,KAAK,IAAI,CAAC;IACxB,CAAC;IAED,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,KAAK,KAAK,IAAI,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,KAAa,EAAU,EAAE;IAC7D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE3C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAClG,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC;IAEhE,OAAO,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,KAAc,EAAsB,EAAE,CACrD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAE,KAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAE/E,MAAM,eAAe,GAAG,CAAC,IAAY,EAAsB,EAAE;IACzD,IAAI,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAW,EAAE;IAC3D,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE9B,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,sBAAsB,GAAG,CAAC,IAAY,EAAW,EAAE;IACrD,IAAI,CAAC;QACD,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5E,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,MAAM,KAAK,CAAC;IAChB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAoB,EAAE;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,UAAU,CAAC,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["import { readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { REFERENCE_PATH } from \"../codegen/reference.js\";\n\ntype AgentRulesResult = {\n    isWritten: boolean;\n    files: string[];\n};\n\nconst AGENTS_FILENAME = \"AGENTS.md\";\nconst CLAUDE_FILENAME = \"CLAUDE.md\";\nconst CLAUDE_CONTENTS = `@${AGENTS_FILENAME}\\n`;\nconst BEGIN_MARKER = \"<!-- BEGIN:gtkx-agent-rules -->\";\nconst END_MARKER = \"<!-- END:gtkx-agent-rules -->\";\nconst BLOCK_PATTERN = /<!-- BEGIN:gtkx-agent-rules -->[\\s\\S]*?<!-- END:gtkx-agent-rules -->/;\nconst TOP_LEVEL_HEADING = /^# /m;\n\nconst rulesBody = (heading: string): string[] => [\n    `${heading} GTKX`,\n    \"\",\n    \"This is not the GTK you have seen before. Most GTK code in your training data is C, PyGObject, Vala or \" +\n    \"GJS, and almost none of it is valid here. Check the rules below against what you are about to write.\",\n    \"\",\n    \"- Children are JSX, never `.append()`, `pack_start()`, `set_child()` or `add()`.\",\n    '- Signals are props: `onClicked`, not `widget.connect(\"clicked\", ...)`.',\n    \"- Props are camelCase: `marginTop`, not `margin-top` or `margin_top`.\",\n    \"- There is no `Gtk.Template`, no `.ui` XML, and no `GtkBuilder`. The JSX tree is the definition.\",\n    \"- Elements come from `@gtkx/jsx/<namespace>` and classes, enums and functions from \" +\n    \"`@gtkx/gi/<namespace>`. Both are generated for this project by `gtkx codegen`, not installed from npm, \" +\n    \"so they match the GIR libraries this project declares.\",\n    \"\",\n    `Read \\`${REFERENCE_PATH}/index.md\\` before writing widget code. It is generated from this project's own ` +\n    \"GIR libraries and is the authority on which props, signals and methods exist. Do not infer a prop from \" +\n    \"another toolkit, from a C function name, or from a similar element.\",\n    \"\",\n    \"| Command | What it does |\",\n    \"| --- | --- |\",\n    \"| `gtkx dev` | Run the app with fast refresh |\",\n    \"| `gtkx codegen` | Regenerate bindings and this reference |\",\n    \"| `tsc --noEmit` | Typecheck |\",\n    \"| `vitest run` | Run the tests |\",\n    \"\",\n    \"Never call UI work done without looking at the running app. With `gtkx dev` up, the gtkx MCP server \" +\n    \"exposes the live widget tree, queries, clicks and screenshots; use them to confirm the change landed.\",\n    \"\",\n    \"This block is written by `gtkx codegen`. Anything outside the markers is yours and is left alone, and \" +\n    \"committing the block with your work keeps the tree clean.\",\n];\n\nconst renderBlock = (heading: string): string =>\n    [BEGIN_MARKER, \"\", ...rulesBody(heading), \"\", END_MARKER].join(\"\\n\");\n\nconst headingFor = (contents: string): string => (TOP_LEVEL_HEADING.test(contents) ? \"##\" : \"#\");\nconst withTrailingNewline = (contents: string): string => (contents.endsWith(\"\\n\") ? contents : `${contents}\\n`);\n\nconst appendBlock = (contents: string, block: string): string => {\n    if (contents.trim() === \"\") {\n        return `${block}\\n`;\n    }\n\n    return `${withTrailingNewline(contents)}\\n${block}\\n`;\n};\n\nconst replaceBlock = (contents: string, block: string): string => {\n    const match = BLOCK_PATTERN.exec(contents);\n\n    if (match === null) {\n        return appendBlock(contents, block);\n    }\n\n    return contents.slice(0, match.index) + block + contents.slice(match.index + match[0].length);\n};\n\nconst nextContents = (contents: string): string => {\n    const heading = headingFor(contents.replace(BLOCK_PATTERN, \"\"));\n\n    return replaceBlock(contents, renderBlock(heading));\n};\n\nconst errorCode = (error: unknown): string | undefined =>\n    error instanceof Error ? (error as NodeJS.ErrnoException).code : undefined;\n\nconst readOrUndefined = (path: string): string | undefined => {\n    try {\n        return readFileSync(path, \"utf8\");\n    } catch (error) {\n        if (errorCode(error) === \"ENOENT\") {\n            return undefined;\n        }\n\n        throw error;\n    }\n};\n\nconst hasWritten = (path: string, contents: string): boolean => {\n    if (readOrUndefined(path) === contents) {\n        return false;\n    }\n\n    writeFileSync(path, contents);\n\n    return true;\n};\n\nconst hasWrittenClaudeImport = (root: string): boolean => {\n    try {\n        writeFileSync(join(root, CLAUDE_FILENAME), CLAUDE_CONTENTS, { flag: \"wx\" });\n\n        return true;\n    } catch (error) {\n        if (errorCode(error) === \"EEXIST\") {\n            return false;\n        }\n\n        throw error;\n    }\n};\n\nconst upsertAgentRules = (root: string): AgentRulesResult => {\n    const agentsPath = join(root, AGENTS_FILENAME);\n    const existing = readOrUndefined(agentsPath) ?? \"\";\n    const files: string[] = [];\n\n    if (hasWritten(agentsPath, nextContents(existing))) {\n        files.push(AGENTS_FILENAME);\n    }\n\n    if (hasWrittenClaudeImport(root)) {\n        files.push(CLAUDE_FILENAME);\n    }\n\n    return { isWritten: files.length > 0, files };\n};\n\nexport { upsertAgentRules };\n"]}

package/dist/internal/docs-elements.d.ts

@@ -0,0 +1,8 @@
+import { type ElementProps, type OmittedProps } from "@gtkx/codegen";
+type DocsElements = {
+    props: ElementProps;
+    omittedProps: OmittedProps;
+};
+declare const resolveDocsElements: (cwd: string) => Promise<DocsElements>;
+export { resolveDocsElements };
+//# sourceMappingURL=docs-elements.d.ts.map

package/dist/internal/docs-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-elements.d.ts","sourceRoot":"","sources":["../../src/internal/docs-elements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAqC,MAAM,eAAe,CAAC;AAGxG,KAAK,YAAY,GAAG;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;CAC9B,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,YAAY,CAUpE,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/internal/docs-elements.js

@@ -0,0 +1,12 @@
+import { readBuiltinElements, resolveStore } from "@gtkx/codegen";
+import { existsSync } from "node:fs";
+const resolveDocsElements = async (cwd) => {
+    const { gi, reactSubexports } = resolveStore(cwd);
+    if (!existsSync(gi.storeDir)) {
+        return { props: {}, omittedProps: {} };
+    }
+    const { props, omittedProps } = await readBuiltinElements(reactSubexports, gi.storeDir);
+    return { props, omittedProps };
+};
+export { resolveDocsElements };
+//# sourceMappingURL=docs-elements.js.map

package/dist/internal/docs-elements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-elements.js","sourceRoot":"","sources":["../../src/internal/docs-elements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,mBAAmB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAOrC,MAAM,mBAAmB,GAAG,KAAK,EAAE,GAAW,EAAyB,EAAE;IACrE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,mBAAmB,CAAC,eAAe,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IAExF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,CAAC","sourcesContent":["import { type ElementProps, type OmittedProps, readBuiltinElements, resolveStore } from \"@gtkx/codegen\";\nimport { existsSync } from \"node:fs\";\n\ntype DocsElements = {\n    props: ElementProps;\n    omittedProps: OmittedProps;\n};\n\nconst resolveDocsElements = async (cwd: string): Promise<DocsElements> => {\n    const { gi, reactSubexports } = resolveStore(cwd);\n\n    if (!existsSync(gi.storeDir)) {\n        return { props: {}, omittedProps: {} };\n    }\n\n    const { props, omittedProps } = await readBuiltinElements(reactSubexports, gi.storeDir);\n\n    return { props, omittedProps };\n};\n\nexport { resolveDocsElements };\n"]}

package/dist/internal/source-imports.d.ts

@@ -1,8 +1,12 @@
+import type { ParserOptions } from "vite";
 type SourceImport = {
     importer: string;
     source: string;
 };
+type SourceLanguage = NonNullable<ParserOptions["lang"]>;
+declare const sourceLanguage: (path: string) => SourceLanguage | undefined;
+declare const discoverSourceFiles: (dir: string) => string[];
 declare const parseRuntimeImportsIn: (path: string) => SourceImport[] | null;
 declare const discoverSourceImports: (dir: string) => SourceImport[];
-export { discoverSourceImports, parseRuntimeImportsIn, type SourceImport };
+export { discoverSourceFiles, discoverSourceImports, parseRuntimeImportsIn, type SourceImport, sourceLanguage };
 //# sourceMappingURL=source-imports.d.ts.map

package/dist/internal/source-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-imports.d.ts","sourceRoot":"","sources":["../../src/internal/source-imports.ts"],"names":[],"mappings":"AAMA,KAAK,YAAY,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAgLF,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,YAAY,EAAE,GAAG,IACP,CAAC;AAKzD,QAAA,MAAM,qBAAqB,GAAI,KAAK,MAAM,KAAG,YAAY,EAMxD,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,CAAC"}
+{"version":3,"file":"source-imports.d.ts","sourceRoot":"","sources":["../../src/internal/source-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,aAAa,EAAE,MAAM,MAAM,CAAC;AAM/D,KAAK,YAAY,GAAG;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,cAAc,GAAG,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AAsBzD,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,cAAc,GAAG,SAMvD,CAAC;AAkCF,QAAA,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,EAKhD,CAAC;AA+EF,QAAA,MAAM,qBAAqB,GAAI,MAAM,MAAM,KAAG,YAAY,EAAE,GAAG,IACP,CAAC;AAKzD,QAAA,MAAM,qBAAqB,GAAI,KAAK,MAAM,KAAG,YAAY,EAKxD,CAAC;AAEF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/internal/source-imports.js

@@ -1,7 +1,7 @@
-import { isRecord, sortStringsBy } from "@gtkx/utils";
+import { sortStringsBy } from "@gtkx/utils";
 import { readdirSync, readFileSync } from "node:fs";
 import { extname, join } from "node:path";
-import { parseSync } from "vite";
+import { parseSync, Visitor } from "vite";
 const SOURCE_LANGUAGES = new Map([
     [".cjs", "jsx"],
     [".cts", "ts"],
@@ -13,8 +13,6 @@ const SOURCE_LANGUAGES = new Map([
     [".tsx", "tsx"],
 ]);
 const EXCLUDED_DIRECTORIES = new Set([
-    ".git",
-    ".gtkx",
     "build",
     "coverage",
     "dist",
@@ -27,10 +25,11 @@ const sourceLanguage = (path) => {
     }
     return SOURCE_LANGUAGES.get(extname(path).toLowerCase());
 };
+const isWalkableDirectory = (name) => !name.startsWith(".") && !EXCLUDED_DIRECTORIES.has(name);
 const collectSourceEntry = (dir, entry, found) => {
     const path = join(dir, entry.name);
     if (entry.isDirectory()) {
-        if (!EXCLUDED_DIRECTORIES.has(entry.name)) {
+        if (isWalkableDirectory(entry.name)) {
             sourceFilesIn(path, found);
         }
         return;
@@ -51,6 +50,11 @@ const sourceFilesIn = (dir, found) => {
         collectSourceEntry(dir, entry, found);
     }
 };
+const discoverSourceFiles = (dir) => {
+    const files = [];
+    sourceFilesIn(dir, files);
+    return sortStringsBy(files, (path) => path);
+};
 const staticImportSources = (module) => [
     ...module.staticImports.map((statement) => statement.moduleRequest.value),
     ...module.staticExports.flatMap((statement) => statement.entries
@@ -67,49 +71,24 @@ const staticRuntimeImportSources = (module) => [
         .filter((source) => source !== undefined)),
 ];
 const templateImportSource = (node) => {
-    if (!Array.isArray(node.expressions) || node.expressions.length > 0 || !Array.isArray(node.quasis)) {
-        return null;
-    }
-    const quasis = node.quasis;
-    const first = quasis[0];
-    if (!isRecord(first) || !isRecord(first.value)) {
-        return null;
-    }
-    return typeof first.value.cooked === "string" ? first.value.cooked : null;
+    const [quasi] = node.quasis;
+    return quasi === undefined || node.expressions.length > 0 ? null : quasi.value.cooked;
 };
 const literalImportSource = (node) => {
-    if (!isRecord(node)) {
-        return null;
-    }
-    if (node.type === "Literal") {
-        return typeof node.value === "string" ? node.value : null;
+    if (node.type === "TemplateLiteral") {
+        return templateImportSource(node);
     }
-    return node.type === "TemplateLiteral" ? templateImportSource(node) : null;
+    return node.type === "Literal" && typeof node.value === "string" ? node.value : null;
 };
-const collectDynamicImportArray = (nodes, found) => {
-    for (const child of nodes) {
-        collectDynamicImportSources(child, found);
-    }
-};
-const collectDynamicImportRecord = (node, found) => {
-    if (node.type === "ImportExpression") {
-        const source = literalImportSource(node.source);
-        if (source !== null) {
-            found.push(source);
-        }
-        return;
-    }
-    collectDynamicImportArray(Object.values(node), found);
-};
-const collectDynamicImportSources = (node, found) => {
-    if (Array.isArray(node)) {
-        collectDynamicImportArray(node, found);
-        return;
-    }
-    if (!isRecord(node)) {
-        return;
-    }
-    collectDynamicImportRecord(node, found);
+const collectDynamicImportSources = (program, found) => {
+    new Visitor({
+        ImportExpression: (node) => {
+            const source = literalImportSource(node.source);
+            if (source !== null) {
+                found.push(source);
+            }
+        },
+    }).visit(program);
 };
 const parseImportsInWith = (path, staticSources) => {
     const lang = sourceLanguage(path);
@@ -135,10 +114,9 @@ const parseRuntimeImportsIn = (path) => parseImportsInWith(path, staticRuntimeIm
 const importsIn = (path) => parseImportsIn(path) ?? [];
 const importKey = (entry) => `${entry.importer}\0${entry.source}`;
 const discoverSourceImports = (dir) => {
-    const files = [];
-    sourceFilesIn(dir, files);
+    const files = discoverSourceFiles(dir);
     const imports = files.flatMap((path) => importsIn(path));
     return sortStringsBy(imports, importKey);
 };
-export { discoverSourceImports, parseRuntimeImportsIn };
+export { discoverSourceFiles, discoverSourceImports, parseRuntimeImportsIn, sourceLanguage };
 //# sourceMappingURL=source-imports.js.map

package/dist/internal/source-imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-imports.js","sourceRoot":"","sources":["../../src/internal/source-imports.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ParseResult, ParserOptions } from \"vite\";\nimport { isRecord, sortStringsBy } from \"@gtkx/utils\";\nimport { type Dirent, readdirSync, readFileSync } from \"node:fs\";\nimport { extname, join } from \"node:path\";\nimport { parseSync } from \"vite\";\n\ntype SourceImport = {\n    importer: string;\n    source: string;\n};\n\ntype SourceLanguage = NonNullable<ParserOptions[\"lang\"]>;\ntype ParsedModule = ParseResult[\"module\"];\n\nconst SOURCE_LANGUAGES: Map<string, SourceLanguage> = new Map([\n    [\".cjs\", \"jsx\"],\n    [\".cts\", \"ts\"],\n    [\".js\", \"jsx\"],\n    [\".jsx\", \"jsx\"],\n    [\".mjs\", \"jsx\"],\n    [\".mts\", \"ts\"],\n    [\".ts\", \"ts\"],\n    [\".tsx\", \"tsx\"],\n]);\n\nconst EXCLUDED_DIRECTORIES: Set<string> = new Set([\n    \".git\",\n    \".gtkx\",\n    \"build\",\n    \"coverage\",\n    \"dist\",\n    \"node_modules\",\n    \"out-tsc\",\n]);\n\nconst sourceLanguage = (path: string): SourceLanguage | undefined => {\n    if (path.endsWith(\".d.ts\") || path.endsWith(\".d.cts\") || path.endsWith(\".d.mts\")) {\n        return undefined;\n    }\n\n    return SOURCE_LANGUAGES.get(extname(path).toLowerCase());\n};\n\nconst collectSourceEntry = (dir: string, entry: Dirent, found: string[]): void => {\n    const path = join(dir, entry.name);\n\n    if (entry.isDirectory()) {\n        if (!EXCLUDED_DIRECTORIES.has(entry.name)) {\n            sourceFilesIn(path, found);\n        }\n\n        return;\n    }\n\n    if (entry.isFile() && sourceLanguage(path) !== undefined) {\n        found.push(path);\n    }\n};\n\nconst sourceFilesIn = (dir: string, found: string[]): void => {\n    let entries: Dirent[];\n\n    try {\n        entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n        return;\n    }\n\n    for (const entry of entries) {\n        collectSourceEntry(dir, entry, found);\n    }\n};\n\nconst staticImportSources = (module: ParsedModule): string[] => [\n    ...module.staticImports.map((statement) => statement.moduleRequest.value),\n    ...module.staticExports.flatMap((statement) =>\n        statement.entries\n            .map((entry) => entry.moduleRequest?.value)\n            .filter((source): source is string => source !== undefined),\n    ),\n];\n\nconst staticRuntimeImportSources = (module: ParsedModule): string[] => [\n    ...module.staticImports\n        .filter((statement) => statement.entries.length === 0 || statement.entries.some((entry) => !entry.isType))\n        .map((statement) => statement.moduleRequest.value),\n    ...module.staticExports.flatMap((statement) =>\n        statement.entries\n            .filter((entry) => !entry.isType)\n            .map((entry) => entry.moduleRequest?.value)\n            .filter((source): source is string => source !== undefined),\n    ),\n];\n\nconst templateImportSource = (node: Record<string, unknown>): string | null => {\n    if (!Array.isArray(node.expressions) || node.expressions.length > 0 || !Array.isArray(node.quasis)) {\n        return null;\n    }\n\n    const quasis: unknown[] = node.quasis;\n    const first: unknown = quasis[0];\n\n    if (!isRecord(first) || !isRecord(first.value)) {\n        return null;\n    }\n\n    return typeof first.value.cooked === \"string\" ? first.value.cooked : null;\n};\n\nconst literalImportSource = (node: unknown): string | null => {\n    if (!isRecord(node)) {\n        return null;\n    }\n\n    if (node.type === \"Literal\") {\n        return typeof node.value === \"string\" ? node.value : null;\n    }\n\n    return node.type === \"TemplateLiteral\" ? templateImportSource(node) : null;\n};\n\nconst collectDynamicImportArray = (nodes: unknown[], found: string[]): void => {\n    for (const child of nodes) {\n        collectDynamicImportSources(child, found);\n    }\n};\n\nconst collectDynamicImportRecord = (node: Record<string, unknown>, found: string[]): void => {\n    if (node.type === \"ImportExpression\") {\n        const source = literalImportSource(node.source);\n\n        if (source !== null) {\n            found.push(source);\n        }\n\n        return;\n    }\n\n    collectDynamicImportArray(Object.values(node), found);\n};\n\nconst collectDynamicImportSources = (node: unknown, found: string[]): void => {\n    if (Array.isArray(node)) {\n        collectDynamicImportArray(node, found);\n\n        return;\n    }\n\n    if (!isRecord(node)) {\n        return;\n    }\n\n    collectDynamicImportRecord(node, found);\n};\n\nconst parseImportsInWith = (\n    path: string,\n    staticSources: (module: ParsedModule) => string[],\n): SourceImport[] | null => {\n    const lang = sourceLanguage(path);\n\n    if (lang === undefined) {\n        return [];\n    }\n\n    let parsed: ParseResult;\n\n    try {\n        parsed = parseSync(path, readFileSync(path, \"utf8\"), { lang });\n    } catch {\n        return null;\n    }\n\n    if (parsed.errors.length > 0) {\n        return null;\n    }\n\n    const sources = staticSources(parsed.module);\n    collectDynamicImportSources(parsed.program, sources);\n\n    return [...new Set(sources)].map((source) => ({ importer: path, source }));\n};\n\nconst parseImportsIn = (path: string): SourceImport[] | null => parseImportsInWith(path, staticImportSources);\n\nconst parseRuntimeImportsIn = (path: string): SourceImport[] | null =>\n    parseImportsInWith(path, staticRuntimeImportSources);\n\nconst importsIn = (path: string): SourceImport[] => parseImportsIn(path) ?? [];\nconst importKey = (entry: SourceImport): string => `${entry.importer}\\0${entry.source}`;\n\nconst discoverSourceImports = (dir: string): SourceImport[] => {\n    const files: string[] = [];\n    sourceFilesIn(dir, files);\n    const imports = files.flatMap((path) => importsIn(path));\n\n    return sortStringsBy(imports, importKey);\n};\n\nexport { discoverSourceImports, parseRuntimeImportsIn, type SourceImport };\n"]}
+{"version":3,"file":"source-imports.js","sourceRoot":"","sources":["../../src/internal/source-imports.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ESTree, ParseResult, ParserOptions } from \"vite\";\nimport { sortStringsBy } from \"@gtkx/utils\";\nimport { type Dirent, readdirSync, readFileSync } from \"node:fs\";\nimport { extname, join } from \"node:path\";\nimport { parseSync, Visitor } from \"vite\";\n\ntype SourceImport = {\n    importer: string;\n    source: string;\n};\n\ntype SourceLanguage = NonNullable<ParserOptions[\"lang\"]>;\ntype ParsedModule = ParseResult[\"module\"];\n\nconst SOURCE_LANGUAGES: Map<string, SourceLanguage> = new Map([\n    [\".cjs\", \"jsx\"],\n    [\".cts\", \"ts\"],\n    [\".js\", \"jsx\"],\n    [\".jsx\", \"jsx\"],\n    [\".mjs\", \"jsx\"],\n    [\".mts\", \"ts\"],\n    [\".ts\", \"ts\"],\n    [\".tsx\", \"tsx\"],\n]);\n\nconst EXCLUDED_DIRECTORIES: Set<string> = new Set([\n    \"build\",\n    \"coverage\",\n    \"dist\",\n    \"node_modules\",\n    \"out-tsc\",\n]);\n\nconst sourceLanguage = (path: string): SourceLanguage | undefined => {\n    if (path.endsWith(\".d.ts\") || path.endsWith(\".d.cts\") || path.endsWith(\".d.mts\")) {\n        return undefined;\n    }\n\n    return SOURCE_LANGUAGES.get(extname(path).toLowerCase());\n};\n\nconst isWalkableDirectory = (name: string): boolean => !name.startsWith(\".\") && !EXCLUDED_DIRECTORIES.has(name);\n\nconst collectSourceEntry = (dir: string, entry: Dirent, found: string[]): void => {\n    const path = join(dir, entry.name);\n\n    if (entry.isDirectory()) {\n        if (isWalkableDirectory(entry.name)) {\n            sourceFilesIn(path, found);\n        }\n\n        return;\n    }\n\n    if (entry.isFile() && sourceLanguage(path) !== undefined) {\n        found.push(path);\n    }\n};\n\nconst sourceFilesIn = (dir: string, found: string[]): void => {\n    let entries: Dirent[];\n\n    try {\n        entries = readdirSync(dir, { withFileTypes: true });\n    } catch {\n        return;\n    }\n\n    for (const entry of entries) {\n        collectSourceEntry(dir, entry, found);\n    }\n};\n\nconst discoverSourceFiles = (dir: string): string[] => {\n    const files: string[] = [];\n    sourceFilesIn(dir, files);\n\n    return sortStringsBy(files, (path) => path);\n};\n\nconst staticImportSources = (module: ParsedModule): string[] => [\n    ...module.staticImports.map((statement) => statement.moduleRequest.value),\n    ...module.staticExports.flatMap((statement) =>\n        statement.entries\n            .map((entry) => entry.moduleRequest?.value)\n            .filter((source): source is string => source !== undefined),\n    ),\n];\n\nconst staticRuntimeImportSources = (module: ParsedModule): string[] => [\n    ...module.staticImports\n        .filter((statement) => statement.entries.length === 0 || statement.entries.some((entry) => !entry.isType))\n        .map((statement) => statement.moduleRequest.value),\n    ...module.staticExports.flatMap((statement) =>\n        statement.entries\n            .filter((entry) => !entry.isType)\n            .map((entry) => entry.moduleRequest?.value)\n            .filter((source): source is string => source !== undefined),\n    ),\n];\n\nconst templateImportSource = (node: ESTree.TemplateLiteral): string | null => {\n    const [quasi] = node.quasis;\n\n    return quasi === undefined || node.expressions.length > 0 ? null : quasi.value.cooked;\n};\n\nconst literalImportSource = (node: ESTree.Expression): string | null => {\n    if (node.type === \"TemplateLiteral\") {\n        return templateImportSource(node);\n    }\n\n    return node.type === \"Literal\" && typeof node.value === \"string\" ? node.value : null;\n};\n\nconst collectDynamicImportSources = (program: ESTree.Program, found: string[]): void => {\n    new Visitor({\n        ImportExpression: (node) => {\n            const source = literalImportSource(node.source);\n\n            if (source !== null) {\n                found.push(source);\n            }\n        },\n    }).visit(program);\n};\n\nconst parseImportsInWith = (\n    path: string,\n    staticSources: (module: ParsedModule) => string[],\n): SourceImport[] | null => {\n    const lang = sourceLanguage(path);\n\n    if (lang === undefined) {\n        return [];\n    }\n\n    let parsed: ParseResult;\n\n    try {\n        parsed = parseSync(path, readFileSync(path, \"utf8\"), { lang });\n    } catch {\n        return null;\n    }\n\n    if (parsed.errors.length > 0) {\n        return null;\n    }\n\n    const sources = staticSources(parsed.module);\n    collectDynamicImportSources(parsed.program, sources);\n\n    return [...new Set(sources)].map((source) => ({ importer: path, source }));\n};\n\nconst parseImportsIn = (path: string): SourceImport[] | null => parseImportsInWith(path, staticImportSources);\n\nconst parseRuntimeImportsIn = (path: string): SourceImport[] | null =>\n    parseImportsInWith(path, staticRuntimeImportSources);\n\nconst importsIn = (path: string): SourceImport[] => parseImportsIn(path) ?? [];\nconst importKey = (entry: SourceImport): string => `${entry.importer}\\0${entry.source}`;\n\nconst discoverSourceImports = (dir: string): SourceImport[] => {\n    const files = discoverSourceFiles(dir);\n    const imports = files.flatMap((path) => importsIn(path));\n\n    return sortStringsBy(imports, importKey);\n};\n\nexport { discoverSourceFiles, discoverSourceImports, parseRuntimeImportsIn, type SourceImport, sourceLanguage };\n"]}

package/dist/mcp/client-config.d.ts

@@ -0,0 +1,22 @@
+type ClientName = "claude" | "cursor" | "vscode" | "opencode" | "codex";
+type ServerEntry = Record<string, unknown>;
+type Client = {
+    name: ClientName;
+    file: string;
+    key: string;
+    entry: ServerEntry;
+};
+type ClientResult = {
+    kind: "written";
+    path: string;
+    isCreated: boolean;
+} | {
+    kind: "manual";
+    path: string;
+    snippet: string;
+};
+declare const CLIENTS: Client[];
+declare const isClientName: (value: string) => value is ClientName;
+declare const writeClientConfig: (root: string, name: ClientName) => ClientResult;
+export { CLIENTS, isClientName, writeClientConfig, type ClientName, type ClientResult };
+//# sourceMappingURL=client-config.d.ts.map

package/dist/mcp/client-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.d.ts","sourceRoot":"","sources":["../../src/mcp/client-config.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AACxE,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3C,KAAK,MAAM,GAAG;IACV,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,KAAK,YAAY,GACX;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAatD,QAAA,MAAM,OAAO,EAAE,MAAM,EA+BpB,CAAC;AAIF,QAAA,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,UAAqC,CAAC;AAiDrF,QAAA,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,MAAM,UAAU,KAAG,YAe3D,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/dist/mcp/client-config.js

@@ -0,0 +1,94 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+const SERVER_NAME = "gtkx";
+const COMMAND = "npx";
+const ARGS = ["gtkx", "mcp"];
+const CODEX_PATH = "~/.codex/config.toml";
+const CODEX_SNIPPET = [
+    `[mcp_servers.${SERVER_NAME}]`,
+    `command = ${JSON.stringify(COMMAND)}`,
+    `args = ${JSON.stringify(ARGS)}`,
+].join("\n");
+const CLIENTS = [
+    {
+        name: "claude",
+        file: ".mcp.json",
+        key: "mcpServers",
+        entry: { command: COMMAND, args: ARGS },
+    },
+    {
+        name: "cursor",
+        file: join(".cursor", "mcp.json"),
+        key: "mcpServers",
+        entry: { command: COMMAND, args: ARGS },
+    },
+    {
+        name: "vscode",
+        file: join(".vscode", "mcp.json"),
+        key: "servers",
+        entry: { type: "stdio", command: COMMAND, args: ARGS },
+    },
+    {
+        name: "opencode",
+        file: "opencode.json",
+        key: "mcp",
+        entry: { type: "local", command: [COMMAND, ...ARGS], enabled: true },
+    },
+    {
+        name: "codex",
+        file: CODEX_PATH,
+        key: "mcp_servers",
+        entry: {},
+    },
+];
+const CLIENT_NAMES = new Set(CLIENTS.map((client) => client.name));
+const isClientName = (value) => CLIENT_NAMES.has(value);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const readOrUndefined = (path) => {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error && error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+};
+const readJson = (path) => {
+    const source = readOrUndefined(path);
+    if (source === undefined) {
+        return undefined;
+    }
+    const parsed = JSON.parse(source);
+    if (!isRecord(parsed)) {
+        throw new Error(`Refusing to edit ${path}: its contents are not a JSON object.`);
+    }
+    return parsed;
+};
+const getSection = (document, key) => {
+    const section = document[key];
+    return isRecord(section) ? section : {};
+};
+const clientFor = (name) => {
+    const client = CLIENTS.find((candidate) => candidate.name === name);
+    if (client === undefined) {
+        throw new Error(`Unknown MCP client "${name}".`);
+    }
+    return client;
+};
+const writeClientConfig = (root, name) => {
+    const client = clientFor(name);
+    if (name === "codex") {
+        return { kind: "manual", path: CODEX_PATH, snippet: CODEX_SNIPPET };
+    }
+    const path = join(root, client.file);
+    const existing = readJson(path);
+    const document = existing ?? {};
+    const section = { ...getSection(document, client.key), [SERVER_NAME]: client.entry };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify({ ...document, [client.key]: section }, null, 4)}\n`);
+    return { kind: "written", path, isCreated: existing === undefined };
+};
+export { CLIENTS, isClientName, writeClientConfig };
+//# sourceMappingURL=client-config.js.map

package/dist/mcp/client-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-config.js","sourceRoot":"","sources":["../../src/mcp/client-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\ntype ClientName = \"claude\" | \"cursor\" | \"vscode\" | \"opencode\" | \"codex\";\ntype ServerEntry = Record<string, unknown>;\n\ntype Client = {\n    name: ClientName;\n    file: string;\n    key: string;\n    entry: ServerEntry;\n};\n\ntype ClientResult =\n    | { kind: \"written\"; path: string; isCreated: boolean } |\n    { kind: \"manual\"; path: string; snippet: string };\n\nconst SERVER_NAME = \"gtkx\";\nconst COMMAND = \"npx\";\nconst ARGS = [\"gtkx\", \"mcp\"];\nconst CODEX_PATH = \"~/.codex/config.toml\";\n\nconst CODEX_SNIPPET = [\n    `[mcp_servers.${SERVER_NAME}]`,\n    `command = ${JSON.stringify(COMMAND)}`,\n    `args = ${JSON.stringify(ARGS)}`,\n].join(\"\\n\");\n\nconst CLIENTS: Client[] = [\n    {\n        name: \"claude\",\n        file: \".mcp.json\",\n        key: \"mcpServers\",\n        entry: { command: COMMAND, args: ARGS },\n    },\n    {\n        name: \"cursor\",\n        file: join(\".cursor\", \"mcp.json\"),\n        key: \"mcpServers\",\n        entry: { command: COMMAND, args: ARGS },\n    },\n    {\n        name: \"vscode\",\n        file: join(\".vscode\", \"mcp.json\"),\n        key: \"servers\",\n        entry: { type: \"stdio\", command: COMMAND, args: ARGS },\n    },\n    {\n        name: \"opencode\",\n        file: \"opencode.json\",\n        key: \"mcp\",\n        entry: { type: \"local\", command: [COMMAND, ...ARGS], enabled: true },\n    },\n    {\n        name: \"codex\",\n        file: CODEX_PATH,\n        key: \"mcp_servers\",\n        entry: {},\n    },\n];\n\nconst CLIENT_NAMES: Set<string> = new Set(CLIENTS.map((client) => client.name));\n\nconst isClientName = (value: string): value is ClientName => CLIENT_NAMES.has(value);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst readOrUndefined = (path: string): string | undefined => {\n    try {\n        return readFileSync(path, \"utf8\");\n    } catch (error) {\n        if (error instanceof Error && (error as NodeJS.ErrnoException).code === \"ENOENT\") {\n            return undefined;\n        }\n\n        throw error;\n    }\n};\n\nconst readJson = (path: string): Record<string, unknown> | undefined => {\n    const source = readOrUndefined(path);\n\n    if (source === undefined) {\n        return undefined;\n    }\n\n    const parsed: unknown = JSON.parse(source);\n\n    if (!isRecord(parsed)) {\n        throw new Error(`Refusing to edit ${path}: its contents are not a JSON object.`);\n    }\n\n    return parsed;\n};\n\nconst getSection = (document: Record<string, unknown>, key: string): Record<string, unknown> => {\n    const section = document[key];\n\n    return isRecord(section) ? section : {};\n};\n\nconst clientFor = (name: ClientName): Client => {\n    const client = CLIENTS.find((candidate) => candidate.name === name);\n\n    if (client === undefined) {\n        throw new Error(`Unknown MCP client \"${name}\".`);\n    }\n\n    return client;\n};\n\nconst writeClientConfig = (root: string, name: ClientName): ClientResult => {\n    const client = clientFor(name);\n\n    if (name === \"codex\") {\n        return { kind: \"manual\", path: CODEX_PATH, snippet: CODEX_SNIPPET };\n    }\n\n    const path = join(root, client.file);\n    const existing = readJson(path);\n    const document = existing ?? {};\n    const section = { ...getSection(document, client.key), [SERVER_NAME]: client.entry };\n    mkdirSync(dirname(path), { recursive: true });\n    writeFileSync(path, `${JSON.stringify({ ...document, [client.key]: section }, null, 4)}\\n`);\n\n    return { kind: \"written\", path, isCreated: existing === undefined };\n};\n\nexport { CLIENTS, isClientName, writeClientConfig, type ClientName, type ClientResult };\n"]}

package/dist/mcp/client.d.ts

@@ -19,7 +19,6 @@ declare class McpClient {
     private attemptConnect;
     private scheduleReconnect;
     private register;
-    private respondToRequest;
     private handleRequest;
     connect(): Promise<void>;
     disconnect(): void;

package/dist/mcp/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAQA,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AA2CF,cAAM,SAAS;IACX,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,OAAO,EAAE,gBAAgB;IAKrC,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;YAUX,kBAAkB;IAWhC,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;YAgBF,gBAAgB;YAuBhB,aAAa;IAQrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,UAAU,IAAI,IAAI;CAwBrB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/mcp/client.ts"],"names":[],"mappings":"AAcA,KAAK,gBAAgB,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACzB,CAAC;AAsCF,cAAM,SAAS;IACX,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,OAAO,EAAE,gBAAgB;IAKrC,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;YAUX,kBAAkB;IAWhC,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,aAAa;IAYf,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B,UAAU,IAAI,IAAI;CAsBrB;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/mcp/client.js

@@ -1,16 +1,13 @@
 import * as Gio from "@gtkx/gi/gio";
 import * as Gtk from "@gtkx/gi/gtk";
-import { DEFAULT_SOCKET_PATH, ErrorCode, ProtocolConnection, ProtocolError } from "@gtkx/mcp/internal";
-import { error, errorMessage, info, normalizeError, warn } from "@gtkx/utils";
+import { DEFAULT_SOCKET_PATH, isConnectionClosedError, ProtocolConnection, } from "@gtkx/mcp/internal";
+import { error, errorMessage, info, normalizeError } from "@gtkx/utils";
 import * as net from "node:net";
 import { dispatch } from "./handlers.js";
 import { WidgetRegistry } from "./widget-registry.js";
 const RECONNECT_DELAY_MS = 2000;
 const REGISTER_TIMEOUT_MS = 30_000;
 const DISCONNECT_ERROR_CODES = new Set(["ENOENT", "ECONNREFUSED", "EPIPE", "ECONNRESET"]);
-const toResponseError = (error) => error instanceof ProtocolError
-    ? error.toErrorObject()
-    : { code: ErrorCode.INTERNAL_ERROR, message: errorMessage(error) };
 const connectSettler = (callbacks) => {
     let isSettled = false;
     const settle = (notify) => {
@@ -54,7 +51,7 @@ class McpClient {
     }
     handleSocketError(socketError) {
         const code = socketError.code;
-        if (code !== undefined && DISCONNECT_ERROR_CODES.has(code)) {
+        if (isConnectionClosedError(socketError) || (code !== undefined && DISCONNECT_ERROR_CODES.has(code))) {
             this.scheduleReconnect();
         }
         else {
@@ -88,12 +85,7 @@ class McpClient {
                 settle.fail(socketError);
             },
         });
-        connection.on("request", (request) => {
-            void this.handleRequest(request);
-        });
-        connection.on("invalid", ({ error: parseError }) => {
-            warn(`Received invalid JSON from MCP server: ${parseError.message}`);
-        });
+        connection.fallbackRequestHandler = (request) => this.handleRequest(request);
         this.socket = socket;
         this.connection = connection;
     }
@@ -116,32 +108,13 @@ class McpClient {
             projectRoot: process.cwd(),
         }, REGISTER_TIMEOUT_MS);
     }
-    async respondToRequest(request) {
-        const { id, method, params } = request;
-        const connection = this.connection;
-        if (!connection) {
-            return;
-        }
-        try {
-            const defaultApp = Gio.Application.getDefault();
-            if (!(defaultApp instanceof Gtk.Application)) {
-                throw new TypeError("Application not initialized");
-            }
-            this.registry.refresh();
-            const result = await dispatch(method, params, { app: defaultApp, registry: this.registry });
-            connection.write({ id, result });
-        }
-        catch (dispatchError) {
-            connection.write({ id, error: toResponseError(dispatchError) });
-        }
-    }
-    async handleRequest(request) {
-        try {
-            await this.respondToRequest(request);
-        }
-        catch (requestError) {
-            error("Error handling request:", requestError);
+    handleRequest(request) {
+        const defaultApp = Gio.Application.getDefault();
+        if (!(defaultApp instanceof Gtk.Application)) {
+            throw new TypeError("Application not initialized");
         }
+        this.registry.refresh();
+        return dispatch(request.method, request.params, { app: defaultApp, registry: this.registry });
     }
     async connect() {
         return new Promise((resolve, reject) => {
@@ -168,9 +141,8 @@ class McpClient {
             clearTimeout(this.reconnectTimer);
             this.reconnectTimer = null;
         }
-        this.connection?.rejectPending(new Error("Client disconnected"));
         if (this.socket) {
-            this.connection?.write({ id: crypto.randomUUID(), method: "app.unregister" });
+            void Promise.allSettled([this.connection?.send("app.unregister")]);
             this.socket.destroy();
             this.socket = null;
         }