lib0 0.2.66 → 0.2.68

package/bin/0serve.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=0serve.d.ts.map

package/bin/0serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"0serve.d.ts","sourceRoot":"","sources":["0serve.js"],"names":[],"mappings":""}

package/bin/0serve.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import http from 'http'
+import path from 'path'
+import fs from 'fs'
+import * as env from '../environment.js'
+import * as number from '../number.js'
+import * as logging from '../logging.js'
+
+const host = env.getParam('--host', 'localhost')
+const port = number.parseInt(env.getParam('--port', '8000'))
+const paramOpenFile = env.getParam('-o', '')
+
+/**
+ * @type {Object<string,string>}
+ */
+const types = {
+  html: 'text/html',
+  css: 'text/css',
+  js: 'application/javascript',
+  mjs: 'application/javascript',
+  png: 'image/png',
+  jpg: 'image/jpeg',
+  jpeg: 'image/jpeg',
+  gif: 'image/gif',
+  json: 'application/json',
+  xml: 'application/xml'
+}
+
+const root = path.normalize(path.resolve('./'))
+
+const server = http.createServer((req, res) => {
+  const url = req.url || '/index.html'
+  logging.print(logging.ORANGE, logging.BOLD, req.method || '', ' ', logging.GREY, logging.UNBOLD, url)
+  const extension = path.extname(url).slice(1)
+  /**
+   * @type {string}
+   */
+  const type = (extension && types[extension]) || types.html
+  const supportedExtension = Boolean(type)
+  if (!supportedExtension) {
+    res.writeHead(404, { 'Content-Type': 'text/html' })
+    res.end('404: File not found')
+    return
+  }
+  let fileName = url
+  if (url === '/') fileName = 'index.html'
+  else if (!extension) {
+    try {
+      fs.accessSync(path.join(root, url + '.html'), fs.constants.F_OK)
+      fileName = url + '.html'
+    } catch (e) {
+      fileName = path.join(url, 'index.html')
+    }
+  }
+
+  const filePath = path.join(root, fileName)
+  const isPathUnderRoot = path
+    .normalize(path.resolve(filePath))
+    .startsWith(root)
+
+  if (!isPathUnderRoot) {
+    res.writeHead(404, { 'Content-Type': 'text/html' })
+    res.end('404: File not found')
+    logging.print(logging.RED, logging.BOLD, 'Not Found: ', logging.GREY, logging.UNBOLD, url)
+    return
+  }
+
+  fs.readFile(filePath, (err, data) => {
+    if (err) {
+      logging.print(logging.RED, logging.BOLD, 'Cannot read file: ', logging.GREY, logging.UNBOLD, url)
+      res.writeHead(404, { 'Content-Type': 'text/html' })
+      res.end('404: File not found')
+    } else {
+      res.writeHead(200, { 'Content-Type': type })
+      res.end(data)
+    }
+  })
+})
+
+server.listen(port, host, () => {
+  logging.print(logging.BOLD, logging.ORANGE, `Server is running on http://${host}:${port}`)
+  if (paramOpenFile) {
+    const start = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open'
+    import('child_process').then(cp => {
+      cp.exec(`${start} http://${host}:${port}/${paramOpenFile}`)
+    })
+  }
+})

package/bin/gendocs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gendocs.d.ts.map

package/bin/gendocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gendocs.d.ts","sourceRoot":"","sources":["gendocs.js"],"names":[],"mappings":""}

package/bin/gendocs.js

@@ -1,3 +1,4 @@
+// @ts-ignore
 import jsdoc from 'jsdoc-api'
 import fs from 'fs'
 
