feat(swimlane): add swimlane engine with first version on SharedWithMe section

added group by:

        - None (= ordered by folders/file name)
        - Type (Folder first, then Image, Vidao, Audio, Document, etc...)
        - Owner
        - Size (With logarithmic groups))
        - Shared date (with groups: today, last 7 days, last 30 days, then year)

static/js/model/grants.js

@@ -88,14 +88,16 @@ const grants = {
      * @param {ResourceTypeEnum[]} [opts.resourceTypes] - Resource types to include (default: ['file','folder']).
      * @param {number}             [opts.limit]         - Max items per page (1–200, default 50).
      * @param {string}             [opts.cursor]        - Opaque cursor from a previous call; omit for first page.
+     * @param {string}             [opts.orderBy]       - Sort dimension: 'granted_at' | 'granted_by' (default: 'granted_at').
      * @returns {Promise<SharedWithMeResponse>}
      */
-    async fetchSharedWithMe({ resourceTypes = ['file', 'folder'], limit = 50, cursor } = {}) {
+    async fetchSharedWithMe({ resourceTypes = ['file', 'folder'], limit = 50, cursor, orderBy } = {}) {
         const params = new URLSearchParams({
             limit: String(limit),
             resource_types: resourceTypes.join(',')
         });
         if (cursor) params.set('cursor', cursor);
+        if (orderBy) params.set('sort_by', orderBy);
 
         const response = await fetch(`/api/grants/incoming/resources?${params}`);
 

static/js/model/systemUsers.js

@@ -96,6 +96,19 @@ function prefetch() {
     _ensureIndex(); // intentionally fire-and-forget
 }
 
+/**
+ * Synchronous best-effort display-name lookup from the pre-fetched cache.
+ * Returns a shortened UUID prefix when the cache is not yet loaded.
+ * Call `prefetch()` at view init time so the cache is warm by the time
+ * items are rendered.
+ * @param {string} userId
+ * @returns {string}
+ */
+function getDisplayNameSync(userId) {
+    if (_index === null) return `${userId.slice(0, 8)}…`;
+    return _index.get(userId) ?? `${userId.slice(0, 8)}…`;
+}
+
 /**
  * Resolve a user UUID to a display name.
  * Awaits the first load if not yet cached; subsequent calls resolve instantly.
@@ -159,4 +172,4 @@ function isAvailable() {
     return addressBook.isSystemAvailable();
 }
 
-export const systemUsers = { prefetch, getDisplayName, getPhoto, getEmail, refreshCurrentUserPhoto, isAvailable };
+export const systemUsers = { prefetch, getDisplayName, getDisplayNameSync, getPhoto, getEmail, refreshCurrentUserPhoto, isAvailable };