@nicemeta/file-manager 0.6.4

package/dist/lib-static/file-manager/css/file-manager.css

@@ -0,0 +1 @@
+@font-face{font-family:'Material Symbols';font-style:normal;font-weight:400;font-display:swap;src:url('../fonts/symbols.woff2') format('woff2')}:root{--bg:#0d1117;--bg-card:#151c2c;--bg-card-hover:#1c2438;--bg-surface:#151c2c;--bg-hover:#1c2438;--bg-active:#243044;--text:#e0e6ed;--text-muted:#546178;--accent:#6c7ee1;--accent-hover:#8b9bf0;--icon-color:#6c7ee1;--delete-color:#df4d4d;--drop-ok:#4caf50;--drop-reject:#f44336;--radius:10px;--radius-sm:6px;--transition:0.18s ease;--zoom:1}*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}html,body{background:var(--bg);color:var(--text);font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:14px;line-height:1.5;height:100%;overflow:hidden}body{display:flex;flex-direction:column;padding:16px 24px;gap:8px}a{color:var(--accent);text-decoration:none;transition:color var(--transition)}a:hover{color:var(--accent-hover)}.breadcrumb{display:flex;align-items:center;flex-wrap:wrap;gap:2px;padding:6px 8px;font-size:13px;min-height:32px;flex-shrink:0}.breadcrumb a{padding:2px 6px;border-radius:var(--radius-sm);transition:background var(--transition),color var(--transition);color:var(--text)}.breadcrumb a:hover{background:var(--bg-hover);color:var(--accent-hover)}#content-pane{flex:1;overflow:hidden;border-radius:var(--radius);border:2px solid transparent;transition:border-color 0.25s ease,box-shadow 0.25s ease;position:relative;display:flex;flex-direction:column}#content-pane.drop-zone-active{border-color:var(--drop-ok);box-shadow:inset 0 0 40px rgba(76,175,80,0.10)}#content-pane.drop-zone-reject{border-color:var(--drop-reject);box-shadow:inset 0 0 40px rgba(244,67,54,0.10)}.file-list{list-style:none;flex:1;overflow-y:auto;overflow-x:hidden;padding:4px 0;display:grid;grid-template-columns:repeat(auto-fill,minmax(200px,1fr));grid-auto-rows:min-content;gap:12px;align-content:start;transform:scale(var(--zoom));transform-origin:top left;width:calc(100% / var(--zoom));height:calc(100% / var(--zoom))}.file-list::-webkit-scrollbar{width:6px}.file-list::-webkit-scrollbar-track{background:transparent}.file-list::-webkit-scrollbar-thumb{background:#2a3548;border-radius:3px}.file-list::-webkit-scrollbar-thumb:hover{background:#3a4a60}.file-list .section-header{grid-column:1 / -1;font-size:13px;font-weight:600;color:var(--text);padding:8px 4px 0;border:none;background:none;min-height:auto;cursor:default}.file-list .section-header:hover{background:none}.file-list li{display:flex;align-items:center;gap:14px;padding:14px 16px;border-radius:var(--radius);background:var(--bg-card);cursor:default;transition:background var(--transition);min-height:72px;overflow:hidden;position:relative}.file-list li:hover{background:var(--bg-card-hover)}.file-list li.folder-drop-hover{background:rgba(76,175,80,0.12);outline:2px solid var(--drop-ok);outline-offset:-2px}.mi{font-family:'Material Symbols';font-style:normal;font-weight:normal;text-rendering:optimizeLegibility;font-feature-settings:'liga';font-variation-settings:'FILL' 0,'GRAD' 0,'opsz' 48,'wght' 400;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;display:inline-flex;align-items:center;justify-content:center;vertical-align:middle}.mi-filled{font-variation-settings:'FILL' 1,'GRAD' 0,'opsz' 48,'wght' 400}.card-icon{flex-shrink:0;width:44px;height:44px;font-size:44px;line-height:1;color:var(--icon-color)}.card-info{flex:1;min-width:0;display:flex;flex-direction:column;gap:1px}.card-info .name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--text);font-size:13px;font-weight:500}.card-info .meta{font-size:11px;color:var(--text-muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.directory .card-link{display:flex;align-items:center;gap:14px;color:var(--text);flex:1;min-width:0}.directory .card-link:hover{color:var(--text)}.directory .card-link:hover .name{color:var(--accent-hover)}.file .card-content{display:flex;align-items:center;gap:14px;flex:1;min-width:0}.item-tool{display:none;align-items:center;gap:4px;flex-shrink:0;position:absolute;top:6px;right:6px}li:hover .item-tool{display:inline-flex}.item-tool a{font-size:18px;opacity:0.5;transition:opacity var(--transition),color var(--transition);padding:3px;line-height:1;border-radius:4px;color:var(--text-muted)}.item-tool a:hover{opacity:1;background:var(--bg-active)}.item-tool a.delete{color:var(--delete-color);opacity:0.6}.item-tool a.delete:hover{color:#ff6b6b;opacity:1}.item-tool a.download:hover{color:var(--accent-hover)}.item-tool a.view:hover{color:var(--text)}#zoom-control{display:flex;align-items:center;gap:8px;padding:6px 12px;flex-shrink:0;font-size:11px;color:var(--text-muted);user-select:none}#zoom-control label{white-space:nowrap}#zoom-control input[type="range"]{-webkit-appearance:none;appearance:none;width:100px;height:3px;background:#1c2438;border-radius:2px;outline:none;cursor:pointer}#zoom-control input[type="range"]::-webkit-slider-thumb{-webkit-appearance:none;appearance:none;width:12px;height:12px;background:var(--accent);border-radius:50%;cursor:pointer;transition:background var(--transition)}#zoom-control input[type="range"]::-webkit-slider-thumb:hover{background:var(--accent-hover)}#zoom-control input[type="range"]::-moz-range-thumb{width:12px;height:12px;background:var(--accent);border-radius:50%;border:none;cursor:pointer}#zoom-control span{min-width:32px;text-align:right}#mobile-upload{display:none}@media (pointer:coarse){#mobile-upload{display:inline-flex;align-items:center;justify-content:center;position:fixed;bottom:60px;right:20px;width:48px;height:48px;border-radius:50%;background:var(--accent);color:#fff;font-size:24px;border:none;cursor:pointer;box-shadow:0 2px 12px rgba(0,0,0,0.5);z-index:100}#mobile-upload .mi{font-size:24px}#mobile-upload:hover{background:var(--accent-hover)}}#drop-message{display:none;position:absolute;inset:0;background:rgba(13,17,23,0.88);color:var(--text);font-size:18px;align-items:center;justify-content:center;border-radius:var(--radius);pointer-events:none;z-index:10}#content-pane.drop-zone-active #drop-message,#content-pane.drop-zone-reject #drop-message{display:flex}#confirm-overlay{display:none;position:fixed;inset:0;z-index:200;background:rgba(0,0,0,0.6);align-items:center;justify-content:center}#confirm-overlay.visible{display:flex}#confirm-panel{background:var(--bg-card);border:1px solid #1c2438;border-radius:var(--radius);padding:24px 28px;min-width:320px;max-width:440px;box-shadow:0 12px 40px rgba(0,0,0,0.6);display:flex;flex-direction:column;gap:16px}#confirm-panel .confirm-title{font-size:15px;font-weight:600;color:var(--text);display:flex;align-items:center;gap:8px}#confirm-panel .confirm-title .mi{color:var(--delete-color);font-size:22px}#confirm-panel .confirm-message{font-size:13px;color:var(--text-muted);word-break:break-all}#confirm-panel .confirm-buttons{display:flex;justify-content:flex-end;gap:10px;margin-top:4px}#confirm-panel button{padding:6px 20px;border-radius:var(--radius-sm);border:1px solid #1c2438;font-size:13px;cursor:pointer;transition:background var(--transition),border-color var(--transition)}#confirm-panel .btn-cancel{background:var(--bg-hover);color:var(--text)}#confirm-panel .btn-cancel:hover{background:var(--bg-active)}#confirm-panel .btn-ok{background:var(--delete-color);color:#fff;border-color:var(--delete-color)}#confirm-panel .btn-ok:hover{background:#e85858;border-color:#e85858}

package/dist/lib-static/file-manager/index.html

@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>File Manager</title>
+    <link rel="stylesheet" href="css/file-manager.css">
+</head>
+
+<body>
+
+<p id="breadCrumb" class="breadcrumb"></p>
+
+<div id="content-pane">
+    <div id="drop-message">Drop files to upload</div>
+    <ul id="file-list" class="file-list"></ul>
+</div>
+
+<!-- Mobile-only upload button (touch devices without drag-and-drop) -->
+<button id="mobile-upload" title="Upload files"><i class="mi">upload</i></button>
+<input type="file" id="mobile-file-input" multiple style="display:none">
+
+<div id="zoom-control">
+    <label for="zoom-slider">Zoom</label>
+    <input type="range" id="zoom-slider" min="0.7" max="2" step="0.05" value="1">
+    <span id="zoom-value">100%</span>
+</div>
+
+<!-- Delete confirmation overlay -->
+<div id="confirm-overlay">
+    <div id="confirm-panel">
+        <div class="confirm-title"><i class="mi">delete</i> Confirm Delete</div>
+        <div class="confirm-message" id="confirm-message"></div>
+        <div class="confirm-buttons">
+            <button class="btn-cancel" id="confirm-cancel">Cancel</button>
+            <button class="btn-ok" id="confirm-ok">Delete</button>
+        </div>
+    </div>
+</div>
+
+<script>"use strict";const API={list:"api/list?path=",download:"api/download?path=",zip:"api/zip?path=",view:"api/view?path=",delete:"api/delete?path=",upload:"api/upload?path="},fmUri="?path=",ZOOM_BASE=1.05,contentPane=document.getElementById("content-pane"),fileList=document.getElementById("file-list"),breadCrumb=document.getElementById("breadCrumb"),dropMessage=document.getElementById("drop-message"),zoomSlider=document.getElementById("zoom-slider"),zoomValue=document.getElementById("zoom-value"),mobileUpload=document.getElementById("mobile-upload"),mobileFileInput=document.getElementById("mobile-file-input"),confirmOverlay=document.getElementById("confirm-overlay"),confirmMessage=document.getElementById("confirm-message"),confirmOk=document.getElementById("confirm-ok"),confirmCancel=document.getElementById("confirm-cancel");let currentPath="",currentWritable=!1,dragCounter=0,scrollDebounce=null,pendingDeleteUrl=null;function encodePath(e){return encodeURIComponent(e).replace(/%2F/g,"/")}function formatSize(e){if(e==null)return"\u2014";if(e===0)return"0 B";const n=["B","KB","MB","GB","TB"],o=Math.floor(Math.log(e)/Math.log(1024)),r=e/Math.pow(1024,o);return(o===0?r:r.toFixed(2))+" "+n[o]}function timeAgo(e){if(!e)return"";const n=new Date(e);if(isNaN(n.getTime()))return"";const o=Math.floor((Date.now()-n.getTime())/1e3);if(o<60)return"just now";const r=[[31536e3,"year"],[2592e3,"month"],[86400,"day"],[3600,"hour"],[60,"minute"]];for(const[a,s]of r){const i=Math.floor(o/a);if(i>=1)return i===1?"a "+s+" ago":i+" "+s+"s ago"}return"just now"}function applyZoom(e){const n=e*ZOOM_BASE;document.documentElement.style.setProperty("--zoom",n),zoomSlider.value=e,zoomValue.textContent=Math.round(e*100)+"%",localStorage.setItem("fm-zoom",e)}(function(){const n=localStorage.getItem("fm-zoom"),o=parseFloat(zoomSlider.min),r=parseFloat(zoomSlider.max),a=n?Math.min(r,Math.max(o,parseFloat(n))):1;applyZoom(a)})(),zoomSlider.addEventListener("input",()=>applyZoom(parseFloat(zoomSlider.value)));function saveScroll(){currentPath!==void 0&&localStorage.setItem("fm-scroll-"+currentPath,fileList.scrollTop)}function restoreScroll(){const e=localStorage.getItem("fm-scroll-"+currentPath);e&&(fileList.scrollTop=parseInt(e,10))}fileList.addEventListener("scroll",()=>{clearTimeout(scrollDebounce),scrollDebounce=setTimeout(saveScroll,200)});function uploadFiles(e,n){if(!e||e.length===0)return;const o=new FormData;for(const a of e)o.append("file",a);const r=API.upload+encodePath(n);fetch(r,{method:"POST",body:o}).then(()=>loadDirectory(currentPath)).catch(a=>console.error("Upload failed:",a))}document.addEventListener("dragover",e=>e.preventDefault()),document.addEventListener("drop",e=>e.preventDefault()),contentPane.addEventListener("dragenter",e=>{e.preventDefault(),dragCounter++,dragCounter===1&&(contentPane.classList.add(currentWritable?"drop-zone-active":"drop-zone-reject"),dropMessage.textContent=currentWritable?"Drop files to upload":"This folder is read-only")}),contentPane.addEventListener("dragover",e=>{e.preventDefault(),e.dataTransfer.dropEffect=currentWritable?"copy":"none"}),contentPane.addEventListener("dragleave",e=>{e.preventDefault(),dragCounter--,dragCounter<=0&&(dragCounter=0,contentPane.classList.remove("drop-zone-active","drop-zone-reject"))}),contentPane.addEventListener("drop",e=>{e.preventDefault(),dragCounter=0,contentPane.classList.remove("drop-zone-active","drop-zone-reject"),currentWritable&&e.dataTransfer.files.length>0&&uploadFiles(e.dataTransfer.files,currentPath)}),mobileUpload.addEventListener("click",()=>mobileFileInput.click()),mobileFileInput.addEventListener("change",()=>{mobileFileInput.files.length>0&&currentWritable&&(uploadFiles(mobileFileInput.files,currentPath),mobileFileInput.value="")});function requestDelete(e,n){pendingDeleteUrl=e,confirmMessage.textContent="Are you sure you want to delete \u201C"+n+"\u201D?",confirmOverlay.classList.add("visible")}confirmOk.addEventListener("click",()=>{confirmOverlay.classList.remove("visible"),pendingDeleteUrl&&fetch(pendingDeleteUrl,{method:"DELETE"}).then(()=>{pendingDeleteUrl=null,loadDirectory(currentPath)}).catch(e=>{pendingDeleteUrl=null,console.error("Delete failed:",e)})}),confirmCancel.addEventListener("click",()=>{confirmOverlay.classList.remove("visible"),pendingDeleteUrl=null}),confirmOverlay.addEventListener("click",e=>{e.target===confirmOverlay&&(confirmOverlay.classList.remove("visible"),pendingDeleteUrl=null)}),document.addEventListener("keydown",e=>{confirmOverlay.classList.contains("visible")&&(e.key==="Escape"?confirmCancel.click():e.key==="Enter"&&confirmOk.click())});function createItemTools(e,n,o,r,a){const s=document.createElement("span");s.classList.add("item-tool");const i=document.createElement("a");if(i.classList.add("download","mi"),i.href=o?API.zip+e:API.download+e,i.title="Download",i.textContent="download",s.appendChild(i),!o){const t=document.createElement("a");t.classList.add("view","mi"),t.href=API.view+e,t.target="_blank",t.title="View",t.textContent="open_in_new",s.appendChild(t)}if(!a&&r){const t=document.createElement("a");t.classList.add("delete","mi"),t.href="javascript:void(0)",t.title="Delete",t.textContent="delete",t.addEventListener("click",d=>{d.preventDefault(),requestDelete(API.delete+e,n)}),s.appendChild(t)}return s}function createItem(e){const n=e.parent?encodePath(e.parent+(e.parent.endsWith("/")?"":"/")+e.name):e.name,o=document.createElement("li");o.classList.add(e.isDirectory?"directory":"file");const r=document.createElement("i");r.classList.add("mi","card-icon"),e.isDirectory?(r.classList.add("mi-filled"),r.textContent="folder"):r.textContent="description";const a=document.createElement("div");a.classList.add("card-info");const s=document.createElement("span");s.classList.add("name"),s.textContent=e.isDirectory?e.name.replace(/:[/]$/,""):e.name,a.appendChild(s);const i=document.createElement("span");if(i.classList.add("meta"),i.textContent=e.isDirectory?"\u2014":formatSize(e.length),a.appendChild(i),e.modified){const t=document.createElement("span");t.classList.add("meta"),t.textContent=timeAgo(e.modified),a.appendChild(t)}if(e.isDirectory){const t=document.createElement("a");t.classList.add("card-link"),t.href="javascript:void(0)",t.addEventListener("click",()=>navigateTo(n)),t.appendChild(r),t.appendChild(a),o.appendChild(t)}else{const t=document.createElement("span");t.classList.add("card-content"),t.appendChild(r),t.appendChild(a),o.appendChild(t)}if(o.appendChild(createItemTools(n,e.name,e.isDirectory,e.isWritable,e.hasChildren)),e.isDirectory){let t=0;o.addEventListener("dragenter",d=>{d.preventDefault(),d.stopPropagation(),t++,t===1&&e.isWritable&&o.classList.add("folder-drop-hover")}),o.addEventListener("dragover",d=>{d.preventDefault(),d.stopPropagation(),d.dataTransfer.dropEffect=e.isWritable?"copy":"none"}),o.addEventListener("dragleave",d=>{d.preventDefault(),d.stopPropagation(),t--,t<=0&&(t=0,o.classList.remove("folder-drop-hover"))}),o.addEventListener("drop",d=>{if(d.preventDefault(),d.stopPropagation(),t=0,o.classList.remove("folder-drop-hover"),dragCounter=0,contentPane.classList.remove("drop-zone-active","drop-zone-reject"),e.isWritable&&d.dataTransfer.files.length>0){const c=e.parent?e.parent+(e.parent.endsWith("/")?"":"/")+e.name:e.name;uploadFiles(d.dataTransfer.files,c)}})}return o}function createSectionHeader(e){const n=document.createElement("li");return n.classList.add("section-header"),n.textContent=e,n}function createBreadCrumb(e,n){const o=document.createElement("span");return e&&(e.slice().reverse().forEach(r=>{const a=document.createElement("a");a.href="javascript:void(0)",a.addEventListener("click",()=>navigateTo(r.path)),a.textContent=r.name,o.appendChild(a),o.appendChild(document.createTextNode(" / "))}),o.appendChild(document.createTextNode(n))),o}function loadDirectory(e){fetch(API.list+encodePath(e)).then(n=>n.json()).then(n=>{currentWritable=n.isWritable,contentPane.dataset.writable=n.isWritable,breadCrumb.innerHTML="",breadCrumb.style.display=n.path==="/"?"none":"",breadCrumb.appendChild(createBreadCrumb(n.parentInfos,n.name)),fileList.innerHTML="";const o=!1;if(n.files&&n.files.length>0){const r=[],a=[];n.files.forEach(s=>{(!s.name.startsWith(".")||o)&&(s.isDirectory?r:a).push(s)}),r.length>0&&(fileList.appendChild(createSectionHeader("Folders")),r.forEach(s=>fileList.appendChild(createItem(s)))),a.length>0&&(fileList.appendChild(createSectionHeader("Files")),a.forEach(s=>fileList.appendChild(createItem(s))))}requestAnimationFrame(restoreScroll)})}function navigateTo(e){saveScroll(),currentPath=e||"",window.history.pushState(currentPath,"",fmUri+encodePath(currentPath)),loadDirectory(currentPath)}window.addEventListener("popstate",e=>{saveScroll(),currentPath=e.state!=null?e.state:"",loadDirectory(currentPath)});const params=new URLSearchParams(window.location.search),initPath=params.has("path")?params.get("path"):"";currentPath=initPath,window.history.replaceState(initPath,"",fmUri+encodePath(initPath)),loadDirectory(initPath);</script>
+</body>
+</html>

package/dist/openapi.json

@@ -0,0 +1 @@
+{"openapi":"3.0.3","info":{"title":"File Manager API","description":"File system browsing, upload, download, and management","version":"0.1.0"},"servers":[{"url":"/"}],"tags":[{"name":"File Manager","description":"File system browsing, upload, download, and management"}],"paths":{"/file-manager/api/list":{"get":{"tags":["File Manager"],"summary":"List directory contents","description":"Returns the contents of the specified directory including file metadata","parameters":[{"name":"path","in":"query","description":"Absolute path of the directory to list","schema":{"type":"string","default":"/"}}],"responses":{"200":{"description":"Directory listing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectoryInfo"}}}}}}},"/file-manager/api/download":{"get":{"tags":["File Manager"],"summary":"Download a file","description":"Downloads the specified file as an attachment","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the file to download","schema":{"type":"string"}}],"responses":{"200":{"description":"File content","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Path is not a file"}}}},"/file-manager/api/zip":{"get":{"tags":["File Manager"],"summary":"Download as ZIP","description":"Downloads the specified file or directory as a ZIP archive","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the file or directory to zip","schema":{"type":"string"}}],"responses":{"200":{"description":"ZIP archive","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}}}}},"/file-manager/api/view":{"get":{"tags":["File Manager"],"summary":"View a file inline","description":"Returns the file content for inline viewing in the browser","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the file to view","schema":{"type":"string"}}],"responses":{"200":{"description":"File content (inline)","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Path is not a file"}}}},"/file-manager/api/delete":{"delete":{"tags":["File Manager"],"summary":"Delete a file or directory","description":"Recursively deletes the specified file or directory","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the file or directory to delete","schema":{"type":"string"}}],"responses":{"204":{"description":"Successfully deleted"}}}},"/file-manager/api/upload":{"post":{"tags":["File Manager"],"summary":"Upload files to a directory","description":"Uploads one or more files to the specified directory","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the target directory","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"array","items":{"type":"string","format":"binary"}}}}}}},"responses":{"200":{"description":"Files uploaded successfully"}}}},"/file-manager/api/mode":{"put":{"tags":["File Manager"],"summary":"Change file permissions","description":"Changes read/write/execute permissions. Mode format: +rwx or -rwx","parameters":[{"name":"path","in":"query","required":true,"description":"Absolute path of the file","schema":{"type":"string"}},{"name":"mode","in":"query","required":true,"description":"Permission mode (e.g. +rw, -x)","schema":{"type":"string"}}],"responses":{"200":{"description":"Permissions changed"}}}}},"components":{"schemas":{"DirectoryInfo":{"type":"object","properties":{"name":{"type":"string"},"path":{"type":"string"},"isWritable":{"type":"boolean"},"parentInfos":{"type":"array","items":{"$ref":"#/components/schemas/ParentInfo"}},"files":{"type":"array","items":{"$ref":"#/components/schemas/FileInfo"}}}},"ParentInfo":{"type":"object","properties":{"path":{"type":"string"},"name":{"type":"string"}}},"FileInfo":{"type":"object","properties":{"parent":{"type":"string"},"name":{"type":"string"},"length":{"type":"integer","format":"int64"},"isDirectory":{"type":"boolean"},"isReadable":{"type":"boolean"},"isWritable":{"type":"boolean"},"isExecutable":{"type":"boolean"},"hasChildren":{"type":"boolean"},"modified":{"type":"string","description":"ISO local date-time (no timezone)"},"created":{"type":"string","description":"ISO local date-time (no timezone)"}}}}}}

