kud/pcloud-ink

@kud/pcloud-ink

☁️ Ink components for rendering pCloud domain objects — file listings, change history, shares, sync health, and the assembled browser.

The presentation layer of the pCloud toolchain: @kud/pcloud provides the types, formatters and rewind engine, this package renders them, and @kud/pcloud-cli consumes them.

Install

npm install @kud/pcloud-ink

ink (=7) and react (=19) are peer dependencies.

Usage

Every list component is presentation-only — props in, no data fetching, no input handling. The consuming surface owns selection, navigation and loading, so the same component composes into a one-shot CLI command or a pane in a larger dashboard.

import { render } from "ink"
import { FileList, sortItems } from "@kud/pcloud-ink"

const { unmount } = render(
  <FileList items={sortItems(contents)} rows={contents.length} />,
)
unmount()

Components

| Component | Renders | | --------------- | ----------------------------------------------- | | FileList | Folder contents — kind, name, size, modified | | ChangesList | Change events, folded into one row per file/day | | ShareList | Folder shares, in either direction | | TrashList | Deleted items, with the id that restores each | | PublinkList | Public links, with downloads and expiry | | RevisionList | A file's revisions, newest first | | SyncList | Local sync pair health | | SettingsPanel | Client ignore rules | | AccountPanel | Email, plan and storage use with a progress bar |

Each takes rows (the visible window height) and an optional selected index. Lists are controlled: pass selected and own the key handling yourself.

The assembled browser

PCloudBrowser is the exception — a full interactive client, not a presentation-only component. It mounts the lists above into six tabs and owns its own navigation.

import { render } from "ink"
import { PCloudBrowser } from "@kud/pcloud-ink"

render(<PCloudBrowser onExit={() => process.exit(0)} api={client} />, {
  alternateScreen: true,
})

| Prop | Purpose | | ---------- | ------------------------------------------------------------------------- | | onExit | Required. The host owns the terminal lifecycle, so quitting is yours | | api | An authenticated client. Omit and the stored credential is used | | sync | Reads local sync pairs. Omit and the Sync tab is absent | | settings | Reads and writes client settings. Omit and the Settings tab is absent |

sync and settings are providers rather than built-in because they read a SQLite database on the host machine, not the pCloud API. A rendering package has no business opening that file, and a consumer with no local pCloud install should not be offered a tab that could only ever be empty.

Helpers