Skip to content

chore: remove dead surfaces and fix two demo defects from the docs reviews - #1039

Merged
blove merged 1 commit into
mainfrom
blove/docs-cleanup-dead-surfaces
Sep 6, 2026
Merged

chore: remove dead surfaces and fix two demo defects from the docs reviews#1039
blove merged 1 commit into
mainfrom
blove/docs-cleanup-dead-surfaces

Conversation

@blove

@blove blove commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Follow-up to the example-first docs program (#1025#1038). The page reviews surfaced dead code and two demo defects; this PR removes and fixes them.

Dead surfaces removed

  • @threadplane/chat exported ./chat.css and ng-package.json globbed it, but no such file exists under src/lib/styles. The export and the glob are gone.
  • A2uiSlotDirective (+ spec) was the superseded slot-based progressive renderer; <a2ui-surface> renders through surfaceToSpec + <render-spec> and nothing imported it. Comments in surface.component.ts updated.
  • marked was declared in libs/cockpit-shell/package.json but never imported there. It is now a root devDependency, which is what actually satisfies @threadplane/chat's peer for the workspace builds. The chat peer stays: markdown-render.ts loads marked dynamically. The lockfile change is limited to the moved entry (verified against the pre-regeneration copy; Linux swc bindings intact).
  • getInterrupt's JSDoc example called agent.resume('approved'), a method that does not exist; it now shows agent.submit({ resume: 'approved' }). api-docs.json regenerated.

Demo defects fixed

  • Messages example: (submitted) handler called agent.submit() a second time after <chat-input> had already submitted. The binding and handler are removed; the message-model page no longer describes the demo as defective.
  • Threads example: bound [threads]/[activeThreadId] to <chat> AND mounted its own <chat-thread-list>, so desktop viewports showed two lists. <chat> now takes only the agent; the thread-routing page explains the built-in list as an option the demo leaves unbound.

Left alone, on purpose: --tplane-chat-radius-input (declared, read by consumers such as the example layouts, documented as such); unarchive in the threads demo (wired, unreachable without an archived list); the chat-debug demo's lack of a composer (by design).

Verification: nx run-many -t lint,test,build --projects=chat,cockpit-shell green; website unit specs 1290/1290 (positioning guard passes with the peer restored); cockpit-chat-messages-angular and cockpit-chat-threads-angular build and e2e green; generate-api-docs no further drift.

🤖 Generated with Claude Code

… found

- @threadplane/chat no longer exports ./chat.css: ng-package globbed a
  file that has never existed, so the published subpath resolved nothing.
- A2uiSlotDirective and its spec are deleted; the surface renders through
  surfaceToSpec + <render-spec> and nothing imported the directive.
- marked moves from cockpit-shell (which never imports it) to the root
  devDependencies, where it satisfies @threadplane/chat's peer for the
  workspace; the chat peer itself stays because markdown-render.ts loads
  marked dynamically.
- getInterrupt's JSDoc showed agent.resume(), which does not exist; the
  example now uses submit({ resume }).
- The messages demo no longer resubmits from (submitted); the threads demo
  no longer binds [threads] to <chat>, which rendered a second thread list
  on desktop. The message-model and thread-routing pages describe the
  fixed demos; api-docs.json regenerated.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@blove
blove enabled auto-merge (squash) September 6, 2026 21:17
@vercel

vercel Bot commented Sep 6, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
threadplane Ready Ready Preview Sep 6, 2026 9:20pm UTC

Request Review

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated approval: this PR received an intelligent (AI) code review. See the review comments on this PR.

@github-actions

github-actions Bot commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Claude finished @blove's task in 0s —— View job


I'll analyze this and get back to you.

@blove
blove merged commit 4c1db10 into main Sep 6, 2026
77 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant