@zephytiju/prism-quick-files 0.1.0

package/dist/visibleRows.js

@@ -0,0 +1,57 @@
+/** Mono size formatter for the row meta fallback (B / KB / MB). */
+export function formatBytes(sizeBytes) {
+    if (!Number.isFinite(sizeBytes) || sizeBytes < 0) {
+        return "—";
+    }
+    if (sizeBytes < 1024) {
+        return `${sizeBytes} B`;
+    }
+    if (sizeBytes < 1024 * 1024) {
+        return `${(sizeBytes / 1024).toFixed(1)} KB`;
+    }
+    return `${(sizeBytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+ * Applies the panel's row visibility and ordering rules to the fetched
+ * entries: search-text match (name + meta + kind), the categoryFilters
+ * configuration key, and the recencyWindowMs configuration key (entries
+ * without a timestamp are kept) — then pinned-first, most-recently-opened,
+ * name ordering.
+ */
+export function selectVisibleRows(entries, search, categoryFilters, recencyWindowMs) {
+    const needle = search.trim().toLowerCase();
+    const filters = categoryFilters ?? [];
+    const now = Date.now();
+    const visible = entries.filter((entry) => {
+        if (needle !== "") {
+            const meta = entry.meta ?? "";
+            const haystack = `${entry.name} ${meta} ${entry.kind}`.toLowerCase();
+            if (!haystack.includes(needle)) {
+                return false;
+            }
+        }
+        if (filters.length > 0 && !filters.includes(entry.kind)) {
+            return false;
+        }
+        if (recencyWindowMs !== undefined) {
+            const opened = Date.parse(entry.lastOpenedAt ?? "");
+            if (!Number.isNaN(opened) && now - opened > recencyWindowMs) {
+                return false;
+            }
+        }
+        return true;
+    });
+    return [...visible].sort((a, b) => {
+        if ((b.pinned ?? false) !== (a.pinned ?? false)) {
+            return (b.pinned ?? false) ? 1 : -1;
+        }
+        const at = Date.parse(a.lastOpenedAt ?? "");
+        const bt = Date.parse(b.lastOpenedAt ?? "");
+        const aTime = Number.isNaN(at) ? Number.NEGATIVE_INFINITY : at;
+        const bTime = Number.isNaN(bt) ? Number.NEGATIVE_INFINITY : bt;
+        if (aTime !== bTime) {
+            return bTime - aTime;
+        }
+        return a.name.localeCompare(b.name);
+    });
+}

package/locales/en.json

@@ -0,0 +1,20 @@
+{
+  "quick-files": {
+    "panelTitle": "QUICK FILE INSERT",
+    "panelSubtitle": "WORLD VIEWS, DOSSIERS, BOARDS, EVIDENCE",
+    "trailingMetaCount": "{count} FILES",
+    "searchPlaceholder": "Search recent files and world views",
+    "searchLabel": "Search files",
+    "sectionHint": "FILES ARE THE SHORTCUT",
+    "sectionRecent": "RECENT / COMMON FILES",
+    "infoCardTitle": "DROP-IN FILE MODEL",
+    "infoCardBody": "World views are versioned spatial metadata files. Insert one here to reload its saved selection, time, layers, camera, and scenario inside the dossier. Component types remain in each block's + menu.",
+    "insertLabel": "Insert {name}",
+    "dragLabel": "Drag {name} to insert",
+    "emptyTitle": "No files yet",
+    "emptyHint": "Files from VAULT appear here once opened or pinned.",
+    "noMatches": "No files match the search.",
+    "errorTitle": "File listing failed",
+    "retry": "Retry"
+  }
+}

package/locales/zh-CN.json

@@ -0,0 +1,20 @@
+{
+  "quick-files": {
+    "panelTitle": "快速插入文件",
+    "panelSubtitle": "世界视图 · 卷宗 · 看板 · 证据",
+    "trailingMetaCount": "{count} 个文件",
+    "searchPlaceholder": "搜索最近的文件与世界视图",
+    "searchLabel": "搜索文件",
+    "sectionHint": "文件即捷径",
+    "sectionRecent": "最近 / 常用文件",
+    "infoCardTitle": "置入文件模型",
+    "infoCardBody": "世界视图是带版本的空间元数据文件。在此插入即可在卷宗内恢复其保存的选择、时间、图层、相机与情景。组件类型仍保留在每个区块的 + 菜单中。",
+    "insertLabel": "插入 {name}",
+    "dragLabel": "拖动 {name} 以插入",
+    "emptyTitle": "暂无文件",
+    "emptyHint": "来自 VAULT 的文件在打开或固定后会显示在此。",
+    "noMatches": "没有符合搜索条件的文件。",
+    "errorTitle": "文件列表加载失败",
+    "retry": "重试"
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@zephytiju/prism-quick-files",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Platform Prism quick-files micro-UI (component id \"quick-files\"): the Dossier Quick File Insert side panel \u2014 QUICK FILE INSERT title header, search box, FILES ARE THE SHORTCUT / RECENT-COMMON FILES sections, per-prototype file rows (world view / dossier doc / board / folder icons with semantic kind tokens, name + mono meta line, + insert action) and the DROP-IN FILE MODEL info card. Rows are indexed through the IFileEntry list query; insert (+) and drag-start publish ONLY a bounded drag/insert state {entryId, kind, name, mime, snapshotRef, sourcePanel} on the quick-files.drag-state channel \u2014 receivers interpret it themselves (D6 decoupling); ESC / drag-end clears it. Ships en + zh-CN locale bundles.",
+  "license": "UNLICENSED",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./locales/*": "./locales/*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "locales"
+  ],
+  "scripts": {
+    "dev": "vite --host 127.0.0.1",
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-locales.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "shot-demo": "node scripts/shot-demo.mjs"
+  },
+  "peerDependencies": {
+    "@mantine/core": "^8.1.1",
+    "@zephytiju/lattice-common-interfaces": ">=0.1.0",
+    "@zephytiju/prism-react": ">=0.1.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0"
+  },
+  "devDependencies": {
+    "@mantine/core": "8.1.1",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/node": "^22.10.2",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "@zephytiju/lattice-common-interfaces": "0.1.0",
+    "@zephytiju/prism-react": "0.1.0",
+    "jsdom": "^25.0.1",
+    "puppeteer-core": "^24.10.0",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "typescript": "^5.7.2",
+    "vite": "6.0.5",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zephytiju/PrismQuickFilesMicroUI.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zephytiju/PrismQuickFilesMicroUI/issues"
+  },
+  "homepage": "https://github.com/zephytiju/PrismQuickFilesMicroUI#readme"
+}