package/dist/openapi.yaml

@@ -0,0 +1,219 @@
+openapi: 3.0.3
+info:
+  title: File Manager API
+  description: File system browsing, upload, download, and management
+  version: 0.1.0
+servers:
+  - url: /
+tags:
+  - name: File Manager
+    description: File system browsing, upload, download, and management
+paths:
+  /file-manager/api/list:
+    get:
+      tags: [File Manager]
+      summary: List directory contents
+      description: Returns the contents of the specified directory including file metadata
+      parameters:
+        - name: path
+          in: query
+          description: Absolute path of the directory to list
+          schema:
+            type: string
+            default: /
+      responses:
+        '200':
+          description: Directory listing
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DirectoryInfo'
+
+  /file-manager/api/download:
+    get:
+      tags: [File Manager]
+      summary: Download a file
+      description: Downloads the specified file as an attachment
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file to download
+          schema:
+            type: string
+      responses:
+        '200':
+          description: File content
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+        '400':
+          description: Path is not a file
+
+  /file-manager/api/zip:
+    get:
+      tags: [File Manager]
+      summary: Download as ZIP
+      description: Downloads the specified file or directory as a ZIP archive
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file or directory to zip
+          schema:
+            type: string
+      responses:
+        '200':
+          description: ZIP archive
+          content:
+            application/zip:
+              schema:
+                type: string
+                format: binary
+
+  /file-manager/api/view:
+    get:
+      tags: [File Manager]
+      summary: View a file inline
+      description: Returns the file content for inline viewing in the browser
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file to view
+          schema:
+            type: string
+      responses:
+        '200':
+          description: File content (inline)
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+        '400':
+          description: Path is not a file
+
+  /file-manager/api/delete:
+    delete:
+      tags: [File Manager]
+      summary: Delete a file or directory
+      description: Recursively deletes the specified file or directory
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file or directory to delete
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Successfully deleted
+
+  /file-manager/api/upload:
+    post:
+      tags: [File Manager]
+      summary: Upload files to a directory
+      description: Uploads one or more files to the specified directory
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the target directory
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          multipart/form-data:
+            schema:
+              type: object
+              properties:
+                file:
+                  type: array
+                  items:
+                    type: string
+                    format: binary
+      responses:
+        '200':
+          description: Files uploaded successfully
+
+  /file-manager/api/mode:
+    put:
+      tags: [File Manager]
+      summary: Change file permissions
+      description: "Changes read/write/execute permissions. Mode format: +rwx or -rwx"
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file
+          schema:
+            type: string
+        - name: mode
+          in: query
+          required: true
+          description: "Permission mode (e.g. +rw, -x)"
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Permissions changed
+
+components:
+  schemas:
+    DirectoryInfo:
+      type: object
+      properties:
+        name:
+          type: string
+        path:
+          type: string
+        isWritable:
+          type: boolean
+        parentInfos:
+          type: array
+          items:
+            $ref: '#/components/schemas/ParentInfo'
+        files:
+          type: array
+          items:
+            $ref: '#/components/schemas/FileInfo'
+
+    ParentInfo:
+      type: object
+      properties:
+        path:
+          type: string
+        name:
+          type: string
+
+    FileInfo:
+      type: object
+      properties:
+        parent:
+          type: string
+        name:
+          type: string
+        length:
+          type: integer
+          format: int64
+        isDirectory:
+          type: boolean
+        isReadable:
+          type: boolean
+        isWritable:
+          type: boolean
+        isExecutable:
+          type: boolean
+        hasChildren:
+          type: boolean
+        modified:
+          type: string
+          description: ISO local date-time (no timezone)
+        created:
+          type: string
+          description: ISO local date-time (no timezone)
+

package/dist/static/swagger-ui.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>File Manager API</title>
+</head>
+<body>
+<script
+    id="api-reference"
+    data-url="/file-manager/api-docs/openapi.json"
+    data-configuration='{"darkMode":true,"hideDownloadButton":true,"hiddenClients":["ruby","php","python","csharp","clojure","c","objc","ocaml","r","swift","kotlin","powershell"]}'></script>
+<script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@nicemeta/file-manager",
+  "version": "0.6.4",
+  "description": "File manager web application",
+  "main": "src/app.js",
+  "bin": {
+    "file-manager": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "static/",
+    "dist/"
+  ],
+  "keywords": [
+    "file-manager",
+    "file-browser",
+    "upload",
+    "download",
+    "cli"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "node build.js",
+    "clean": "rm -rf dist",
+    "start": "node bin/cli.js",
+    "start:prod": "node dist/cli.cjs"
+  },
+  "dependencies": {
+    "@nicemeta/file-manager-lib": "^0.6.4",
+    "express": "^5.1.0",
+    "js-yaml": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/app.js

@@ -0,0 +1,84 @@
+'use strict';
+
+const express = require('express');
+const path = require('node:path');
+const fs = require('node:fs');
+const { createRouter } = require('@nicemeta/file-manager-lib');
+
+// ── OpenAPI spec ──
+// In dev: loaded from openapi.yaml via js-yaml (optional dev dependency)
+// In prod bundle: loaded from openapi.json (pre-converted by build.js)
+function loadSpec() {
+    const jsonPath = path.join(__dirname, 'openapi.json');
+    if (fs.existsSync(jsonPath)) {
+        return JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
+    }
+    // Dev fallback: parse YAML
+    const yamlPath = path.join(__dirname, 'openapi.yaml');
+    const yaml = require('js-yaml');
+    return yaml.load(fs.readFileSync(yamlPath, 'utf8'));
+}
+
+/**
+ * Create the full Express application.
+ *
+ * @param {object} [options]
+ * @param {string} [options.root='/'] — root directory for file operations
+ * @returns {import('express').Application}
+ */
+function createApp(options = {}) {
+    const app = express();
+
+    // Determine where static UI assets are:
+    // In dev: lib's own static/file-manager/ (resolved by the lib via __dirname)
+    // In prod bundle: dist/lib-static/file-manager/ (next to the bundle)
+    const libStaticDir = path.join(__dirname, 'lib-static', 'file-manager');
+    const routerOptions = { ...options };
+    if (fs.existsSync(libStaticDir)) {
+        routerOptions.staticDir = libStaticDir;
+    }
+
+    // Mount file-manager library router (API + static UI)
+    app.use(createRouter(routerOptions));
+
+    // Root redirect
+    app.get('/', (_req, res) => {
+        res.redirect('/file-manager/index.html');
+    });
+
+    // ── OpenAPI spec (JSON) ──
+    const specDoc = loadSpec();
+
+    app.get('/file-manager/api-docs/openapi.json', (_req, res) => {
+        res.json(specDoc);
+    });
+
+    // ── Swagger UI (CDN-loaded, dark theme inlined) ──
+    // Try multiple locations: static/ next to __dirname, or ../static/ for dev
+    const candidates = [
+        path.join(__dirname, 'static', 'swagger-ui.html'),
+        path.join(__dirname, '..', 'static', 'swagger-ui.html'),
+    ];
+    const swaggerHtmlPath = candidates.find(p => fs.existsSync(p));
+    const swaggerHtml = swaggerHtmlPath
+        ? fs.readFileSync(swaggerHtmlPath, 'utf8')
+        : null;
+
+    app.get('/file-manager/swagger-ui/index.html', (_req, res) => {
+        if (swaggerHtml) {
+            res.type('html').send(swaggerHtml);
+        } else {
+            res.status(404).send('swagger-ui.html not found');
+        }
+    });
+
+    // Redirect bare /file-manager/swagger-ui to /file-manager/swagger-ui/index.html
+    app.get('/file-manager/swagger-ui', (_req, res) => {
+        res.redirect('/file-manager/swagger-ui/index.html');
+    });
+
+    return app;
+}
+
+module.exports = { createApp };
+

package/src/openapi.yaml

@@ -0,0 +1,219 @@
+openapi: 3.0.3
+info:
+  title: File Manager API
+  description: File system browsing, upload, download, and management
+  version: 0.1.0
+servers:
+  - url: /
+tags:
+  - name: File Manager
+    description: File system browsing, upload, download, and management
+paths:
+  /file-manager/api/list:
+    get:
+      tags: [File Manager]
+      summary: List directory contents
+      description: Returns the contents of the specified directory including file metadata
+      parameters:
+        - name: path
+          in: query
+          description: Absolute path of the directory to list
+          schema:
+            type: string
+            default: /
+      responses:
+        '200':
+          description: Directory listing
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/DirectoryInfo'
+
+  /file-manager/api/download:
+    get:
+      tags: [File Manager]
+      summary: Download a file
+      description: Downloads the specified file as an attachment
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file to download
+          schema:
+            type: string
+      responses:
+        '200':
+          description: File content
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+        '400':
+          description: Path is not a file
+
+  /file-manager/api/zip:
+    get:
+      tags: [File Manager]
+      summary: Download as ZIP
+      description: Downloads the specified file or directory as a ZIP archive
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file or directory to zip
+          schema:
+            type: string
+      responses:
+        '200':
+          description: ZIP archive
+          content:
+            application/zip:
+              schema:
+                type: string
+                format: binary
+
+  /file-manager/api/view:
+    get:
+      tags: [File Manager]
+      summary: View a file inline
+      description: Returns the file content for inline viewing in the browser
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file to view
+          schema:
+            type: string
+      responses:
+        '200':
+          description: File content (inline)
+          content:
+            application/octet-stream:
+              schema:
+                type: string
+                format: binary
+        '400':
+          description: Path is not a file
+
+  /file-manager/api/delete:
+    delete:
+      tags: [File Manager]
+      summary: Delete a file or directory
+      description: Recursively deletes the specified file or directory
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file or directory to delete
+          schema:
+            type: string
+      responses:
+        '204':
+          description: Successfully deleted
+
+  /file-manager/api/upload:
+    post:
+      tags: [File Manager]
+      summary: Upload files to a directory
+      description: Uploads one or more files to the specified directory
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the target directory
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          multipart/form-data:
+            schema:
+              type: object
+              properties:
+                file:
+                  type: array
+                  items:
+                    type: string
+                    format: binary
+      responses:
+        '200':
+          description: Files uploaded successfully
+
+  /file-manager/api/mode:
+    put:
+      tags: [File Manager]
+      summary: Change file permissions
+      description: "Changes read/write/execute permissions. Mode format: +rwx or -rwx"
+      parameters:
+        - name: path
+          in: query
+          required: true
+          description: Absolute path of the file
+          schema:
+            type: string
+        - name: mode
+          in: query
+          required: true
+          description: "Permission mode (e.g. +rw, -x)"
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Permissions changed
+
+components:
+  schemas:
+    DirectoryInfo:
+      type: object
+      properties:
+        name:
+          type: string
+        path:
+          type: string
+        isWritable:
+          type: boolean
+        parentInfos:
+          type: array
+          items:
+            $ref: '#/components/schemas/ParentInfo'
+        files:
+          type: array
+          items:
+            $ref: '#/components/schemas/FileInfo'
+
+    ParentInfo:
+      type: object
+      properties:
+        path:
+          type: string
+        name:
+          type: string
+
+    FileInfo:
+      type: object
+      properties:
+        parent:
+          type: string
+        name:
+          type: string
+        length:
+          type: integer
+          format: int64
+        isDirectory:
+          type: boolean
+        isReadable:
+          type: boolean
+        isWritable:
+          type: boolean
+        isExecutable:
+          type: boolean
+        hasChildren:
+          type: boolean
+        modified:
+          type: string
+          description: ISO local date-time (no timezone)
+        created:
+          type: string
+          description: ISO local date-time (no timezone)
+