ui-design-workbench-cli 0.5.0__tar.gz → 0.6.6__tar.gz

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ui-design-workbench-cli
-Version: 0.5.0
+Version: 0.6.6
 Summary: Repository UI indexing, graph, preview, and deterministic review CLI
 Author: Elgreed
 Project-URL: Homepage, https://github.com/Elgreed/ui-design-workbench
@@ -19,7 +19,7 @@ Requires-Dist: mcp<3,>=2; extra == "mcp"
 
 # UI Design Workbench
 
-[Русская версия](README.ru.md) · [Changelog](CHANGELOG.md) · [Release guide](RELEASING.md)
+[Русская версия](README.ru.md) · [Changelog](CHANGELOG.md)
 
 Turn repository UI source into an offline interactive HTML workbench—without building or running the application.
 
@@ -82,7 +82,7 @@ uidw --repo <repo> review --output-dir <review-dir> --level full
 - Incremental scans that reprocess only changed UI files.
 - Property-level evidence and explicit unsupported gaps instead of guessed UI.
 - Sparse review patches and a separate, authorized source-apply step.
-- Structural Android and Apple resource projection, plus discovery of available native capture paths.
+- Runtime-free Android, Apple, and Flutter source projection with deterministic geometry for the supported subset; native evidence is required only before claiming visual or pixel parity and is never launched automatically.
 
 Supported source families include Web, React, Vue, Svelte, Jetpack Compose, Android Views XML, SwiftUI, Storyboard/XIB, WinUI/WPF, and Flutter.
 
@@ -105,8 +105,8 @@ Run `uidw help overview`, `uidw help advanced`, or `uidw <command> --help` for d
 
 ## Accuracy and safety
 
-- HTML is a static source projection, not proof of runtime or pixel parity.
-- Android and Apple translation remains structural until a source-matched native capture exists.
+- HTML is a deterministic runtime-free source projection for the supported shared layout subset, not proof of runtime or pixel parity.
+- Android, Apple, and Flutter translation uses deterministic projection geometry for the supported shared layout subset; without separate native evidence it remains a structural projection, not proof of runtime or pixel parity.
 - Unsupported bindings, custom drawing, runtime data, and platform behavior remain explicit gaps.
 - Preview and review keep application source read-only; applying a proposal is a separate step.
 - Derived cache and review state live outside the target repository by default.
@@ -123,11 +123,12 @@ A Windows `.exe` is not published yet. PyPI + `pipx` is the primary cross-platfo
 ## Documentation
 
 - [Changelog](CHANGELOG.md)
-- [Release and distribution guide](RELEASING.md)
 - [Agent integrations](references/agent-integrations.md)
 - [Fidelity contract](references/fidelity.md)
 - [Native rendering](references/native-rendering.md)
+- [Cache protocol](references/cache-protocol.md)
+- [Platform component catalog](references/component-catalog.md)
 - [IR schema](references/ir-schema.md)
 - [Review workflow](references/review-workflow.md)
 
-Current CLI version: `0.5.0`.
+Current CLI version: `0.6.6`.

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/README.md

@@ -1,6 +1,6 @@
 # UI Design Workbench
 
-[Русская версия](README.ru.md) · [Changelog](CHANGELOG.md) · [Release guide](RELEASING.md)
+[Русская версия](README.ru.md) · [Changelog](CHANGELOG.md)
 
 Turn repository UI source into an offline interactive HTML workbench—without building or running the application.
 
@@ -63,7 +63,7 @@ uidw --repo <repo> review --output-dir <review-dir> --level full
 - Incremental scans that reprocess only changed UI files.
 - Property-level evidence and explicit unsupported gaps instead of guessed UI.
 - Sparse review patches and a separate, authorized source-apply step.
-- Structural Android and Apple resource projection, plus discovery of available native capture paths.
+- Runtime-free Android, Apple, and Flutter source projection with deterministic geometry for the supported subset; native evidence is required only before claiming visual or pixel parity and is never launched automatically.
 
 Supported source families include Web, React, Vue, Svelte, Jetpack Compose, Android Views XML, SwiftUI, Storyboard/XIB, WinUI/WPF, and Flutter.
 
@@ -86,8 +86,8 @@ Run `uidw help overview`, `uidw help advanced`, or `uidw <command> --help` for d
 
 ## Accuracy and safety
 
-- HTML is a static source projection, not proof of runtime or pixel parity.
-- Android and Apple translation remains structural until a source-matched native capture exists.
+- HTML is a deterministic runtime-free source projection for the supported shared layout subset, not proof of runtime or pixel parity.
+- Android, Apple, and Flutter translation uses deterministic projection geometry for the supported shared layout subset; without separate native evidence it remains a structural projection, not proof of runtime or pixel parity.
 - Unsupported bindings, custom drawing, runtime data, and platform behavior remain explicit gaps.
 - Preview and review keep application source read-only; applying a proposal is a separate step.
 - Derived cache and review state live outside the target repository by default.
@@ -104,11 +104,12 @@ A Windows `.exe` is not published yet. PyPI + `pipx` is the primary cross-platfo
 ## Documentation
 
 - [Changelog](CHANGELOG.md)
-- [Release and distribution guide](RELEASING.md)
 - [Agent integrations](references/agent-integrations.md)
 - [Fidelity contract](references/fidelity.md)
 - [Native rendering](references/native-rendering.md)
+- [Cache protocol](references/cache-protocol.md)
+- [Platform component catalog](references/component-catalog.md)
 - [IR schema](references/ir-schema.md)
 - [Review workflow](references/review-workflow.md)
 
-Current CLI version: `0.5.0`.
+Current CLI version: `0.6.6`.

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/SKILL.md

@@ -14,22 +14,26 @@ Use UIDW as a deterministic local utility. The CLI, not the skill prompt, owns s
 Prefer MCP tools `ui_project` then `ui_scope` when the local UIDW MCP is configured. Otherwise use the complete CLI fallback:
 
 ```text
-uidw --repo <repo> context --json
-uidw --repo <repo> scope --ir <ui-ir.json> --screen <id> --budget 4000
+uidw --repo <repo> scope --budget 4000
+uidw --repo <repo> scope --screen <id> --budget 4000
 ```
 
-If `uidw` is unavailable, run `python <skill-dir>/scripts/uidw.py ...`. Reuse a clean cache. Never paste or read the complete `ui-ir.json` when a scoped context can answer the task. Request another screen/finding scope only when needed.
+The first command initializes or reuses the cache and writes a compact catalog; the second writes the selected screen context. Scope provenance is compact by default. Use `ui_fidelity` or `uidw fidelity explain <node-id>` only for nodes that need full source evidence. Reuse the returned `scopeHash` through `if_none_match` or `--if-none-match` before requesting the same scope again.
+
+If `uidw` is unavailable, run `python <skill-dir>/scripts/uidw.py ...`. Reuse a clean cache. Never paste or read the complete `ui-ir.json` when a scoped context can answer the task. Request another screen/finding scope only when needed. If a scope reports `over-budget`, narrow it or explicitly raise the budget; no partial node tree was returned.
 
 If first-use context says `setupRequired`, ask only for `low`, `medium`, or `high` using its short descriptions. Mock-data depth follows that choice. Do not recommend a level. Optional `uiMode` remains off until explicitly enabled.
 
 ## 2. Route the request
 
-- Reconstruct/generate/redesign: read [references/design-modes.md](references/design-modes.md), then only the matching platform section from [references/platform-standards.md](references/platform-standards.md). Use cached evidence and `uidw workbench`; validate transfer fidelity, not product UX. For Android or Apple visual accuracy also read [references/native-rendering.md](references/native-rendering.md) and call MCP `ui_native_status` (or `uidw native status`).
+- Reconstruct/generate/redesign: read [references/design-modes.md](references/design-modes.md), then only the matching platform section from [references/platform-standards.md](references/platform-standards.md). Use cached evidence and `uidw workbench`; validate transfer fidelity, not product UX. Layout fidelity comes from the runtime-free deterministic projection; do not build or launch the source application.
 - Explicit review/audit/critique: read [references/ui-reviewer.md](references/ui-reviewer.md) and [references/review-workflow.md](references/review-workflow.md). Review immutable Before only and work in bounded screen batches.
 - Workbench chrome behavior: read [references/workbench-ui.md](references/workbench-ui.md).
 - Ordinary UI source task with `uiMode.enabled=true`: read [references/ui-guidance-mode.md](references/ui-guidance-mode.md). Do not create a preview or review unless requested.
 - Cache/install/agent integration question: read only [references/cache-protocol.md](references/cache-protocol.md) or [references/agent-integrations.md](references/agent-integrations.md), respectively.
 
+Legacy provider discovery remains available through read-only MCP `ui_native_status` (or `uidw native status`). It is optional compatibility diagnostics and must not be called as part of reconstruction, deterministic layout, rendering, or fidelity gating.
+
 ## 3. Return sparse changes
 
 Review/proposal agents write `ui-ir.patch.json`, never a replacement full IR:
