description, kind
| description | kind |
|---|---|
| In-app directory-browsing surface: the Miller-column Select Workspace Directory dialog that fills workspace directory flows; for users and maintainers of the Web picking experience. | package-reference |
@deepseek-ai/dsh-client-ui-directory-picker-browse
English | 中文
Summary
This package provides the in-app directory-browsing surface for the Web GUI: a Select Workspace Directory dialog that lists, navigates, and creates folders through the local Host, with no operating-system chooser involved. It fills the two directory-flow slots declared by ui-workspace, composing the client side of the browse picking interaction in one cordis.yml row. Choose it when the browser is remote or in-process and no local OS chooser exists; local deployments may prefer the -native surface.
Table of Contents
- Use this package
- Understand the implementation
- Further Exploration
- Model Experience
- Known Limitations and Deferred Work
- Dev Note
Use this package
Mount this plugin alongside ui-workspace and the host backend dsh-host-directory-picker-browse; one cordis.yml row then composes the whole browse picking interaction. When a workspace flow opens a directory request, the user sees the in-app dialog: a header with the path breadcrumb and an editable path zone, then a single full-width level until a row is selected, after which the row splits into level and children columns.
Navigating and creating
Step through folders, edit the path directly, or filter the last pane by prefix; a Host-flagged hidden entry stays hidden until the footer toggle reveals it. New folder opens a nested create dialog targeting the selected folder and selects what it creates; Open adopts the selected folder, falling back to the listed level. Confirming a directory is the picked path; dismissing the dialog is the cancellation.
Understand the implementation
Implementation internals — click to expand
The dialog is a 680×500 Miller-column view (clamped on short or narrow viewports), driven by the host listDirectory and createDirectory primitives through ctx.workspaces. Both registrations install as one transactional effect through nested ctx.slots.inject() calls, because either declaring entry may activate later or replace its declaration; the dialog's copy lives in this package's own locale namespace so the two dictionaries land as a unit. Browse failures stay inside the dialog's own alert surfaces, so this occupant never drives the owner's onError arm. The node half is an empty apply that keeps the plugin on the host roster.
Further Exploration
Read these pages when the picking surface is not enough. They move from the browser half to the host backend and the slots it fills.
- dsh-host-directory-picker-browse — the directory-listing backend this surface drives.
- ui-workspace — declares the directory-flow slots and owns the picking conversation.
- ui-directory-picker-native — the native OS-chooser alternative for local deployments.
- Web client architecture — how browser plugin rows load and register slots.
Model Experience
None, as the directory browser is browser chrome; nothing here reaches a model request.
KV Cache effect
None; this package neither assembles nor sends a provider request.
Known Limitations and Deferred Work
These limits define the current browse surface. They are current package constraints, not a general file-browser comparison or a task backlog.
- No search, no multi-select, and no rename or delete — the dialog lists and creates directories; a target is reached by navigating, editing the path, or filtering the last pane by prefix.
- Hidden-entry filtering is client-side — the Host always lists hidden entries and flags them, so the toggle changes only what the dialog renders.
Dev Note
Working context for maintainers — click to expand
None.