Files
qqq-cli/packages/core
james.maesandClaude Fable 5.1 a8a105a3d5 tui+core: file uploads and BLOB downloads, sort in view settings, more filter operators, width smoke
Forms: BLOB and FILE_UPLOAD fields choose a file in the file navigator and
the record is sent as multipart (create and edit). Process steps hand the
chosen files to the kernel runner through its new stepFiles option, sent
with that step. Record view: a BLOB stored in the record saves through the
save dialog (Enter on the field, or the actions list); child lists offer
Save entries for their BLOB and FILE_DOWNLOAD fields. Verified live on the
sample's Field Lab: a create with blobValue uploaded from a file, then the
value saved back byte for byte.

Grid view settings choose the sort (field and direction), kept per table and
applied when the grid opens. The filter builder offers the operators of the
field type, now with NOT_EQUALS_OR_IS_NULL, IS_NULL_OR_IN, IN on dates and
EQUALS on booleans, and More operators… for the rest. When the column layout
is frozen, text columns take spare width up to 40 cells so later pages have
room before values are cut.

Tests: filtered export (filter and visible columns sent, file written), a
file field uploaded as a multipart part and a BLOB saved from the record
view, runner stepFiles. scripts/smoke-widths.sh checks page 1 against page 2
in tmux on the fake large instance.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-10-31 19:01:16 -05:00
..

@qrun-io/qqq-core

The client kernel the QQQ terminal clients build on: everything that is not a terminal. The CLI prints what it produces; the TUI draws it.

Module What it does
render/output json, table, text, csv and yaml output, JMESPath --query, tty-aware default format
filter/grammar the filter grammar: criteria with shorthand operators, quoted values, AND/OR groups with parentheses, expression values (now(-7d), thisPeriod(month), startOf(quarter,-1), me(), ${variable.x}), parsed to a QueryFilter and printed back
api/operations, api/call the operation index generated from the OpenAPI document, and callOperation(baseUrl, id, input, fetch) to call any operation by id
forms/fields field metadata helpers: contingent-field dependencies and the DISABLE_UNTIL_SET rule, behaviors, validation that mirrors the server's rules
forms/possible-values possible-value search with dependency values; resolution of typed text by id, exact label or unique partial
forms/adjuster form adjusters (onLoad, onChange; 404 means none) and how their output is applied
forms/datetime DATE_TIME between people and the server: local wall-clock text to UTC instants in a zone (DST gaps forward, repeated hours first), instants shown in the zone, server zoned display kept, filter criteria converted
forms/form-session one form being filled: values, display values, clearing dependents, adjusters, validation, submission
process/runner init, step until complete, poll asynchronous jobs, apply metadata adjustments, ask a provider for each step's input, go back (BACK), cancel on an abort signal (POST …/cancel), check min/max input records
process/screen each step's components as neutral screen blocks: help, HTML as text, view pairs, process records (paged), validation review, summary lines, downloads (GET /download), widgets
records/associations related records: association labels, the values binding a child to its parent (composite joins too), child-list filters, the association tree of a record read with includeAssociations, child pages with counts
records/record-view the record view as text: sections without hidden sections or fields, adornments (LINK, CHIP, REVEAL, RENDER_HTML, CODE_EDITOR, ERROR, FILE_DOWNLOAD, WIDGET, TOOLTIP), view-screen help by role
widgets/render-model any widget payload to neutral blocks (heading, stat, table, series, pairs, steps, alert, link, rule, children) and blocks to text
metadata/cache on-disk cache of GET /metaData and table definitions per server, with a TTL and offline reads
extensions/registry every extension the client document carries (operations, documented minimum version, realtime channels), joined with the server's GET /version: has, require (typed ExtensionNotInstalledError), unknown extensions kept; see src/extensions/README.md
extensions/collaboration the collaboration qbit: live presence (joinPresence, a no-op without the extension), comments, favorites, recents, follow, people, my work
session/profiles, session/keyring named profiles and an OS keyring without native modules (Keychain, Secret Service, DPAPI, file)

Rules the kernel keeps for both heads: every call is a spec operation named by operationId; text comes from the server (labels, never names); unknown enum values and extra fields are tolerated; no table, process or capability name is hard-coded; no Bun-only or terminal API is used.

npm run build -w @qrun-io/qqq-core && npm test -w @qrun-io/qqq-core