Remove deprecated runtime:ui docs (use runtime:window)#35
Conversation
…sers)
`runtime:ui` was consolidated into `runtime:window` and has no backing crate or
SDK (`crates/ext_ui` and `sdk/runtime.ui.ts` don't exist) — the page only
documented a legacy alias with a migration guide. For a v1 with no users the
deprecated surface is noise, so remove it and point everything at the real
module:
- Delete `site/src/content/docs/api/runtime-ui.md` (phantom; `runtime-window.md`
already documents windows, dialogs, menus, and tray comprehensively).
- Landing page: Hero nav, CodeExample sample (`openWindow`->`createWindow`,
`runtime:ui`->`runtime:window`, badge), and the Footer "API Reference" link now
use `runtime:window` / `/docs/api/runtime-window/`.
- `runtime-updater.md` example: `import { showDialog } from "runtime:ui"` ->
`import { dialog } from "runtime:window"`, rewritten to the real
`dialog.message({ kind, title, message, buttons }) -> Promise<number>` API
(returns the clicked-button index).
Also fixes a gap from the /docs/ routing change: the Footer's links used object
syntax (`href: '/getting-started/'`) which the earlier rewrite (matching
`href="..."`) missed, so they still pointed at the now-nonexistent root paths.
All four (`getting-started`, `architecture`, the API link, `manifest`) are now
under `/docs/`.
Verified: `npm run build` -> 90 pages; no `runtime:ui`/`runtime-ui` references
remain and no root-relative doc links remain (any style); all 57 unique internal
`/docs/` targets resolve (0 missing); drift gate in sync.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
There was a problem hiding this comment.
Sorry @LayerDynamics, you have reached your weekly rate limit of 500000 diff characters.
Please try again later or upgrade to continue using Sourcery
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request migrates references from the deprecated runtime:ui module to the consolidated runtime:window module across several components and documentation files, including the removal of the legacy runtime-ui.md file. In runtime-updater.md, the reviewer suggests replacing the dialog.message call with dialog.confirm because the underlying rfd library has limited support for custom button configurations, which could lead to inconsistent cross-platform behavior.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
1 participant
Summary
Removes the deprecated
runtime:uidocumentation. It's a phantom — nocrates/ext_ui, nosdk/runtime.ui.ts— it only documented a legacy alias ofruntime:window. For v1 with no users, the deprecated surface is noise.Changes
site/src/content/docs/api/runtime-ui.md(−435 lines;runtime-window.mdalready documents windows/dialogs/menus/tray comprehensively).runtime:windowwith verified export names: homepageCodeExample(openWindow→createWindow),Heronav,FooterAPI link, andruntime-updater.md's example (showDialog→ the realdialog.message({ kind, title, message, buttons }) → Promise<number>).href: '/getting-started/') — missed by Mount docs under /docs/ so the 173 internal links resolve #34'shref="..."rewrite — now under/docs/.Test plan
npm run build→ 90 pages, no errors;runtime-uigone fromdist,runtime-windowpresent/docs/targets resolve (0 missing); zeroruntime:ui/runtime-uirefs; zero root-relative doc linksNote: no PR-level CI builds the Astro site (deploy-site runs only on merge to
main), so the build was verified locally. On merge,deploy-site.ymlredeploys.🤖 Generated with Claude Code