@brftech/filex-core 0.30.1 → 0.32.0

package/README.md

@@ -50,7 +50,8 @@ const config = {
   trashVisible: true,
   sideNav: true,          // the navigation panel (default on)
   connections: true,      // its "How to connect" + "API keys" entries
-  uiProfile: 'standard',  // or 'simple' — one pane, list/grid, no tabs
+  uiProfile: 'standard',  // 'simple' — one pane, list/grid, no tabs
+                          // 'drive'  — that, plus the Drive-shaped shell
 };
 </script>
 
@@ -108,7 +109,7 @@ const config = {
   apiBase: 'https://files.example.com',
   auth: { kind: 'bearer', token },
   sideNav: true,          // default; `rootPath` flips it off
-  uiProfile: 'simple',    // 'standard' (default) | 'simple'
+  uiProfile: 'simple',    // 'standard' (default) | 'simple' | 'drive'
 };
 ```
 
@@ -121,11 +122,45 @@ to be told to ask an administrator. Set `connections: false` to leave them out.
 ⚠ Never gated on role in the UI: `/api/tokens` caps every scope against the
 caller's own account, and the panel renders what the API returns.
 
+⚠ **API keys is dropped for an app token** — along with Recent, Starred and
+Shared with me — because those surfaces belong to one person and an app token
+belongs to none. `ConnectionsPanel` degrades with it: the guides stay, and
+`S3KeysPanel` / `SSHKeysPanel` / `NFSExportsPanel` / `TokensPanel` show their
+existing "cannot mint" note instead of a form, driven by the server's 403
+through the `canMint` / `canAdd` flag each composable already reports. That is `callerKind`, read from
+`GET /api/files/capabilities` (`caller_kind`) and overridable per embed; it is a
+credential-kind check, not the role check the paragraph above forbids. "How to
+connect", Upload, the storages and Trash stay. See
+[docs/MCP.md → Token kinds](https://github.com/BRF-Tech/filex/blob/main/docs/MCP.md#token-kinds--user-vs-app).
+
 `uiProfile: 'simple'` is a preset, not a feature switch — nothing is removed
 from the build. It turns off the tab strip and the split pane, reduces the view
 switcher to list + grid, and starts the navigation panel expanded, for the
 people who want a file drive rather than a file manager.
 
+`uiProfile: 'drive'` is `simple` plus the shell those people already know:
+
+- one primary **+ New** menu in the panel (upload files · new folder · request
+  files) instead of the Upload / New folder pair,
+- one **search field across the header** with a ⌘K / Ctrl+K chip that hands the
+  query to the command palette — the field searches the folder you are in, the
+  palette is where "everywhere", saved searches and commands live,
+- a **filter row** under the breadcrumb: Type · Modified · Size,
+- **Folders** and **Files** as labelled sections in grid view,
+- the details panel split into **Details** and **Activity**, with "People with
+  access" and a share-link row,
+- a **storage line** under the navigation (`GET /api/files/quota/me`).
+
+Nothing is removed here either: density, theme, the shortcut editor, the tour
+and the other view modes all live in the header's "⋯" menu, and the view
+switcher and details toggle move to the breadcrumb row rather than disappearing.
+
+⚠ There is deliberately **no People filter** and no Owner column, though the
+mockups this profile came from draw both: a listing row carries no owner
+(`nodes.owner_id` is quota bookkeeping, serialized by nothing) and the listing
+endpoint reads no owner parameter. A chip that opens, offers names and changes
+nothing is worse than no chip.
+
 ### Connections
 
 A second surface, for reaching the same server *without* a browser. filex can