jui-tools-mcp-server 2.12.10 → 2.14.0

package/data/attribute_semantics.json

@@ -85,7 +85,7 @@
       "omittedEntirely": "same as the default: top | start. Omitting gravity must render identically to naming the default explicitly",
       "leafOwnFrameChannel": {
         "default": "center",
-        "ruling": "2026-08-08 adjudication (gravity leaf-scope hotfix, v1.5.2/10.15.1): the container default above scopes to CONTAINERS — nodes whose content the framework itself lays out. A childless node's own-frame content (a fit image's bitmap inside its declared box, a custom component's internals, a text block smaller than its fixed box) is a SEPARATE channel whose default is Center: Compose's Image/extension alignment default, which kjui never overrides, and the position the android face measurably draws a shrunken autoShrink line in its fixed box. ios converged in SwiftJsonUI 245d059+4d41bf9 (codegen gravity_to_frame_alignment leaf scope; dynamic fixed-frame text drop). A DECLARED gravity or textAlign still applies to any node — this entry names only the omitted-spelling default. Implementations were aligned BEFORE this text landed; the entry records the ruling the code already obeys."
+        "ruling": "2026-08-08 adjudication (gravity leaf-scope hotfix, v1.5.2/10.15.1): the container default above scopes to CONTAINERS — nodes whose content the framework itself lays out. A childless node's own-frame content (a fit image's bitmap inside its declared box, a custom component's internals, a text block smaller than its fixed box) is a SEPARATE channel whose default is Center: Compose's Image/extension alignment default, which kjui never overrides, and the position the android face measurably draws a shrunken autoShrink line in its fixed box. ios converged in SwiftJsonUI 245d059+4d41bf9 (codegen gravity_to_frame_alignment leaf scope; dynamic fixed-frame text drop). A DECLARED gravity or textAlign still applies to any node — this entry names only the omitted-spelling default. Implementations were aligned BEFORE this text landed; the entry records the ruling the code already obeys. 2026-09-27 (4f ruling, round 17): a Label's text in a frame taller than it (a numeric, matchParent or minHeight height, or a weight along its column) had not been: Compose drew it at the frame's top whatever the gravity — kjui for a numeric height, KotlinJsonUI Dynamic for every frame. From jsonui-cli 1.9.0 both Compose paths place it by the gravity's vertical part (top, bottom, the centre for center / centerVertical) and in the centre when the gravity names none, inside the Label's background and padding, as iOS does (sjui 19bf7b94, SwiftJsonUI f776b88)."
       }
     },
     "shadow": {
@@ -352,6 +352,7 @@
       ],
       "noOpWhereNoSeparators": "a container that draws no separators satisfies hideSeparator vacuously — that is a no-op by contract, not an unimplemented gap",
       "orthogonality": "listStyle picks the chrome, hideSeparator hides the separators; neither overrides the other",
+      "update_2026_09_26": "The ruling below describes 2026-08-07. Two of its facts have moved: TableConverter no longer exists (Table, List and ListView draw as Collection — shared/core/type_synonyms.json), and the attribute descriptions no longer say which faces read these attributes or that the coverage rows are runtime-only — which faces implement them is the coverage ledger's to say, measured, not a declaration's. The contract itself (the no-op where there are no separators, the orthogonality, the vocabulary) is unchanged.",
       "ruling": "2026-08-07 (plan 51-E), raised by B: the ios probe path is CollectionStackView, not SwiftUI's List, and a container that is not a list has no separators to hide — so what should `hideSeparator` draw there? NOTHING, and that is the contract, not a gap. 'Hide the separators' is vacuously satisfied where there are none. The scope is deliberately NOT narrowed: the axis here is the container's rendered SHAPE (Collection's own `layout`, `columns` and `orientation` decide whether it is list-shaped), and `platform` / `mode` cannot express that — narrowing by platform would say something false. More importantly, 'implement it' must NOT mean 'switch the container to a List': an attribute that reshapes the thing it modifies is the defect family this wave exists to remove. hideSeparator modifies a list; it does not create one. MEASUREMENT CONSEQUENCE, so the ledgers do not mis-file it: the fixture must use a list-shaped Collection to observe this at all. Inert on a non-list container is the CONTRACT being honoured, and the coverage rows for both attributes are `runtime-only` (ios dynamic implements them; no codegen face does) rather than `unimplemented`. listStyle: enumerated here from the only implementation that reads it (SwiftJsonUI TableConverter.applyListStyle) as plain / grouped / insetGrouped / sidebar with plain the default — B was right that a bare string could not be validated or discriminated, and B should not replace the hardcoded PlainListStyle() until the vocabulary exists, which it now does. THE TWO ARE ORTHOGONAL. TableConverter.swift:45-49 currently lets `hideSeparator: true` win and forces .plain, which makes a declared `listStyle: \"grouped\"` silently inert whenever separators are hidden — the same silently-inert-declaration shape again. `.listRowSeparator(.hidden)` applies to any list style, so there is no need to force plain. Owner: F.",
       "observable": {}
     },
@@ -378,6 +379,22 @@
       "defaultRange": "0 .. 1",
       "ruling": "2026-08-07 (plan 51-E), raised by E2 with all three converters measured: none of them had a declared default to read, so each invented one — sjui `max || 1`, kjui and rjui `max || 100`. A layout writing `value: 0.5` therefore sits mid-track on ios and at half a percent on android and web. IOS IS CANON: the default range is 0 .. 1. The ground is this SSoT's own convention for a unitless value on a track, not a head count. `Progress.progress` declares `min: 0, max: 1` and `common.opacity` declares `min: 0, max: 1`; Progress is the Slider's closest sibling — a number along a track — and 100 would make Slider the only such attribute in the SSoT that is not normalised. It also keeps the round-trip coherent: `Slider.value` is declared two-way, so under a 0..100 default the control writes 0..100 back into a viewmodel whose author was writing 0..1. Declared as `default` on minimum and maximum so no converter has to invent it again; `range` is the [min, max] shorthand, so its absence means [0, 1] too. CONSEQUENCE FOR WEB, so that fixing the range does not break the control: `Slider.step` is declared platform:react with no default, and E2 measured web rounding 0.5 up to 1 under the old 0..100 range. With a 0..1 range an implicit step of 1 collapses the slider to two positions, so the web default step must be continuous (HTML `step=\"any\"`) unless the layout declares one. Owner: A for the step, A and C for the range.",
       "observable": {}
+    },
+    "collectionSpacing": {
+      "attributes": [
+        "Collection.lineSpacing",
+        "Collection.columnSpacing",
+        "Collection.itemSpacing"
+      ],
+      "undeclaredDefault": "0 on every route (vertical list and stack, grid, horizontal lanes and pages, flow) and on every path (sjui, kjui and rjui codegen; SwiftJsonUI and KotlinJsonUI Dynamic). A declared value is drawn as declared, 0 included.",
+      "chains": {
+        "vertical": "between rows: lineSpacing, else itemSpacing, else 0",
+        "grid": "between rows: lineSpacing, else itemSpacing, else 0; between columns: columnSpacing, else itemSpacing, else 0 — columnSpacing never spaces the rows",
+        "horizontal": "along the scroll axis, pages included: lineSpacing, else itemSpacing, else 0; between lanes: columnSpacing, else itemSpacing, else 0",
+        "flow": "between the cells of a line: columnSpacing, else itemSpacing, else 0; between lines, and between the section blocks, each section its own wrap: lineSpacing, else itemSpacing, else 0"
+      },
+      "ruling": "2026-09-26 (4f, round 5 of the Collection audit). Until jsonui-cli 1.9.0 no declaration said what an undeclared Collection spacing draws, and the paths had each picked one: 0 everywhere except the flow route on iOS — sjui codegen 8 between cells, lines and section blocks; SwiftJsonUI Dynamic 8 on the lazy flow (its section blocks the ScrollView's own stack spacing) and `x > 0 ? x : 8` on the `lazy: none` flow, so a declared 0 drew 8. Android and web drew 0. The ruling: 0, flow included, on every route and every path. Declared HERE and not as a `default` in attribute_definitions.json, on purpose: a `default` there changes the attribute's kind — the conformance fixture generator writes the declared default as the fixture's value, the inert audit lists it, and attr codegen carries it into the generated tables — and the rule is per route, which one scalar cannot say. `sectionSpacing` is lineSpacing's alias (definitions `aliases`). Toolchain comments point here.",
+      "observable": {}
     }
   }
 }

