Files
kandev/docs/plans/task-create-launch-step-arrow/task-01-refine-launch-step-help-control.md
T
2026-09-07 13:47:06 +01:00

3.9 KiB

id, title, status, wave, depends_on, plan, requirements, acceptance_criteria, system_design
id title status wave depends_on plan requirements acceptance_criteria system_design
01-refine-launch-step-help-control Refine the launch-step help control done 1
plan.md
REQ-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001
AC-TASKS-TASK-CREATE-LAUNCH-PREVIEW-001.1
../../specs/tasks/system-design/task-create-launch-preview.md

Task 01: Refine the Launch-Step Help Control

Summary

Replace the task-create launch destination's generic information glyph and visible prefix with a directional arrow help control followed by the resolved step name. Preserve accessible explanatory behavior across pointer, keyboard, and touch input.

In scope

  • Render IconArrowBigRightLines in the existing launch-step help button.
  • Render only the destination step name beside the button.
  • Preserve localized tooltip content and accessible naming, and use the standard drawer and responsive target sizing on coarse pointers.
  • Remove the unused visible-label translations and update public guidance.
  • Update focused component and desktop/mobile browser coverage.

Out of scope

  • Launch routing, workflow selection, task submission, and prompt-preview behavior.
  • New responsive composition or navigation.

Acceptance

  • The selected workflow is followed by the muted directional arrow button and resolved destination step name, with no visible Start step: prefix.
  • Hovering or focusing the arrow shows the localized launch-destination explanation; activating it on a coarse pointer opens the same explanation in a drawer.
  • The button retains its localized accessible name, and its coarse-pointer hit area remains at least 44 CSS pixels without enlarging fine-pointer desktop density.

Verification

cd apps/web
pnpm test -- --run components/workflow-selector-row.test.tsx
pnpm exec eslint --max-warnings 0 components/workflow-selector-row.tsx components/workflow-selector-row.test.tsx
pnpm run typecheck
pnpm run i18n:check
pnpm run i18n:ratchet
pnpm e2e:run tests/task/create-task.spec.ts -- --grep "launch prompt preview"
pnpm e2e:run --project mobile-chrome tests/task/mobile-create-task-launch-preview.spec.ts
cd ../..
node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
git diff --check

Files likely touched

  • apps/web/components/workflow-selector-row.tsx
  • apps/web/components/workflow-selector-row.test.tsx
  • apps/web/e2e/tests/task/create-task.spec.ts
  • apps/web/e2e/tests/task/mobile-create-task-launch-preview.spec.ts
  • apps/web/src/locales/en/task.json
  • apps/web/src/locales/pt-pt/task.json
  • apps/web/src/locales/zh-cn/task.json
  • apps/web/src/locales/zh-hk/task.json
  • apps/web/src/locales/zh-tw/task.json
  • apps/web/src/locales/pseudo/task.json
  • docs/public/tasks-and-workflows.md

Dependencies

None.

Risks

  • The arrow can look like navigation if spacing or emphasis separates it from the destination label.
  • Coarse-pointer detection must route the disclosure to the standard touch drawer while fine pointers retain hover and keyboard focus behavior.

Parallelism

sequential

Inputs

  • Launch destination disclosure in the task-create launch-preview requirement.
  • Workflow selector and responsive behavior in the paired system design.
  • Existing selector component and launch-preview Playwright coverage.

Results

  • Replaced the generic information glyph with IconArrowBigRightLines and rendered the resolved workflow step name without a visible prefix.
  • Preserved localized accessible naming and explanatory tooltip behavior for pointer hover and keyboard focus; mobile coverage proves the touch drawer and its 44-pixel coarse-pointer trigger.
  • Removed the unused visible-label key from all locale catalogs and updated the public task-creation how-to guide.
  • The focused component test passed (3 tests), targeted desktop and mobile E2E each passed (1 test), and all static, i18n, documentation, specification, and diff checks listed in the plan passed.