@@ -9,6 +10,9 @@ const files = fs.readdirSync('./').filter(file => /(?<!(test|config))\.js$/.test
 
 const _ltregex = /</g
 const _rtregex = />/g
+/**
+ * @param {string} s
+ */
 const toSafeHtml = s => s.replace(_ltregex, '&lt;').replace(_rtregex, '&gt;')
 
 const READMEcontent = fs.readFileSync('./README.md', 'utf8')
@@ -16,8 +20,11 @@ const READMEcontent = fs.readFileSync('./README.md', 'utf8')
 jsdoc.explain({
   files,
   configure: '.jsdoc.json'
-}).then(json => {
+}).then(/** @param {Array<any>} json */ json => {
   const strBuilder = []
+  /**
+   * @type {Object<string, { items: Array<any>, name: string, description: string }>}
+   */
   const modules = {}
   json.forEach(item => {
     if (item.meta && item.meta.filename) {
@@ -30,6 +37,9 @@ jsdoc.explain({
       }
     }
   })
+  /**
+   * @type {Object<string,string>}
+   */
   const classDescriptions = {}
   for (const fileName in modules) {
     const mod = modules[fileName]
@@ -67,6 +77,9 @@ jsdoc.explain({
           }
           // eslint-disable-next-line
           case 'function': {
+            /**
+             * @param {string} name
+             */
             const getOriginalParamTypeDecl = name => {
               const regval = new RegExp('@param {(.*)} \\[?' + name + '\\]?[^\\w]*').exec(item.comment)
               return regval ? regval[1] : null
@@ -74,9 +87,9 @@ jsdoc.explain({
             if (item.params == null && item.returns == null) {
               break
             }
-            const paramVal = (item.params || []).map(ret => `${ret.name}: ${getOriginalParamTypeDecl(ret.name) || ret.type.names.join('|')}`).join(', ')
+            const paramVal = (item.params || []).map(/** @param {any} ret */ ret => `${ret.name}: ${getOriginalParamTypeDecl(ret.name) || ret.type.names.join('|')}`).join(', ')
             const evalReturnRegex = jsdocReturnRegex.exec(item.comment)
-            const returnVal = evalReturnRegex ? `: ${evalReturnRegex[1]}` : (item.returns ? item.returns.map(r => r.type.names.join('|')).join('|') : '')
+            const returnVal = evalReturnRegex ? `: ${evalReturnRegex[1]}` : (item.returns ? item.returns.map(/** @param {any} r */ r => r.type.names.join('|')).join('|') : '')
             strBuilder.push(`<b><code>${item.kind === 'class' ? 'new ' : ''}${item.longname.slice(7)}(${toSafeHtml(paramVal)})${toSafeHtml(returnVal)}</code></b><br>`)
             const desc = item.description || item.classdesc || classDescriptions[item.longname] || null
             if (desc) {
@@ -86,7 +99,7 @@ jsdoc.explain({
           }
           case 'member': {
             if (item.type) {
-              strBuilder.push(`<b><code>${item.longname.slice(7)}: ${toSafeHtml(jsdocTypeRegex.exec(item.comment)[1])}</code></b><br>`)
+              strBuilder.push(`<b><code>${item.longname.slice(7)}: ${toSafeHtml(/** @type {RegExpExecArray} */ (jsdocTypeRegex.exec(item.comment))[1])}</code></b><br>`)
               if (item.description) {
                 strBuilder.push(`<dd>${item.description}</dd>`)
               }

package/bin/gentesthtml.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=gentesthtml.d.ts.map

package/bin/gentesthtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gentesthtml.d.ts","sourceRoot":"","sources":["gentesthtml.js"],"names":[],"mappings":""}

package/bin/gentesthtml.js

@@ -1,38 +1,51 @@
-
+#!/usr/bin/env node
 import fs from 'fs'
 import * as object from '../object.js'
+import * as env from '../environment.js'
+
+const script = env.getParam('--script', './test.js')
 
 /**
  * @type {Object<string,string>}
  */
 const exports = {}
+/**
+ * @type {Object<string,Object<string,string>>}
+ */
+const scopes = {}
 
 /**
  * @param {any} v
  * @param {string} k
  * @param {string} pkgName
  * @param {string} pathPrefix
+ * @param {Object<string,string>} importMap
  */
-const extractModMap = (v, k, pkgName, pathPrefix) => {
+const extractModMap = (v, k, pkgName, pathPrefix, importMap) => {
   if (k[0] !== '.') return
   if (typeof v === 'object') {
-    extractModMap(v.browser || v.module || v.import, k, pkgName, pathPrefix)
+    extractModMap(v.browser || v.module || v.import, k, pkgName, pathPrefix, importMap)
   } else if (v && v[0] === '.') {
-    exports[pkgName + k.slice(1)] = pathPrefix + v.slice(1)
+    importMap[pkgName + k.slice(1)] = pathPrefix + v.slice(1)
   }
 }
-const rootPkgJson = JSON.parse(fs.readFileSync('./package.json'))
+
 /**
- * @param {object} pkgJson
+ * @param {any} pkgJson
  * @param {string} pathPrefix
+ * @param {Object<string,string>} importMap
  */
-const extractPkgJsonInfo = (pkgJson, pathPrefix) => object.forEach(pkgJson.exports, (v, k) => extractModMap(v, k, pkgJson.name, pathPrefix))
-extractPkgJsonInfo(rootPkgJson, '.')
-object.forEach(rootPkgJson.dependencies, (_v, depName) => {
-  const prefix = `./node_modules/${depName}`
-  const depPkgJson = JSON.parse(fs.readFileSync(prefix + '/package.json'))
-  extractPkgJsonInfo(depPkgJson, prefix)
-})
+const readPkg = (pkgJson, pathPrefix, importMap) => {
+  object.forEach(pkgJson.exports, (v, k) => extractModMap(v, k, pkgJson.name, pathPrefix, importMap))
+  object.forEach(pkgJson.dependencies, (_v, depName) => {
+    const nextImportMap = pathPrefix === '.' ? exports : (scopes[pathPrefix + '/'] = {})
+    const prefix = `./node_modules/${depName}`
+    const depPkgJson = JSON.parse(fs.readFileSync(prefix + '/package.json', { encoding: 'utf8' }))
+    readPkg(depPkgJson, prefix, nextImportMap)
+  })
+}
+
+readPkg(JSON.parse(fs.readFileSync('./package.json', { encoding: 'utf8' })), '.', exports)
 
 const testHtml = `
 <!DOCTYPE html>
@@ -41,12 +54,13 @@ const testHtml = `
   <title>Testing lib0</title>
   <script type="importmap">
     {
-      "imports": ${JSON.stringify(exports, null, 2)}
+      "imports": ${JSON.stringify(exports, null, 2)},
+      "scopes": ${JSON.stringify(scopes, null, 2)}
     }
   </script>
 </head>
 <body>
-  <script type="module" src="./test.js"></script>
+  <script type="module" src="${script}"></script>
 </body>
 </html>
 `

package/cache.d.ts

@@ -21,7 +21,7 @@ export function set<K, V>(cache: Cache<K, V>, key: K, value: V): void;
 export function get<K, V>(cache: Cache<K, V>, key: K): V | undefined;
 export function refreshTimeout<K, V>(cache: Cache<K, V>, key: K): void;
 export function getAsync<K, V>(cache: Cache<K, V>, key: K): V | Promise<V> | undefined;
-export function remove<K, V>(cache: Cache<K, V>, key: K): V | undefined;
+export function remove<K, V>(cache: Cache<K, V>, key: K): NonNullable<V> | undefined;
 export function setIfUndefined<K, V>(cache: Cache<K, V>, key: K, init: () => Promise<V>, removeNull?: boolean): V | Promise<V>;
 export function create(timeout: number): Cache<any, any>;
 import * as list from "./list.js";

package/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["cache.js"],"names":[],"mappings":"AAsCA;;GAEG;AACH;IACE;;OAEG;IACH,qBAFW,MAAM,EAYhB;IATC,gBAAsB;IACtB;;OAEG;IACH,IAFS,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAER;IACvB;;OAEG;IACH,MAFU,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAEL;CAE3B;AAQM,uDAFK,MAAM,CAUjB;AASM,sEAcN;AAwBM,qEAGN;AAQM,uEASN;AAYM,uFAGN;AAQM,wEAON;AAWM,sGAHI,OAAO,kBAwBjB;AAKM,gCAFI,MAAM,mBAEkC;;AAjMnD;;;;GAIG;AACH,qCAFgB,IAAI,CAAC,QAAQ;IAG3B;;;OAGG;IACH,iBAHW,CAAC,OACD,CAAC,GAAG,QAAQ,CAAC,CAAC,EAcxB;IAXC;;OAEG;IACH,yBAAgB;IAChB;;OAEG;IACH,yBAAgB;IAChB,gBAAiC;IACjC,oBAAc;IACd,OAAc;CAEjB"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["cache.js"],"names":[],"mappings":"AAsCA;;GAEG;AACH;IACE;;OAEG;IACH,qBAFW,MAAM,EAYhB;IATC,gBAAsB;IACtB;;OAEG;IACH,IAFS,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAER;IACvB;;OAEG;IACH,MAFU,IAAI,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAEL;CAE3B;AAQM,uDAFK,MAAM,CAUjB;AASM,sEAcN;AAwBM,qEAGN;AAQM,uEASN;AAYM,uFAGN;AAQM,qFAON;AAWM,sGAHI,OAAO,kBAwBjB;AAKM,gCAFI,MAAM,mBAEkC;;AAjMnD;;;;GAIG;AACH,qCAFgB,IAAI,CAAC,QAAQ;IAG3B;;;OAGG;IACH,iBAHW,CAAC,OACD,CAAC,GAAG,QAAQ,CAAC,CAAC,EAcxB;IAXC;;OAEG;IACH,yBAAgB;IAChB;;OAEG;IACH,yBAAgB;IAChB,gBAAiC;IACjC,oBAAc;IACd,OAAc;CAEjB"}