ui-design-workbench-cli 0.6.3__tar.gz → 0.6.7__tar.gz

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ui-design-workbench-cli
-Version: 0.6.3
+Version: 0.6.7
 Summary: Repository UI indexing, graph, preview, and deterministic review CLI
 Author: Elgreed
 Project-URL: Homepage, https://github.com/Elgreed/ui-design-workbench
@@ -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.
@@ -131,4 +131,4 @@ A Windows `.exe` is not published yet. PyPI + `pipx` is the primary cross-platfo
 - [IR schema](references/ir-schema.md)
 - [Review workflow](references/review-workflow.md)
 
-Current CLI version: `0.6.3`.
+Current CLI version: `0.6.7`.

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/README.md

@@ -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.
@@ -112,4 +112,4 @@ A Windows `.exe` is not published yet. PyPI + `pipx` is the primary cross-platfo
 - [IR schema](references/ir-schema.md)
 - [Review workflow](references/review-workflow.md)
 
-Current CLI version: `0.6.3`.
+Current CLI version: `0.6.7`.

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/SKILL.md

@@ -26,12 +26,14 @@ If first-use context says `setupRequired`, ask only for `low`, `medium`, or `hig
 
 ## 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:
@@ -49,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.6.3 → ui_design_workbench_cli-0.6.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ui-design-workbench-cli"
-version = "0.6.3"
+version = "0.6.7"
 description = "Repository UI indexing, graph, preview, and deterministic review CLI"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -39,6 +39,7 @@ py-modules = [
   "android_xml_support",
   "scan_ui",
   "ir_contracts",
+  "layout_model",
   "fidelity_core",
   "fidelity_adapter_api",
   "fidelity_adapters",
@@ -71,6 +72,7 @@ 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",

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/references/fidelity.md

@@ -1,12 +1,12 @@
 # Source-fidelity contract
 
-## Fidelity Core v0.3 with native evidence levels
+## Fidelity Core v0.3 with deterministic projection
 
 The scanner uses the provider-neutral adapter registry described in [adapter-api.md](adapter-api.md). Built-in Web, React/Vue/Svelte, Compose, Android XML, SwiftUI, Storyboard/XIB, XAML, Flutter, and React Native adapters translate only deterministic supported subsets and record the rest in `fidelity.unsupported`. A strict artifact declares `fidelity.schemaVersion: "0.3"`.
 
 Each translated property carries stable property-level provenance. Token aliases are resolved for rendering while their original references and source records remain in IR. The baseline is sealed with `review.baselineHash`; proposal versions remain sparse `nodeOverrides`. Editing baseline screens, nodes, tokens, themes, or fixtures without an explicit rescan invalidates the strict gate.
 
-Use `uidw fidelity capabilities` for the installed support matrix, `uidw fidelity report` for the compact gate, and `uidw fidelity explain` for one node or evidence ID. Capabilities distinguish `structuralTier`, `visualTier`, and `nativeEvidenceRequired`; Android and Apple source adapters must never claim native visual fidelity. Per-adapter fixtures prevent silent translation drift.
+Use `uidw fidelity capabilities` for the installed support matrix, `uidw fidelity report` for the compact gate, and `uidw fidelity explain` for one node or evidence ID. Capabilities distinguish `structuralTier` and `visualTier`; source adapters report `deterministic-projection`, require native evidence for native-platform visual verification, and never start that evidence collection automatically. Per-adapter fixtures prevent silent translation drift.
 
 The HTML projection resolves recognized controls through the official-doc-first [platform component catalog](component-catalog.md). Catalog geometry is a render-only fallback: explicit source layout, theme, token, and style evidence always wins, and the source IR is not mutated.
 
@@ -52,4 +52,4 @@ Preserve `discoveredNavigationTargets`. Each target must map to a screen's `frag
 
 The renderer enforces the minimum gate. `--allow-draft` is diagnostic and must not be used to solicit design approval.
 
-For Android and Apple, also follow [native-rendering.md](native-rendering.md). The HTML workbench must display `structural` and “native capture not verified” until a matching native capture exists. Provider installation alone is not evidence.
+For Android, Apple, Windows, and Flutter, the HTML workbench uses the same runtime-free layout model as every other source adapter. A partial context remains an explicit projection gap; it must not trigger a build, emulator, simulator, or native-capture calibration step.

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/references/native-rendering.md

@@ -1,8 +1,8 @@
 # Native rendering contract
 
