refactor(tooltips): rename copy.py → tooltips.py to avoid stdlib shadow

The original copy.py shadowed Python's stdlib copy module, requiring a
fragile conftest hack to pre-import torch/pydantic/fastapi/gradio so
they captured the real stdlib before sys.modules['copy'] was swapped.
That coupling — every new dep with a lazy 'from copy import deepcopy'
would silently break tests — is bad enough to avoid entirely.

Rename to tooltips.py. conftest.py reverts to a simple sys.path
insert. Spec and plan amendments updated.

docs/superpowers/plans/2026-05-13-z-image-studio.md

@@ -2622,17 +2622,17 @@ Additions decided after Tasks 1–3 landed. References spec sections 4.6 (toolti
 
 ---
 
-### Task A: copy.py — TOOLTIPS dict
+### Task A: tooltips.py — TOOLTIPS dict
 
 **Files:**
-- Create: `copy.py`
-- Test: `tests/test_copy.py`
+- Create: `tooltips.py`
+- Test: `tests/test_tooltips.py`
 
 - [ ] **Step A.1: Write failing test**
 
 ```python
-# tests/test_copy.py
-import copy as zis_copy  # name shadows the stdlib `copy` but the module is unrelated
+# tests/test_tooltips.py
+import tooltips
 
 REQUIRED_KEYS = {
     "prompt", "negative_prompt", "model", "lora", "lora_strength",
@@ -2642,21 +2642,21 @@ REQUIRED_KEYS = {
 }
 
 def test_tooltips_has_all_required_keys():
-    assert REQUIRED_KEYS <= set(zis_copy.TOOLTIPS)
+    assert REQUIRED_KEYS <= set(tooltips.TOOLTIPS)
 
 def test_tooltips_values_are_non_empty_strings():
-    for key, val in zis_copy.TOOLTIPS.items():
+    for key, val in tooltips.TOOLTIPS.items():
         assert isinstance(val, str) and val.strip(), f"{key} is empty or non-string"
 
 def test_tooltips_values_are_short_enough_for_a_tooltip():
     # 200-char ceiling so tooltips don't overflow on phone
-    for key, val in zis_copy.TOOLTIPS.items():
+    for key, val in tooltips.TOOLTIPS.items():
         assert len(val) <= 200, f"{key} is too long for a tooltip ({len(val)} chars)"
 ```
 
-- [ ] **Step A.2: Run test — expect FAIL** (`pytest tests/test_copy.py -v` → ModuleNotFoundError).
+- [ ] **Step A.2: Run test — expect FAIL** (`pytest tests/test_tooltips.py -v` → ModuleNotFoundError).
 
-- [ ] **Step A.3: Implement `copy.py`**
+- [ ] **Step A.3: Implement `tooltips.py`**
 
 ```python
 """User-facing copy — tooltips and similar short strings.
@@ -2692,7 +2692,7 @@ TOOLTIPS: dict[str, str] = {
 - [ ] **Step A.5: Commit**
 
 ```bash
-git add copy.py tests/test_copy.py
+git add tooltips.py tests/test_tooltips.py
 git commit -m "feat(copy): tooltip strings dict — one source of truth for param descriptions"
 ```
 

docs/superpowers/specs/2026-05-13-z-image-studio-design.md

@@ -137,7 +137,7 @@ Every user-facing param gets an info-icon affordance: a subtle circled `i` super
 
 `gr.HTML(labeled_label("Steps", TOOLTIPS["steps"]))` is placed immediately before the corresponding `gr.Slider` (which uses `show_label=False`). One `gr.HTML` per labeled component.
 
-**Tooltip text source.** All strings live in a new `copy.py` module as a flat dict `TOOLTIPS[component_id]`. Keeping them out of `ui.py` lets copy edits stay separate from component wiring. Initial keys: `prompt`, `negative_prompt`, `model`, `lora`, `lora_strength`, `steps`, `cfg`, `width`, `height`, `seed`, `controlnet_image`, `controlnet_preprocessor`, `controlnet_scale`, `upscale_image`, `refine_steps`, `refine_denoise`, `output`.
+**Tooltip text source.** All strings live in a new `tooltips.py` module as a flat dict `TOOLTIPS[component_id]`. Keeping them out of `ui.py` lets copy edits stay separate from component wiring. Initial keys: `prompt`, `negative_prompt`, `model`, `lora`, `lora_strength`, `steps`, `cfg`, `width`, `height`, `seed`, `controlnet_image`, `controlnet_preprocessor`, `controlnet_scale`, `upscale_image`, `refine_steps`, `refine_denoise`, `output`.
 
 **Styling.** Pure CSS in `theme.CSS`:
 
@@ -293,7 +293,7 @@ llm/z-image-studio/
 ├── lora.py             # LoRA safetensors header sniffer + apply/revert ctx
 ├── ui.py               # Per-tab Gradio component builders + labeled_label() + model selector HTML helpers
 ├── theme.py            # Amber tokens + gr.themes.Base subclass + CSS string (includes .zis-info / .zis-models / .zis-model rules)
-├── copy.py             # TOOLTIPS dict — short info strings per component id (one source of truth)
+├── tooltips.py             # TOOLTIPS dict — short info strings per component id (one source of truth)
 ├── pyproject.toml      # ruff config; py311
 ├── requirements.txt    # diffsynth-studio, gradio==5.x, spaces, controlnet-aux, realesrgan, ...
 ├── README.md           # HF Space YAML frontmatter (preload_from_hub) + user docs
@@ -483,7 +483,7 @@ No mocks for `ZImagePipeline` internals — only for its `__call__` boundary. Te
 4. **License MIT** — say otherwise during review if you'd prefer Apache-2.0.
 5. **ControlNet preload is in the YAML** — accept the larger startup at the gain of zero first-ControlNet-call wait. If RAM is tight at boot we'll move it to lazy.
 6. **Custom model selector replaces `gr.Radio` in T2I** (per § 4.7) — necessary because two of the four cards are external-link `<a>` elements, not selectable options. A hidden `gr.Textbox` carries the state.
-7. **Tooltips wrap every param via a `labeled_label()` HTML helper** (per § 4.6) — every `gr.Slider`/`gr.Textbox`/`gr.Image`/`gr.Dropdown`/`gr.Number`/`gr.File` uses `show_label=False` with a preceding `gr.HTML(labeled_label(...))`. Tooltip strings centralized in `copy.py`.
+7. **Tooltips wrap every param via a `labeled_label()` HTML helper** (per § 4.6) — every `gr.Slider`/`gr.Textbox`/`gr.Image`/`gr.Dropdown`/`gr.Number`/`gr.File` uses `show_label=False` with a preceding `gr.HTML(labeled_label(...))`. Tooltip strings centralized in `tooltips.py`.
 8. **Slider typing comes free** — `gr.Slider` already renders an editable numeric input next to the track (Gradio default; matches LTX repo). No custom widget needed.
 
 **Out of scope additions (v1):**

tests/conftest.py

@@ -1,34 +1,5 @@
-import importlib.util
 import sys
 from pathlib import Path
 
-_PROJECT_ROOT = Path(__file__).resolve().parents[1]
-
 # Make top-level modules importable in tests
-sys.path.insert(0, str(_PROJECT_ROOT))
-
-# ── copy.py shadow fix ────────────────────────────────────────────────────────
-# The project ships a file named ``copy.py`` which shadows the stdlib module.
-# Third-party packages (pydantic, gradio) use ``from copy import deepcopy``;
-# they must see the stdlib module.  test_copy.py uses ``import copy as zis_copy``
-# and must see the project module.
-#
-# Fix: eagerly import all third-party packages that use stdlib copy so their
-# module-level ``from copy import ...`` calls are resolved against stdlib NOW,
-# before we swap sys.modules["copy"].  After the swap only new ``import copy``
-# statements are affected — and test_copy.py is the only file that issues one.
-try:
-    import torch     # noqa: F401  — torch._tensor uses `from copy import deepcopy`
-    import pydantic  # noqa: F401  — resolves `from copy import deepcopy` in pydantic.main
-    import fastapi   # noqa: F401  — depends on pydantic
-    import gradio    # noqa: F401  — depends on fastapi/pydantic
-except ImportError:
-    pass  # optional deps; if absent the swap is harmless
-
-# Now replace sys.modules["copy"] with our project module so that any
-# subsequent ``import copy`` (i.e., in test_copy.py) gets TOOLTIPS.
-_project_copy_path = _PROJECT_ROOT / "copy.py"
-_spec = importlib.util.spec_from_file_location("copy", _project_copy_path)
-_project_copy_module = importlib.util.module_from_spec(_spec)
-_spec.loader.exec_module(_project_copy_module)
-sys.modules["copy"] = _project_copy_module
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))

tests/{test_copy.py → test_tooltips.py}

@@ -1,4 +1,4 @@
-import copy as zis_copy  # name shadows the stdlib `copy` but the module is unrelated
+import tooltips
 
 REQUIRED_KEYS = {
     "prompt", "negative_prompt", "model", "lora", "lora_strength",
@@ -8,12 +8,12 @@ REQUIRED_KEYS = {
 }
 
 def test_tooltips_has_all_required_keys():
-    assert REQUIRED_KEYS <= set(zis_copy.TOOLTIPS)
+    assert REQUIRED_KEYS <= set(tooltips.TOOLTIPS)
 
 def test_tooltips_values_are_non_empty_strings():
-    for key, val in zis_copy.TOOLTIPS.items():
+    for key, val in tooltips.TOOLTIPS.items():
         assert isinstance(val, str) and val.strip(), f"{key} is empty or non-string"
 
 def test_tooltips_values_are_short_enough_for_a_tooltip():
-    for key, val in zis_copy.TOOLTIPS.items():
+    for key, val in tooltips.TOOLTIPS.items():
         assert len(val) <= 200, f"{key} is too long for a tooltip ({len(val)} chars)"

copy.py → tooltips.py

@@ -1,4 +1,4 @@
-"""User-facing copy — tooltips and similar short strings.
+"""Tooltip strings for every labeled UI component.
 
 Kept separate from ``ui.py`` so copy edits don't touch component wiring. Every
 key here MUST be referenced from a labeled component in ``ui.py`` (and vice versa).