package/data/component_metadata.json

@@ -2,6 +2,7 @@
   "_description": "Per-component presentation metadata consumed by jsonui-mcp-server. Augments attribute_definitions.json (which defines the raw attribute schema, including binding_direction per attribute) with human descriptions, aliases, platform availability, platform-specific implementation notes, and agent-facing rules. Edit this file to change what `lookup_component` / `search_components` / `lookup_attribute` return from the MCP.",
   "_schema": {
     "description": "string",
+    "interactive": "boolean — REQUIRED on every type: whether a user can operate this component on its own (a control, an input, or a scrolling / embedding container). A tappable that holds one is not flattened into a single button for screen readers (shared/core/tap_accessibility.rb). Declared, never derived: Button, Radio and Web declare no two-way binding and are operable.",
     "aliases": "string[]",
     "platforms": {
       "swift_generated": "boolean",
@@ -15,6 +16,7 @@
   },
   "Label": {
     "description": "Text display component",
+    "interactive": false,
     "aliases": [
       "Text"
     ],
@@ -49,6 +51,7 @@
   },
   "TextField": {
     "description": "Text input field",
+    "interactive": true,
     "aliases": [
       "EditText",
       "Input"
@@ -86,6 +89,7 @@
   },
   "Button": {
     "description": "Tappable button component",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -117,6 +121,7 @@
   },
   "Image": {
     "description": "Local image component",
+    "interactive": false,
     "aliases": [
       "CircleImage",
       "CircleImageView",
@@ -153,6 +158,7 @@
   },
   "NetworkImage": {
     "description": "Remote/network image component",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -174,12 +180,12 @@
       }
     },
     "rules": [
-      "Default contentMode is .center for matchParent (Swift)",
       "Supports placeholder/error images via defaultImage"
     ]
   },
   "View": {
     "description": "Container view (HStack/VStack/ZStack)",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -212,6 +218,7 @@
   },
   "ScrollView": {
     "description": "Scrollable container",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -238,6 +245,7 @@
   },
   "Collection": {
     "description": "List/grid collection with data binding",
+    "interactive": true,
     "aliases": [
       "Table",
       "TableView",
@@ -270,11 +278,12 @@
       "Sections support different cell types per section",
       "cellIdProperty extracts unique keys from item data",
       "scrollTo binding enables programmatic scrolling",
-      "lazy (default true) controls virtualization: true uses LazyVStack/LazyColumn/LazyVerticalGrid with internal scroll; false renders eagerly in a plain VStack/Column with NO scroll container (use when nested in an already-scrollable parent). Sticky headers and paging require lazy: true."
+      "lazy (default 'lazy') is the outer container: 'lazy' virtualizes (LazyVStack/LazyColumn/LazyVerticalGrid with internal scroll); 'eager' draws every cell in a scroll container, with no virtualization; 'none' draws them with NO scroll container (use when nested in an already-scrollable parent). Sticky headers and paging require 'lazy'."
     ]
   },
   "Switch": {
     "description": "Toggle switch (iOS style)",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -302,6 +311,7 @@
   },
   "Toggle": {
     "description": "Toggle control (checkbox style)",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -328,6 +338,7 @@
   },
   "CheckBox": {
     "description": "Checkbox input",
+    "interactive": true,
     "aliases": [
       "Check",
       "Checkbox"
@@ -357,6 +368,7 @@
   },
   "Radio": {
     "description": "Radio button group",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -382,6 +394,7 @@
   },
   "SelectBox": {
     "description": "Dropdown/picker selection",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -407,6 +420,7 @@
   },
   "Segment": {
     "description": "Segmented control",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -433,6 +447,7 @@
   },
   "Slider": {
     "description": "Slider/range input",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -454,12 +469,13 @@
     },
     "rules": [
       "value/bind is two-way binding",
-      "minimumValue/maximumValue define range (default 0-100)",
+      "minimum / maximum define the range (default 0 and 1: with neither set the range is 0 .. 1); minimumValue / minValue and maximumValue / maxValue are alias spellings",
       "step defines discrete steps"
     ]
   },
   "Progress": {
     "description": "Progress bar/indicator",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -485,6 +501,7 @@
   },
   "Indicator": {
     "description": "Activity indicator / loading spinner",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -508,11 +525,12 @@
   },
   "CircleView": {
     "description": "Circular shape view",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": false,
       "swift_dynamic": false,
-      "kotlin_generated": false,
+      "kotlin_generated": true,
       "kotlin_dynamic": true,
       "react": true
     },
@@ -531,6 +549,7 @@
   },
   "GradientView": {
     "description": "Gradient background view",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -556,6 +575,7 @@
   },
   "Blur": {
     "description": "Blur effect view",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -581,6 +601,7 @@
   },
   "IconLabel": {
     "description": "Icon with label combination",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -606,6 +627,7 @@
   },
   "Web": {
     "description": "Web view / embedded browser",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -626,11 +648,13 @@
       }
     },
     "rules": [
-      "url attribute specifies the web page to load"
+      "url attribute specifies the web page to load",
+      "Error face + retry (iOS / Android only): bind onLoadFailed to a ViewModel method that hides the Web and shows the error, and bind reloadToken to an Int the retry method increments — the Web reloads its own url each time the value changes. Rewriting url to the same value does not reload."
     ]
   },
   "SafeAreaView": {
     "description": "Safe area respecting container",
+    "interactive": false,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -653,6 +677,7 @@
   },
   "TabView": {
     "description": "Tab-based navigation container",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -678,6 +703,7 @@
   },
   "TextView": {
     "description": "Multi-line text input",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
@@ -704,11 +730,12 @@
   },
   "EditText": {
     "description": "Text input (Android naming convention)",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
       "swift_dynamic": true,
-      "kotlin_generated": false,
+      "kotlin_generated": true,
       "kotlin_dynamic": true,
       "react": true
     },
@@ -724,11 +751,12 @@
   },
   "Input": {
     "description": "Generic input (React naming convention)",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,
       "swift_dynamic": true,
-      "kotlin_generated": false,
+      "kotlin_generated": true,
       "kotlin_dynamic": true,
       "react": true
     },
@@ -744,6 +772,7 @@
   },
   "Embed": {
     "description": "Embeds another screen as a region of this layout. The embedded screen owns its own ViewModel — independent from the parent VM.",
+    "interactive": true,
     "aliases": [],
     "platforms": {
       "swift_generated": true,

package/data/type_synonyms.json

@@ -0,0 +1,167 @@
+{
+  "_description": [
+    "Type-spelling synonyms: a node `type` that is not a section of attribute_definitions.json, mapped to the section that declares it (`canonical`).",
+    "The one table. Validation and the renderers are to read it, and hold no list of their own; which of them do is measured by their own tests (the type_synonyms_draw specs, SwiftJsonUI's TypeSynonymsDrawTests), not recorded here. It does not apply to sjui's UIKit mode, a separate renderer with its own set of UIKit components and its own spellings for them (Table is its SJUITableView); that mode draws what it has.",
+    "A renderer draws a synonym as its canonical type — except where the entry names `render_as`: the spelling draws differently from its canonical type (CircleImage clips to a circle), and the renderer draws `render_as` with the converter of that name, while validation still reads the canonical section. A type an app registers as its own component is the app's, whatever its spelling, and is never rewritten.",
+    "Any other key of an entry is an attribute the spelling itself means, of the canonical section: HStack and Row are a View with `orientation: horizontal`, VStack and Column one with `vertical`. A renderer adds it when the node does not set it. When the node sets it otherwise (an HStack with `orientation: vertical`), the node's value is drawn and the renderer warns, naming both. ZStack and Box add nothing: a View without orientation is already the stack they mean.",
+    "Not here: EditText / Input / Check / Toggle. They are sections of attribute_definitions.json that point at their canonical section with `_alias_of`; the exact-match lookup finds them first. Spacer / Divider / Triangle are neither declared nor synonyms, and draw as undeclared types."
+  ],
+  "synonyms": {
+    "Text": {
+      "canonical": "Label"
+    },
+    "MultiLineEditText": {
+      "canonical": "TextView"
+    },
+    "Textarea": {
+      "canonical": "TextView"
+    },
+    "ImageView": {
+      "canonical": "Image"
+    },
+    "Img": {
+      "canonical": "Image"
+    },
+    "NetworkImageView": {
+      "canonical": "NetworkImage"
+    },
+    "CircleImage": {
+      "canonical": "Image",
+      "render_as": "CircleImage"
+    },
+    "CircleImageView": {
+      "canonical": "Image",
+      "render_as": "CircleImage"
+    },
+    "AsyncImage": {
+      "canonical": "NetworkImage"
+    },
+    "Spinner": {
+      "canonical": "SelectBox"
+    },
+    "DatePicker": {
+      "canonical": "SelectBox"
+    },
+    "Select": {
+      "canonical": "SelectBox"
+    },
+    "Picker": {
+      "canonical": "SelectBox"
+    },
+    "Checkbox": {
+      "canonical": "CheckBox"
+    },
+    "RadioButton": {
+      "canonical": "Radio"
+    },
+    "RadioGroup": {
+      "canonical": "Radio"
+    },
+    "SegmentedControl": {
+      "canonical": "Segment"
+    },
+    "TabLayout": {
+      "canonical": "Segment"
+    },
+    "TabGroup": {
+      "canonical": "Segment"
+    },
+    "SeekBar": {
+      "canonical": "Slider"
+    },
+    "Range": {
+      "canonical": "Slider"
+    },
+    "ProgressBar": {
+      "canonical": "Progress"
+    },
+    "ActivityIndicator": {
+      "canonical": "Indicator"
+    },
+    "Loading": {
+      "canonical": "Indicator"
+    },
+    "LinearLayout": {
+      "canonical": "View"
+    },
+    "RelativeLayout": {
+      "canonical": "View"
+    },
+    "FrameLayout": {
+      "canonical": "View"
+    },
+    "HStack": {
+      "canonical": "View",
+      "orientation": "horizontal"
+    },
+    "VStack": {
+      "canonical": "View",
+      "orientation": "vertical"
+    },
+    "ZStack": {
+      "canonical": "View"
+    },
+    "Div": {
+      "canonical": "View"
+    },
+    "Box": {
+      "canonical": "View"
+    },
+    "Container": {
+      "canonical": "View"
+    },
+    "Column": {
+      "canonical": "View",
+      "orientation": "vertical"
+    },
+    "Row": {
+      "canonical": "View",
+      "orientation": "horizontal"
+    },
+    "ConstraintLayout": {
+      "canonical": "View"
+    },
+    "Scroll": {
+      "canonical": "ScrollView"
+    },
+    "CollectionView": {
+      "canonical": "Collection"
+    },
+    "RecyclerView": {
+      "canonical": "Collection"
+    },
+    "Table": {
+      "canonical": "Collection"
+    },
+    "TableView": {
+      "canonical": "Collection"
+    },
+    "List": {
+      "canonical": "Collection"
+    },
+    "Grid": {
+      "canonical": "Collection"
+    },
+    "LazyGrid": {
+      "canonical": "Collection"
+    },
+    "ListView": {
+      "canonical": "Collection"
+    },
+    "LazyColumn": {
+      "canonical": "Collection"
+    },
+    "Gradient": {
+      "canonical": "GradientView"
+    },
+    "BlurView": {
+      "canonical": "Blur"
+    },
+    "WebView": {
+      "canonical": "Web"
+    },
+    "Iframe": {
+      "canonical": "Web"
+    }
+  }
+}

package/dist/cli_runner.js

@@ -2,7 +2,7 @@ import { execFile } from "child_process";
 export async function runCli(command, args, options) {
     const timeout = options.timeout ?? 60_000;
     return new Promise((resolve) => {
-        execFile(command, args, {
+        const child = execFile(command, args, {
             cwd: options.cwd,
             timeout,
             maxBuffer: 10 * 1024 * 1024,
@@ -22,6 +22,12 @@ export async function runCli(command, args, options) {
                 stderr: stderr || "",
             });
         });
+        // Nothing is ever written to the child's stdin: end it now, so a CLI that
+        // reads stdin — an overwrite prompt — sees end-of-file instead of waiting
+        // for a line that never comes. Through 2.13.1 the pipe stayed open, and such
+        // a child waited until the timeout above killed it (`jui g converter` on
+        // an existing component, measured 2026-09-26).
+        child.stdin?.end();
     });
 }
 export function formatResult(result) {

package/dist/index.js

@@ -4,6 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { SpecLoader, mcpRootFromImportMetaUrl } from "./spec_loader.js";
 import { installAutoReload } from "./auto_reload.js";
 import { ServerConfig } from "./config.js";
+import { packageVersion } from "./version.js";
 // --- Group A: Component Spec Lookup ---
 import { register as registerLookupComponent } from "./tools/spec/lookup_component.js";
 import { register as registerLookupAttribute } from "./tools/spec/lookup_attribute.js";
@@ -55,13 +56,14 @@ import { register as registerTestReport } from "./tools/test/test_report.js";
 import { register as registerTestMockGenerate } from "./tools/test/test_mock_generate.js";
 import { register as registerTestArtifactsPull } from "./tools/test/test_artifacts_pull.js";
 import { register as registerTestArtifactsStatus } from "./tools/test/test_artifacts_status.js";
+import { register as registerTestContractsCoverage } from "./tools/test/test_contracts_coverage.js";
 function log(message) {
     console.error(`[jui-tools] ${new Date().toISOString()} ${message}`);
 }
 log("Server starting...");
 const server = new McpServer({
     name: "jui-tools",
-    version: "2.0.0",
+    version: packageVersion(),
 });
 // Initialize spec loader for Group A
 // Resolves attribute_definitions.json via 4-layer fallback:
@@ -131,6 +133,7 @@ registerTestReport(server, config);
 registerTestMockGenerate(server, config);
 registerTestArtifactsPull(server, config);
 registerTestArtifactsStatus(server, config);
+registerTestContractsCoverage(server, config);
 log(`Registered 41 tools (7 spec + 6 context + 8 jui + 9 doc + 3 api + 8 test)`);
 async function main() {
     const transport = new StdioServerTransport();

package/dist/spec_loader.d.ts

@@ -58,6 +58,13 @@ export interface ReloadRecord {
     ok: boolean;
     error?: string;
 }
+export interface TypeSynonym {
+    spelling: string;
+    canonical: string;
+    renderAs?: string;
+    implies?: Record<string, unknown>;
+    source: string;
+}
 export interface DataSourceInfo {
     attributeDefinitions: FileInfo;
     componentMetadata: FileInfo;
@@ -66,6 +73,7 @@ export interface DataSourceInfo {
     attributeSemantics: FileInfo | null;
     platformSemantics: FileInfo | null;
     coverage: FileInfo | null;
+    typeSynonyms: FileInfo | null;
     componentCount: number;
     commonAttributeCount: number;
 }
@@ -92,6 +100,7 @@ export declare class SpecLoader {
     private screenIdentity;
     private commonAttributes;
     private aliasMap;
+    private typeSynonyms;
     private metadata;
     private dataSource;
     /** When this process read the files. Data is cached in memory from then
@@ -156,6 +165,22 @@ export declare class SpecLoader {
     listComponents(): string[];
     getDataSource(): DataSourceInfo;
     private load;
+    /**
+     * Type spellings the build accepts for a section they are not
+     * (shared/core/type_synonyms.json, jsonui-cli 1.9.0 — the one table the
+     * tools and the dynamic runtimes read). Until then lookup_component knew
+     * only `_alias_of` sections and metadata aliases, and answered "not found"
+     * for `ProgressBar`, which the build draws as a Progress.
+     *
+     * A section, an `_alias_of` section or a metadata alias of the same
+     * spelling wins: the exact match is found first, as in the tools. An entry
+     * whose canonical is not a section here is skipped.
+     *
+     * Absent (older jsonui-cli): no synonyms. Present but not JSON: the load
+     * throws, so an automatic reload keeps the last content that parsed rather
+     * than swapping in a loader that silently lost every synonym.
+     */
+    private loadTypeSynonyms;
     private normalizeMetadata;
     private getMetadata;
     private buildComponentSpec;