jui-tools-mcp-server 2.12.8 → 2.12.10

package/data/attribute_definitions.json

@@ -3772,14 +3772,14 @@
     },
     "keyboardAvoidance": {
       "type": "boolean",
-      "description": "Enable keyboard avoidance (default true). iOS: AdvancedKeyboardAvoidingScrollView with the configuration disabled when false. Android: imePadding() and the keyboardAvoidancePadding clearance are emitted only when not false. Declared swift-only from the initial commit while the kjui codegen had read it all along (2026-09-22).",
+      "description": "Enable keyboard avoidance (default true). iOS: AdvancedKeyboardAvoidingScrollView with the configuration disabled when false. Android: KotlinJsonUI's Modifier.keyboardAvoidance (imePadding, the keyboardAvoidancePadding clearance, and scrolling the focused field up once the IME is up) is applied only when not false; both the codegen emit and the dynamic ScrollView call it. Declared swift-only from the initial commit while the kjui codegen had read it all along (2026-09-22).",
       "platform": ["swift", "kotlin"]
     },
     "keyboardAvoidancePadding": {
       "type": "number",
       "platform": ["swift", "kotlin"],
       "default": 20,
-      "description": "Clearance, in points/dp, that a focused text field keeps from the ScrollView's VISIBLE bottom edge while the soft keyboard is up. The edge is whatever bounds the scroll area at that moment: the top of a fixed footer laid out below the ScrollView, or the keyboard itself when the ScrollView meets it directly. Default 20 (the platform keyboard-avoidance default; absent means 20, not 0). iOS: KeyboardAvoidanceConfiguration.additionalPadding, applied as a bottom safe-area inset while the keyboard is visible. Android: bottom padding on the scrollable after imePadding() while the IME is visible, so bringIntoView stops that far above it. Ignored when keyboardAvoidance is false. Web: not applicable (no soft-keyboard avoidance in the web renderer)."
+      "description": "Clearance, in points/dp, that a focused text field keeps from the ScrollView's VISIBLE bottom edge while the soft keyboard is up. The edge is whatever bounds the scroll area at that moment: the top of a fixed footer laid out below the ScrollView, or the keyboard itself when the ScrollView meets it directly. Default 20 (the platform keyboard-avoidance default; absent means 20, not 0). iOS: KeyboardAvoidanceConfiguration.additionalPadding, applied as a bottom safe-area inset while the keyboard is visible. Android: Modifier.keyboardAvoidance ends the scrollable's viewport that far above the IME while it is visible and scrolls the focused field to the viewport's edge once the IME is up (until 2.37.0 the follow was left to Compose's built-in tracking, which a device measured not doing it, 2026-09-22). Ignored when keyboardAvoidance is false. Web: not applicable (no soft-keyboard avoidance in the web renderer)."
     },
     "scrollBehavior": {
       "type": "string",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jui-tools-mcp-server",
-  "version": "2.12.8",
+  "version": "2.12.10",
   "description": "MCP server for JsonUI project management - wraps jui and jsonui-doc CLIs plus component spec lookup",
   "main": "dist/index.js",
   "scripts": {

package/scripts/fetch-definitions.js

@@ -44,7 +44,7 @@ const DATA_DIR = join(PROJECT_ROOT, "data");
 //   3. `npm run fetch-definitions` and commit the data/ diff together with
 //      this pin in one commit
 // JSONUI_CLI_RAW_BASE still overrides the whole base URL for manual testing.
-const JSONUI_CLI_TAG = "v1.8.109";
+const JSONUI_CLI_TAG = "v1.8.110";
 const BASE_URL =
   process.env.JSONUI_CLI_RAW_BASE ||
   `https://raw.githubusercontent.com/Tai-Kimura/jsonui-cli/${JSONUI_CLI_TAG}`;

package/src/tools/jui/jui_generate_converter.ts

@@ -14,9 +14,15 @@ export function register(server: McpServer, config: ServerConfig) {
       attributes: z.string().optional().describe("Attributes in key:type format (e.g., 'prop1:String,prop2:Int')"),
       container: z.boolean().optional().describe("Mark as container component"),
       skip_existing: z.boolean().optional().describe(
-        "Leave existing converter files untouched (no overwrite prompt). " +
-        "`jui build` enables this automatically; pass it here for idempotent " +
-        "explicit scaffold runs."
+        "Leave existing converter and scaffold files untouched, without the " +
+        "overwrite prompt — for idempotent scaffold runs. Wins over `force` " +
+        "when both are set."
+      ),
+      force: z.boolean().optional().describe(
+        "Replace existing converter and scaffold files without the overwrite " +
+        "prompt. The scaffolds are the project's own code: edits made in them " +
+        "are lost. Needs jsonui-cli 1.8.113 or later (earlier `jui` rejects " +
+        "--force)."
       ),
       project_dir: z.string().optional().describe("Project directory (overrides JUI_PROJECT_DIR env)"),
     },
@@ -30,6 +36,7 @@ export function register(server: McpServer, config: ServerConfig) {
         if (params.attributes) { args.push("--attributes", params.attributes); }
         if (params.container) { args.push("--container"); }
         if (params.skip_existing) { args.push("--skip-existing"); }
+        if (params.force) { args.push("--force"); }
 
         const result = await runCli("jui", args, { cwd: projectDir });
         return { content: [{ type: "text", text: formatResult(result) }] };

package/tests/tools_cli.test.ts

@@ -284,6 +284,28 @@ describe("jui_generate_converter", () => {
       "--all",
     ]);
   });
+
+  // `jui g converter --force` exists from jsonui-cli 1.8.113; the tool had no
+  // way to pass it.
+  it("passes --force only when asked", async () => {
+    await harness.call("jui_generate_converter", {
+      all: true,
+      force: true,
+      project_dir: projectDir,
+    });
+    await harness.call("jui_generate_converter", { all: true, project_dir: projectDir });
+    expect(recorded[0].args).toEqual(["generate", "converter", "--all", "--force"]);
+    expect(recorded[1].args).toEqual(["generate", "converter", "--all"]);
+  });
+
+  // The description said "`jui build` enables this automatically": the build
+  // has not generated converters for a long time (jsonui-cli 1.8.113 removed
+  // the same sentence from its own docstring).
+  it("does not tell the agent that jui build skips existing converters", () => {
+    const schema = harness.tools.get("jui_generate_converter")!.schema;
+    expect(schema.skip_existing.description).not.toContain("jui build");
+    expect(schema.force.description).toContain("1.8.113");
+  });
 });
 
 describe("jui_verify", () => {