Expand description
Utilities for Wind handlers, grouped by purpose. Sub-module helpers
(hex_digit, percent_decode, normalize_uri_path, etc.) stay co-
located with their single public entry point - splitting by strict one-
fn-per-file would fragment tightly coupled internals for no readability
gain.
No pub use. External callers must spell
Utilities::<Domain>::<Function>.
Modules§
- Application
Root /Static/Application/→ Sky Target real path. The static root is seeded once byAppLifecycle::Dirswith the resolvedSky/Targetdirectory (debug) or the bundle resource dir (release) sofile:readon anyStatic/Application/...URI lands on the real asset.- Channel
Priority - Maps a wire command string → Echo scheduler lane via the Common
Channelregistry’sPriority()accessor. Unknown commands fall back toPriority::Normalso unclassified callers don’t starve the high-priority queue. - Json
Value Helpers - Serde-Value helpers shared across Wind handlers.
v_strextracts a string from either a raw JSON string or a VS CodeUriComponentsobject (external/pathfield). Any new cross-cutting coercer that accepts both shapes belongs here. - Metadata
Encoding - Converts
std::fs::Metadatato VS Code’sIStatwire shape. TheFileTypebits are VS Code’s enum (File=1, Directory=2, SymbolicLink=64); the readdir atoms also emit these values. - Path
Extraction - Converts VS Code
Uri-shaped arguments to platform-native paths. Co-locates percent-decoding, userdata remapping, and/Static/Applicationrewriting because each is a private helper ofextract_path_from_arg. Percent-decoding is also re-exported for callers outside the VFS path (configuration loaders, etc.). - Recently
Opened - Recently-opened workspaces/files persistence.
File lives at
~/.land/workspaces/RecentlyOpened.json. Parse failures degrade to an empty{workspaces, files}envelope so the UI never sees a missing field. - Userdata
Dir - Canonical userdata base directory (Tauri
app_data_dir) + first-access scaffolding. Seeded byAppLifecycle::Dirsso every/User/...URI the renderer emits lands under the bundle-identifier-qualified Application Support path VS Code’s profile system expects.