@@ -47,6 +51,6 @@ Allowed operations are `upsert-findings`, `upsert-versions`, `merge-annotations`
 - Do not run the target app, emulator, simulator, build, or dev server unless separately requested. Headless checks may open only generated local HTML.
 - Preserve discovered screens, routes, project components, platform idioms, tokens, themes, states, provenance, and unsupported gaps. Do not invent polish or browser-default replacements.
 - HTML is a projection. Base IR is immutable Before; proposal versions are sparse overrides.
-- Android/Apple source translation is structural-only until a source-matched native capture exists. Never call HTML a native render.
+- Android, Apple, Windows, and Flutter source translation uses deterministic projection geometry where the shared layout subset is known. Never call HTML a native render or claim runtime/pixel parity without matching native evidence.
 - Applying a proposal to real source requires a separate explicit `Apply to project` or direct-fix authorization, bounded source targets, incremental sync, and targeted verification. Never repeat the full AI review automatically.
 - Keep cache and review artifacts outside source control unless the user explicitly requests otherwise.

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ui-design-workbench-cli"
-version = "0.5.0"
+version = "0.6.6"
 description = "Repository UI indexing, graph, preview, and deterministic review CLI"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -39,12 +39,14 @@ py-modules = [
   "android_xml_support",
   "scan_ui",
   "ir_contracts",
+  "layout_model",
   "fidelity_core",
   "fidelity_adapter_api",
   "fidelity_adapters",
   "fidelity_platform_adapters",
   "android_resource_resolver",
   "apple_resource_resolver",
+  "platform_component_catalog",
   "native_render_contracts",
   "native_render_android",
   "native_render_apple",
@@ -57,7 +59,7 @@ py-modules = [
 
 [tool.setuptools.data-files]
 "share/ui-design-workbench" = ["SKILL.md"]
-"share/ui-design-workbench/references" = ["references/*.md", "references/platform-profiles.json"]
+"share/ui-design-workbench/references" = ["references/*.md", "references/platform-profiles.json", "references/component-catalog.json", "references/component-inventory.json"]
 "share/ui-design-workbench/schemas" = ["schemas/*.json"]
 "share/ui-design-workbench/scripts" = [
   "scripts/android_resource_resolver.py",
@@ -70,11 +72,13 @@ py-modules = [
   "scripts/fidelity_platform_adapters.py",
   "scripts/generate_interaction_matrix.py",
   "scripts/ir_contracts.py",
+  "scripts/layout_model.py",
   "scripts/merge_review_state.py",
   "scripts/native_render_android.py",
   "scripts/native_render_apple.py",
   "scripts/native_render_contracts.py",
   "scripts/native_render_registry.py",
+  "scripts/platform_component_catalog.py",
   "scripts/quality_common.py",
   "scripts/render_preview.py",
   "scripts/scan_ui.py",

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/references/agent-integrations.md

@@ -36,4 +36,4 @@ For ordinary source tasks, `uidw init` can opt a project into lightweight UI gui
 
 Codex may opt into `render_preview.py --agent codex`, which enables the official local `codex://new` preparation path. Other agents use copied prompts or the JSON job. Provider-specific adapters are optional presentation conveniences and must not change the IR, cache, review semantics, permissions, or approval boundary.
 
-The optional `uidw-mcp` stdio server is a transport facade over the same deterministic CLI core. It exposes compact project discovery, bounded screen/finding context, job preparation, sparse patch application, preview building, and fidelity explanation. MCP is an optional dependency; installing or running the regular CLI must not require it. Configure an agent to launch `uidw-mcp --repo <absolute-project-path>` as a local stdio command; it opens no port and keeps all project data on the local machine.
+The optional `uidw-mcp` stdio server is a transport facade over the same deterministic CLI core. It exposes compact project discovery, strictly bounded screen/finding context, job preparation, sparse patch application, preview building, and on-demand fidelity explanation. Scoped nodes omit full source expressions by default and expose a stable `scopeHash`; pass it back as `if_none_match` before repeating the same request. MCP is an optional dependency; installing or running the regular CLI must not require it. Configure an agent to launch `uidw-mcp --repo <absolute-project-path>` as a local stdio command; it opens no port and keeps project caches on the local machine. Selected model-facing context is still visible to the host agent and should be treated as derived source data.

{ui_design_workbench_cli-0.5.0 → ui_design_workbench_cli-0.6.6}/references/cache-protocol.md

@@ -34,6 +34,8 @@ uidw --repo <repo> status --json
 uidw --repo <repo> sync
 uidw --repo <repo> context --screen <screen-id> --json
 uidw --repo <repo> context --screen <screen-id> --budget 4000 --format markdown
+uidw --repo <repo> scope --budget 4000
+uidw --repo <repo> scope --screen <screen-id> --budget 4000
 uidw --repo <repo> map --output <docs-or-artifact-dir>/ui-graph.json
 uidw --repo <repo> diff
 uidw --repo <repo> workbench --output-dir <artifact-dir>
@@ -59,3 +61,5 @@ Interactive `init` asks only for detail level and does not recommend or preselec
 UI guidance is not asked during setup and remains off unless explicitly enabled. `init --ui-mode` and `init --no-ui-mode` make automation deterministic. Later use `ui-mode --enable`, `ui-mode --disable`, or `config set ui-mode on|off`. Enabling guidance changes agent behavior only for UI-related tasks and does not imply review, redesign, preview generation, or source-edit permission.
 
 Mock data follows detail level automatically: `low` uses `minimal`, `medium` uses `representative`, and `high` uses `exhaustive`. This derived change refreshes model context but never causes another repository source scan by itself. Preserve existing `scenarioFixtures` and `screen.scenarios` for unaffected screen IDs during incremental sync; regenerate only fixtures whose source dependencies changed.
+
+Use `scope` rather than JSON `context --screen` for agent prompts. It includes only referenced tokens and theme overrides, summarizes property provenance, enforces the requested budget without returning a partial tree, and supports `scopeHash` reuse. The older `context` command remains a human-readable cache summary and compatibility surface.

ui_design_workbench_cli-0.6.6/references/component-catalog.json

@@ -0,0 +1,121 @@
+{
+  "version": 1,
+  "authorityOrder": ["official-platform-documentation", "built-in-renderer-calibration", "project-authored-overrides"],
+  "note": "Component identity and semantics follow official platform documentation. HTML geometry is a calibrated fallback only; explicit project values always win.",
+  "families": {
+    "android": {
+      "sources": [
+        {"title": "Material 3 components", "url": "https://m3.material.io/components", "authority": "official"},
+        {"title": "Compose accessibility defaults", "url": "https://developer.android.com/develop/ui/compose/accessibility/api-defaults", "authority": "official"}
+      ],
+      "components": {
+        "button": {"aliases": ["Button", "MaterialButton", "FilledButton", "FilledTonalButton"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 24}, "style": {"backgroundColor": "#6750a4", "color": "#ffffff", "radius": 20, "fontFamily": "Roboto, Arial, sans-serif", "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "outlined-button": {"aliases": ["OutlinedButton"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 24}, "style": {"backgroundColor": "transparent", "color": "#6750a4", "borderColor": "#79747e", "borderWidth": 1, "borderStyle": "solid", "radius": 20, "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "text-button": {"aliases": ["TextButton"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 12}, "style": {"backgroundColor": "transparent", "color": "#6750a4", "radius": 20, "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "icon-button": {"aliases": ["IconButton", "ImageButton", "FloatingActionButton", "ExtendedFloatingActionButton"], "rendererKind": "icon-button", "layout": {"width": 48, "height": 48}, "style": {"backgroundColor": "transparent", "color": "#49454f", "radius": 24}, "semantics": {"role": "button"}},
+        "text-field": {"aliases": ["TextField", "OutlinedTextField", "EditText", "TextInputEditText"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 56, "paddingHorizontal": 16}, "style": {"backgroundColor": "#f7f2fa", "color": "#1d1b20", "borderColor": "#79747e", "borderWidth": 1, "borderStyle": "solid", "radius": 4, "fontFamily": "Roboto, Arial, sans-serif", "fontSize": 16}, "semantics": {"role": "textbox"}},
+        "card": {"aliases": ["Card", "Surface", "MaterialCardView", "CardView", "ElevatedCard", "OutlinedCard"], "types": ["card"], "rendererKind": "surface", "layout": {"padding": 16}, "style": {"backgroundColor": "#f7f2fa", "color": "#1d1b20", "radius": 12}},
+        "text": {"aliases": ["Text", "TextView", "MaterialTextView"], "types": ["text"], "rendererKind": "text", "style": {"color": "#1d1b20", "fontFamily": "Roboto, Arial, sans-serif", "fontSize": 16, "lineHeight": 24}},
+        "switch": {"aliases": ["Switch", "SwitchMaterial"], "rendererKind": "switch", "layout": {"width": 52, "height": 32}, "style": {"backgroundColor": "#79747e", "color": "#ffffff", "radius": 16}, "semantics": {"role": "switch"}},
+        "checkbox": {"aliases": ["Checkbox", "CheckBox", "RadioButton"], "rendererKind": "checkbox", "layout": {"width": 48, "height": 48}, "style": {"color": "#6750a4"}, "semantics": {"role": "checkbox"}},
+        "navigation": {"aliases": ["NavigationBar", "NavigationRail", "TopAppBar", "CenterAlignedTopAppBar", "Toolbar"], "rendererKind": "navigation", "layout": {"minHeight": 64, "paddingHorizontal": 16}, "style": {"backgroundColor": "#fffbfe", "color": "#1d1b20"}, "semantics": {"role": "navigation"}},
+        "list-item": {"aliases": ["ListItem"], "rendererKind": "surface", "layout": {"minHeight": 56, "paddingHorizontal": 16, "paddingVertical": 8}, "style": {"backgroundColor": "transparent", "color": "#1d1b20"}},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "progress": {"aliases": ["LinearProgressIndicator", "CircularProgressIndicator", "ProgressBar"], "rendererKind": "progress", "layout": {"height": 4}, "style": {"backgroundColor": "#e7e0ec", "color": "#6750a4", "radius": 2}, "semantics": {"role": "progressbar"}}
+      }
+    },
+    "ios": {
+      "sources": [
+        {"title": "Apple Human Interface Guidelines — Components", "url": "https://developer.apple.com/design/human-interface-guidelines/components", "authority": "official"},
+        {"title": "Apple Human Interface Guidelines — Designing for iOS", "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-ios", "authority": "official"}
+      ],
+      "components": {
+        "button": {"aliases": ["Button", "button", "CupertinoButton"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 44, "paddingHorizontal": 16}, "style": {"backgroundColor": "#007aff", "color": "#ffffff", "radius": 10, "fontFamily": "-apple-system, BlinkMacSystemFont, sans-serif", "fontSize": 17, "fontWeight": 600, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "icon-button": {"aliases": ["IconButton"], "rendererKind": "icon-button", "layout": {"width": 44, "height": 44}, "style": {"backgroundColor": "transparent", "color": "#007aff", "radius": 22}, "semantics": {"role": "button"}},
+        "text-field": {"aliases": ["TextField", "SecureField", "textField", "textView", "CupertinoTextField"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 44, "paddingHorizontal": 12}, "style": {"backgroundColor": "#e9e9eb", "color": "#000000", "radius": 10, "fontFamily": "-apple-system, BlinkMacSystemFont, sans-serif", "fontSize": 17}, "semantics": {"role": "textbox"}},
+        "card": {"aliases": ["GroupBox", "Section"], "types": ["card"], "rendererKind": "surface", "layout": {"padding": 16}, "style": {"backgroundColor": "#ffffff", "color": "#000000", "radius": 12, "boxShadow": "0 1px 3px rgba(0,0,0,.12)"}},
+        "text": {"aliases": ["Text", "Label", "label"], "types": ["text"], "rendererKind": "text", "style": {"color": "#000000", "fontFamily": "-apple-system, BlinkMacSystemFont, sans-serif", "fontSize": 17, "lineHeight": 22}},
+        "switch": {"aliases": ["Toggle", "switch"], "rendererKind": "switch", "layout": {"width": 51, "height": 31}, "style": {"backgroundColor": "#8e8e93", "color": "#ffffff", "radius": 16}, "semantics": {"role": "switch"}},
+        "checkbox": {"aliases": ["Checkbox"], "rendererKind": "checkbox", "layout": {"width": 44, "height": 44}, "style": {"color": "#007aff"}, "semantics": {"role": "checkbox"}},
+        "navigation": {"aliases": ["NavigationStack", "NavigationView", "navigationBar", "toolbar"], "rendererKind": "navigation", "layout": {"minHeight": 44, "paddingHorizontal": 16}, "style": {"backgroundColor": "rgba(249,249,249,.94)", "color": "#000000"}, "semantics": {"role": "navigation"}},
+        "list": {"aliases": ["List", "Form", "tableView", "collectionView"], "types": ["list"], "rendererKind": "list", "style": {"backgroundColor": "#f2f2f7", "color": "#000000"}},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "progress": {"aliases": ["ProgressView", "progressView"], "rendererKind": "progress", "layout": {"height": 4}, "style": {"backgroundColor": "#d1d1d6", "color": "#007aff", "radius": 2}, "semantics": {"role": "progressbar"}}
+      }
+    },
+    "macos": {
+      "sources": [
+        {"title": "Apple Human Interface Guidelines — Components", "url": "https://developer.apple.com/design/human-interface-guidelines/components", "authority": "official"},
+        {"title": "Apple Human Interface Guidelines — Designing for macOS", "url": "https://developer.apple.com/design/human-interface-guidelines/designing-for-macos", "authority": "official"}
+      ],
+      "components": {
+        "button": {"aliases": ["Button", "button"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 28, "paddingHorizontal": 12}, "style": {"backgroundColor": "#0a84ff", "color": "#ffffff", "radius": 6, "fontFamily": "-apple-system, BlinkMacSystemFont, sans-serif", "fontSize": 13, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "text-field": {"aliases": ["TextField", "SecureField", "textField", "textView"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 22, "paddingHorizontal": 7}, "style": {"backgroundColor": "#ffffff", "color": "#1e1e1e", "borderColor": "#8e8e93", "borderWidth": 1, "borderStyle": "solid", "radius": 5, "fontSize": 13}, "semantics": {"role": "textbox"}},
+        "card": {"aliases": ["GroupBox", "Section"], "types": ["card"], "rendererKind": "surface", "layout": {"padding": 12}, "style": {"backgroundColor": "#f5f5f5", "color": "#1e1e1e", "radius": 8, "borderColor": "#d1d1d1", "borderWidth": 1, "borderStyle": "solid"}},
+        "text": {"aliases": ["Text", "Label", "label"], "types": ["text"], "rendererKind": "text", "style": {"color": "#1e1e1e", "fontFamily": "-apple-system, BlinkMacSystemFont, sans-serif", "fontSize": 13, "lineHeight": 17}},
+        "switch": {"aliases": ["Toggle", "switch"], "rendererKind": "switch", "layout": {"width": 38, "height": 22}, "style": {"backgroundColor": "#8e8e93", "color": "#ffffff", "radius": 11}, "semantics": {"role": "switch"}},
+        "navigation": {"aliases": ["NavigationSplitView", "toolbar", "NSToolbar", "NSSplitView"], "rendererKind": "navigation", "layout": {"minHeight": 38, "paddingHorizontal": 10}, "style": {"backgroundColor": "rgba(246,246,246,.94)", "color": "#1e1e1e", "borderColor": "#c8c8c8", "borderBottomWidth": 1, "borderStyle": "solid"}, "semantics": {"role": "navigation"}},
+        "list": {"aliases": ["List", "Table", "tableView", "collectionView"], "types": ["list"], "rendererKind": "list", "style": {"backgroundColor": "#ffffff", "color": "#1e1e1e"}},
+        "checkbox": {"aliases": ["CheckBox", "RadioButton", "checkBox", "radioButton", "segmentedControl"], "rendererKind": "checkbox", "layout": {"width": 28, "height": 22}, "style": {"color": "#0a84ff"}, "semantics": {"role": "checkbox"}},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "progress": {"aliases": ["ProgressView", "progressIndicator", "levelIndicator"], "rendererKind": "progress", "layout": {"height": 4}, "style": {"backgroundColor": "#d1d1d6", "color": "#0a84ff", "radius": 2}, "semantics": {"role": "progressbar"}}
+      }
+    },
+    "windows": {
+      "sources": [
+        {"title": "Windows app controls", "url": "https://learn.microsoft.com/en-us/windows/apps/design/controls/", "authority": "official"}
+      ],
+      "components": {
+        "button": {"aliases": ["Button", "HyperlinkButton"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 32, "paddingHorizontal": 12}, "style": {"backgroundColor": "#005fb8", "color": "#ffffff", "radius": 4, "fontFamily": "Segoe UI, sans-serif", "fontSize": 14, "fontWeight": 600, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "icon-button": {"aliases": ["AppBarButton"], "rendererKind": "icon-button", "layout": {"width": 40, "height": 40}, "style": {"backgroundColor": "transparent", "color": "#1a1a1a", "radius": 4}, "semantics": {"role": "button"}},
+        "text-field": {"aliases": ["TextBox", "PasswordBox", "AutoSuggestBox", "NumberBox"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 32, "paddingHorizontal": 10}, "style": {"backgroundColor": "#ffffff", "color": "#1a1a1a", "borderColor": "#8a8886", "borderWidth": 1, "borderStyle": "solid", "radius": 4, "fontFamily": "Segoe UI, sans-serif", "fontSize": 14}, "semantics": {"role": "textbox"}},
+        "card": {"aliases": ["Border", "Expander"], "types": ["card"], "rendererKind": "surface", "layout": {"padding": 12}, "style": {"backgroundColor": "#ffffff", "color": "#1a1a1a", "radius": 8, "borderColor": "#e5e5e5", "borderWidth": 1, "borderStyle": "solid"}},
+        "text": {"aliases": ["TextBlock", "Label"], "types": ["text"], "rendererKind": "text", "style": {"color": "#1a1a1a", "fontFamily": "Segoe UI, sans-serif", "fontSize": 14, "lineHeight": 20}},
+        "switch": {"aliases": ["ToggleSwitch", "ToggleButton"], "rendererKind": "switch", "layout": {"width": 40, "height": 20}, "style": {"backgroundColor": "#8a8886", "color": "#ffffff", "radius": 10}, "semantics": {"role": "switch"}},
+        "checkbox": {"aliases": ["CheckBox", "RadioButton"], "rendererKind": "checkbox", "layout": {"width": 32, "height": 32}, "style": {"color": "#005fb8"}, "semantics": {"role": "checkbox"}},
+        "navigation": {"aliases": ["NavigationView", "CommandBar", "MenuBar", "ToolBar"], "rendererKind": "navigation", "layout": {"minHeight": 48, "paddingHorizontal": 12}, "style": {"backgroundColor": "#f3f3f3", "color": "#1a1a1a", "borderColor": "#e5e5e5", "borderBottomWidth": 1, "borderStyle": "solid"}, "semantics": {"role": "navigation"}},
+        "list": {"aliases": ["ListView", "GridView", "ItemsControl", "TreeView"], "types": ["list"], "rendererKind": "list", "style": {"backgroundColor": "#ffffff", "color": "#1a1a1a"}},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "progress": {"aliases": ["ProgressBar", "ProgressRing"], "rendererKind": "progress", "layout": {"height": 4}, "style": {"backgroundColor": "#d1d1d1", "color": "#005fb8", "radius": 2}, "semantics": {"role": "progressbar"}}
+      }
+    },
+    "flutter": {
+      "sources": [
+        {"title": "Flutter widget catalog", "url": "https://docs.flutter.dev/ui/widgets", "authority": "official"},
+        {"title": "Flutter Material component widgets", "url": "https://docs.flutter.dev/ui/widgets/material", "authority": "official"},
+        {"title": "Flutter Cupertino widgets", "url": "https://docs.flutter.dev/ui/widgets/cupertino", "authority": "official"}
+      ],
+      "components": {
+        "button": {"aliases": ["ElevatedButton", "FilledButton", "CupertinoButton"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 24}, "style": {"backgroundColor": "#6750a4", "color": "#ffffff", "radius": 20, "fontFamily": "Roboto, Arial, sans-serif", "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "outlined-button": {"aliases": ["OutlinedButton"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 24}, "style": {"backgroundColor": "transparent", "color": "#6750a4", "borderColor": "#79747e", "borderWidth": 1, "borderStyle": "solid", "radius": 20, "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "text-button": {"aliases": ["TextButton"], "rendererKind": "button", "layout": {"minHeight": 48, "paddingHorizontal": 12}, "style": {"backgroundColor": "transparent", "color": "#6750a4", "radius": 20, "fontSize": 14, "fontWeight": 500, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "icon-button": {"aliases": ["IconButton", "FloatingActionButton"], "rendererKind": "icon-button", "layout": {"width": 48, "height": 48}, "style": {"backgroundColor": "transparent", "color": "#49454f", "radius": 24}, "semantics": {"role": "button"}},
+        "text-field": {"aliases": ["TextField", "TextFormField", "CupertinoTextField"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 56, "paddingHorizontal": 16}, "style": {"backgroundColor": "#f7f2fa", "color": "#1d1b20", "borderColor": "#79747e", "borderWidth": 1, "borderStyle": "solid", "radius": 4, "fontSize": 16}, "semantics": {"role": "textbox"}},
+        "card": {"aliases": ["Card"], "types": ["card"], "rendererKind": "surface", "layout": {"padding": 16}, "style": {"backgroundColor": "#f7f2fa", "color": "#1d1b20", "radius": 12, "boxShadow": "0 1px 3px rgba(0,0,0,.16)"}},
+        "text": {"aliases": ["Text"], "types": ["text"], "rendererKind": "text", "style": {"color": "#1d1b20", "fontFamily": "Roboto, Arial, sans-serif", "fontSize": 14, "lineHeight": 20}},
+        "switch": {"aliases": ["Switch", "CupertinoSwitch"], "rendererKind": "switch", "layout": {"width": 52, "height": 32}, "style": {"backgroundColor": "#79747e", "color": "#ffffff", "radius": 16}, "semantics": {"role": "switch"}},
+        "checkbox": {"aliases": ["Checkbox", "Radio"], "rendererKind": "checkbox", "layout": {"width": 48, "height": 48}, "style": {"color": "#6750a4"}, "semantics": {"role": "checkbox"}},
+        "navigation": {"aliases": ["AppBar", "NavigationBar", "BottomNavigationBar"], "rendererKind": "navigation", "layout": {"minHeight": 64, "paddingHorizontal": 16}, "style": {"backgroundColor": "#fffbfe", "color": "#1d1b20"}, "semantics": {"role": "navigation"}},
+        "list-item": {"aliases": ["ListTile"], "rendererKind": "surface", "layout": {"minHeight": 56, "paddingHorizontal": 16, "paddingVertical": 8}, "style": {"backgroundColor": "transparent", "color": "#1d1b20"}},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "progress": {"aliases": ["LinearProgressIndicator", "CircularProgressIndicator"], "rendererKind": "progress", "layout": {"height": 4}, "style": {"backgroundColor": "#e7e0ec", "color": "#6750a4", "radius": 2}, "semantics": {"role": "progressbar"}}
+      }
+    },
+    "web": {
+      "sources": [
+        {"title": "HTML Living Standard", "url": "https://html.spec.whatwg.org/multipage/", "authority": "official-standard"},
+        {"title": "WAI-ARIA Authoring Practices", "url": "https://www.w3.org/WAI/ARIA/apg/", "authority": "official-standard"}
+      ],
+      "components": {
+        "button": {"aliases": ["button"], "types": ["button"], "rendererKind": "button", "layout": {"minHeight": 30, "paddingHorizontal": 8}, "style": {"backgroundColor": "#efefef", "color": "#111111", "borderColor": "#767676", "borderWidth": 1, "borderStyle": "solid", "radius": 2, "fontFamily": "Arial, sans-serif", "fontSize": 13, "textAlign": "center"}, "semantics": {"role": "button"}},
+        "input": {"aliases": ["input", "textarea", "select"], "types": ["input"], "rendererKind": "input", "layout": {"minHeight": 30, "paddingHorizontal": 6}, "style": {"backgroundColor": "#ffffff", "color": "#111111", "borderColor": "#767676", "borderWidth": 1, "borderStyle": "solid", "radius": 2, "fontFamily": "Arial, sans-serif", "fontSize": 13}, "semantics": {"role": "textbox"}},
+        "text": {"aliases": ["p", "span", "label", "h1", "h2", "h3", "h4", "h5", "h6"], "types": ["text"], "rendererKind": "text", "style": {"color": "#111111", "fontFamily": "Arial, sans-serif", "fontSize": 16, "lineHeight": 20}},
+        "navigation": {"aliases": ["nav"], "rendererKind": "navigation", "semantics": {"role": "navigation"}},
+        "list": {"aliases": ["ul", "ol", "table"], "types": ["list"], "rendererKind": "list"},
+        "neutral": {"aliases": [], "rendererKind": "surface"},
+        "link": {"aliases": ["a"], "rendererKind": "text", "style": {"color": "#0000ee", "textDecoration": "underline"}, "semantics": {"role": "link"}},
+        "progress": {"aliases": ["progress"], "rendererKind": "progress", "layout": {"height": 8}, "style": {"backgroundColor": "#d1d5db", "color": "#2563eb", "radius": 4}, "semantics": {"role": "progressbar"}}
+      }
+    }
+  }
+}

ui_design_workbench_cli-0.6.6/references/component-catalog.md

@@ -0,0 +1,22 @@
+# Platform component inventory and renderer catalog
+
+The component model has two deliberately separate layers:
+
+- `component-inventory.json` is the complete public visual-component inventory recognized by the source adapters. It groups framework/API names into official concepts for Android, iOS, macOS, Windows, Flutter, and Web.
+- `component-catalog.json` contains calibrated HTML renderer recipes. Several official components can share one recipe without being treated as the same source component.
+
+The current inventory contains 178 official concept groups and 593 concrete framework bindings. The renderer has 66 conservative recipes. These counts are different on purpose: copying hundreds of near-identical CSS recipes would make calibration inconsistent and would not improve fidelity.
+
+The authority order is deliberate:
+
+1. official platform documentation defines component identity, semantics, and expected behavior;
+2. built-in renderer calibration supplies conservative HTML geometry when source code has no explicit value;
+3. project-authored layout, theme, token, style, and accessibility values always override the fallback.
+
+Every family links to its official documentation in JSON. `uidw fidelity capabilities` reports recipe, concept, and binding coverage separately and fails when bindings conflict, an inventory concept references a missing recipe, a family has no source, or a renderer kind is invalid.
+
+“Complete” means the public visual primitives and controls in the linked official component/widget/control catalogs. It intentionally excludes nonvisual controllers, delegates, routes, painters, internal implementation classes, deprecated platform-specific products, and runtime-generated project components. Project wrappers are discovered separately and mapped back to this inventory with source provenance.
+
+The fallback is not a native screenshot and must not be described as pixel-perfect. Official documentation does not encode every runtime measurement, font rasterization detail, OS-version variation, or project theme override. Native captures remain the visual authority where exact evidence is required.
+
+Large-project analysis is secondary. It may discover project wrappers such as `PrimaryButton`, theme indirection, and frequently combined primitives, but it must not redefine official controls or copy proprietary UI code into the global catalog. Project-specific mappings belong to the project cache and must retain source provenance.