Rebuild the page actions row: Copy as markdown and Open in Claude

[enf0rc3]

Implements two designs from Documentation vision: Open in LLM and Copy to clipboard.

What changed

The "Use Octopus docs with AI" pill at the foot of the article is gone. Under the page header, next to Edit on GitHub, there are now two actions:

Copy as markdown — fetches this page's .md companion and puts it on the clipboard. Swaps to a check icon and "Copied" for two seconds, then reverts.

Open in Claude with a caret — the primary half opens Claude with a prompt pointing at the page's .md URL. The caret opens a menu with Open in Claude and Open in ChatGPT, as link-styled rows with a provider logo and an external-link icon.

Gemini is deliberately absent: gemini.google.com ignores prompt parameters, so the entry could only prefill by pointing at AI Studio, which is not where "Open in Gemini" says it is going.

Both actions are the Button component, so borders, radius, hover, pressed and focus states come from the design-system tokens. Button gains an as prop so the caret can be a <summary>; the split button's two halves collapse into one divider via a negative margin, which keeps each half's focus ring unclipped.

Three icons added under src/assets/icons/, exported from the Figma file and applied as CSS masks so they take --colorIconPrimary in a button and --colorTextLinkDefault in the menu.

Reusing the shared copy module

copy-button.js (from #3317) grows two things rather than the copy action reimplementing them:

• showResult writes to .btn__label when there is one, and falls back to the tooltip otherwise. The design wants the result in the label; the two existing icon-only consumers are unchanged.
• copyFetchedOnClick covers text that has to be fetched. It hands ClipboardItem a pending promise so the click's user activation survives the request — awaiting the fetch first and then writing loses it in Safari, which is the trap the module's own comment warns about.

The delegated listener, result swap and announcement are shared by both entry points. The two write strategies stay apart on purpose: the promise trick only earns its keep when there is an await to survive, and text read off the page has none, so it keeps the simpler and more widely supported writeText.

The button also locks its measured width before the label shortens, so "Open in Claude" beside it doesn't shuffle. Measured rather than hardcoded, so it holds for any translation.

The eligibility check both actions need moved to pageMarkdownUrl(), so neither component re-derives the slug.

The menu opens towards whichever side has room

The menu is wider than the control, so the side it can open towards depends on where the control has ended up: at the end of the row on one line, or at the start of its own once the row wraps. A width breakpoint cannot tell those apart, and the first attempt had them backwards — the menu forced a horizontal scrollbar between roughly 520 and 720 wide, and was cut off past the start edge below 480.

CSS anchor positioning with position-try-fallbacks: flip-inline asks the browser instead. position: fixed rather than absolute, because the containing block was the caret's <details> at 32px wide, which leaves nothing to measure the room against; the anchor keeps it tracking the button through a scroll. Browsers without anchor positioning keep a plain absolute rule, right-aligned, which is the orientation the unwrapped row needs.

Fixes a markdown emitter bug on Windows

globSync returns backslash-separated paths on Windows and llm-md-emitter.ts fed them into forward-slash logic in two places. Two lines of posix: true:

• pathToSlug strips a trailing /index, so argo-cd\index kept its suffix and the page was written to dist/docs/argo-cd/index.md. Every request for /docs/argo-cd.md 404d, taking the page actions and llms.txt parity with it.
• The shared content lookup keys off path.posix.join, which leaves a backslash mid-key and never matches the include paths in the source files. A page whose include failed to resolve was judged ineligible, so 1252 rather than 846 pages now get a .md companion on a Windows build.

Linux was unaffected, which is why this survived. It is in this PR because it is what the two new actions point at.

Testing

astro build from a clean dist: exit 0, 2673 pages, 1252 .md emitted.

tests/llm-endpoints.spec.ts: 15 passed, 0 failed. Includes a test that clicks the copy button and reads the clipboard back to confirm the page markdown actually arrives, and two that open the menu at 700px and 430px and assert it stays on screen with no horizontal scrollbar. Before the emitter fix, five of these failed.

Verified in a real browser in both themes: menu open and closed, the copy button through rest, copied and reverted, and the menu flipping side as the row wraps.

🤖 Generated with Claude Code

[team-marketing-branch-protections]

Pull request environment is available at https://stoctodocspr3330.z22.web.core.windows.net.

You can view the ephemeral environment status in Octopus Deploy.

This environment will be automatically deprovisioned when the pull request is closed, or after 7 days of inactivity.