-Source analysis and native rendering are separate stages. The base UI IR remains deterministic and portable; native screenshots, geometry, and semantic trees live in `native-render-state.json` in the UIDW cache.
+Source analysis and deterministic HTML projection are the default Workbench reconstruction path. They remain buildless and runtime-free. Native-render discovery is optional and read-only during reconstruction, but matching native evidence is required before visual or pixel parity can be claimed. External screenshots, geometry, or semantic trees remain isolated in `native-render-state.json` and never modify the base UI IR.
 
-The default Android projection may resolve source resources and deterministic layout semantics before native verification. This improves ordinary mockups but does not change the fidelity level from `structural`: resource resolution is evidence about inputs, not proof of the platform's final layout pass.
+The default projection resolves source resources and supported layout semantics through the shared deterministic solver. Adapter capability `deterministic-projection` describes source-to-HTML transfer; the workbench reports native targets as `structural-projection` until matching native evidence exists.
 
 ## Fidelity levels
 

{ui_design_workbench_cli-0.6.3 → ui_design_workbench_cli-0.6.7}/scripts/fidelity_adapters.py

@@ -277,9 +277,10 @@ def _compose_length(value: str, tokens: dict[str, Any], group: str = "spacing")
     dimension = re.fullmatch(r"(-?\d+(?:\.\d+)?)\.(?:dp|sp)", clean)
     if dimension:
         return f"{dimension.group(1)}px"
-    number = re.fullmatch(r"-?\d+(?:\.\d+)?", clean)
+    number = re.fullmatch(r"-?\d+(?:\.\d+)?[fF]?", clean)
     if number:
-        return float(clean) if "." in clean else int(clean)
+        normalized = clean.rstrip("fF")
+        return float(normalized) if "." in normalized else int(normalized)
     token_name = _slug(clean).replace("-", "_")
     if token_name in tokens.get(group, {}):
         return f"${group}.{token_name}"
@@ -320,9 +321,9 @@ class ComposeAdapter:
     extensions = (".kt", ".kts")
     maturity = "structural"
     structural_tier = "translated"
-    visual_tier = "none"
+    visual_tier = "deterministic-projection"
     native_evidence_required = True
-    native_providers = ("android-compose-screenshot", "paparazzi", "roborazzi", "android-emulator")
+    native_providers = ("paparazzi", "roborazzi", "android-emulator")
     resource_resolution = ("R.string", "R.drawable", "R.mipmap", "common Material Icons")
     layout_features = ("size/fill/weight/aspectRatio", "directional padding", "Row/Column arrangement", "Box alignment", "basic typography")
     limitations = ("supported Compose primitives and modifiers only", "custom composables remain explicit unsupported entries")
@@ -420,11 +421,15 @@ class ComposeAdapter:
                     arrangement = _compose_named_value(args, "verticalArrangement")
                     if alignment in alignments: _set_compose(node, "layout.align", alignments[alignment], context, line, f"horizontalAlignment = {alignment}", self.id)
                     if arrangement in arrangements: _set_compose(node, "layout.justify", arrangements[arrangement], context, line, f"verticalArrangement = {arrangement}", self.id)
+                    spaced = re.fullmatch(r"Arrangement\.spacedBy\s*\(\s*([^,)]+)\s*\)", arrangement or "")
+                    if spaced: _set_compose(node, "layout.gap", _compose_length(spaced.group(1), result.tokens), context, line, f"verticalArrangement = {arrangement}", self.id)
                 if widget in {"Row", "LazyRow"}:
                     alignment = _compose_named_value(args, "verticalAlignment")
                     arrangement = _compose_named_value(args, "horizontalArrangement")
                     if alignment in alignments: _set_compose(node, "layout.align", alignments[alignment], context, line, f"verticalAlignment = {alignment}", self.id)
                     if arrangement in arrangements: _set_compose(node, "layout.justify", arrangements[arrangement], context, line, f"horizontalArrangement = {arrangement}", self.id)
+                    spaced = re.fullmatch(r"Arrangement\.spacedBy\s*\(\s*([^,)]+)\s*\)", arrangement or "")
+                    if spaced: _set_compose(node, "layout.gap", _compose_length(spaced.group(1), result.tokens), context, line, f"horizontalArrangement = {arrangement}", self.id)
                 if widget == "Box":
                     content_alignment = _compose_named_value(args, "contentAlignment")
                     if content_alignment and "Center" in content_alignment: