add meta file for bee.filesystem

Author: sumneko

.luarc.json

@@ -24,7 +24,8 @@
             "script/?.lua",
             "script/?/init.lua",
             "test/?.lua",
-            "test/?/init.lua"
+            "test/?/init.lua",
+            "script/meta/?.lua"
         ],
         "pathStrict": true
     },

debugger.lua

@@ -5,8 +5,13 @@ end
 local fs = require 'bee.filesystem'
 local luaDebugs = {}
 
+local home = os.getenv 'USERPROFILE' or os.getenv 'HOME'
+if not home then
+    log.error('Cannot find home directory')
+    return
+end
 for _, vscodePath in ipairs { '.vscode', '.vscode-insiders', '.vscode-server-insiders' } do
-    local extensionPath = fs.path(os.getenv 'USERPROFILE' or os.getenv 'HOME') / vscodePath / 'extensions'
+    local extensionPath =  fs.path(home) / vscodePath / 'extensions'
     log.debug('Search extensions at:', extensionPath:string())
 
     if fs.exists(extensionPath) then

script/fs-utility.lua

@@ -13,9 +13,6 @@ local tableSort    = table.sort
 
 _ENV = nil
 
----@class fspath
----@field string fun(self):string
-
 ---@class fs-utility
 local m = {}
 --- 读取文件
@@ -465,7 +462,7 @@ local function fileCopy(source, target, option)
         if isDir2 or fsCreateDirectories(target, option) then
             for filePath in fsPairs(source) do
                 local name = filePath:filename():string()
-                fileCopy(filePath, target / name--[[@as fspath]], option)
+                fileCopy(filePath, target / name, option)
             end
         end
     else
@@ -487,6 +484,9 @@ local function fileCopy(source, target, option)
     end
 end
 
+---@param source fspath?
+---@param target fspath?
+---@param option table
 local function fileSync(source, target, option)
     if not source or not target then
         return
@@ -516,7 +516,7 @@ local function fileSync(source, target, option)
             if fsCreateDirectories(target) then
                 for filePath in fsPairs(source) do
                     local name = filePath:filename():string()
-                    fileCopy(filePath, target / name--[[@as fspath]], option)
+                    fileCopy(filePath, target / name, option)
                 end
             end
         end

script/library.lua

@@ -214,7 +214,7 @@ local function initBuiltIn(uri)
         version  = version,
         language = langID,
         encoding = encoding,
-    })--[[@as fspath]]
+    })
 
     local metaLang = loadMetaLocale('en-US')
     if langID ~= 'en-US' then
@@ -245,7 +245,7 @@ local function initBuiltIn(uri)
         end
         libName = libName .. '.lua'
         ---@type fspath
-        local libPath = templateDir / libName--[[@as fspath]]
+        local libPath = templateDir / libName
         local metaDoc = compileSingleMetaDoc(uri, fsu.loadFile(libPath), metaLang, status)
         if metaDoc then
             metaDoc = encoder.encode(encoding, metaDoc, 'auto')
@@ -262,8 +262,9 @@ local function initBuiltIn(uri)
     end
 end
 
+---@param libraryDir fspath
 local function loadSingle3rdConfig(libraryDir)
-    local configText = fsu.loadFile(libraryDir / 'config.lua'--[[@as fspath]])
+    local configText = fsu.loadFile(libraryDir / 'config.lua')
     if not configText then
         return nil
     end

script/meta/bee/filesystem.lua

@@ -0,0 +1,28 @@
+---@class fspath
+---@operator div: fspath
+local fsPath = {}
+
+---@return string
+function fsPath:string()
+end
+
+---@return fspath
+function fsPath:parent_path()
+end
+
+---@return boolean
+function fsPath:is_relative()
+end
+
+---@return fspath
+function fsPath:filename()
+end
+
+local fs = {}
+
+---@param path string
+---@return fspath
+function fs.path(path)
+end
+
+return fs

script/version.lua

@@ -1,7 +1,7 @@
 local fsu = require 'fs-utility'
 
 local function loadVersion()
-    local changelog = fsu.loadFile(ROOT / 'changelog.md'--[[@as fspath]])
+    local changelog = fsu.loadFile(ROOT / 'changelog.md')
     if not changelog then
         return
     end