@ecmaos/coreutils 0.4.2 → 0.5.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
 
-> @ecmaos/coreutils@0.4.2 build /home/archmag0s/code/ecmaos/core/utils
+> @ecmaos/coreutils@0.5.0 build /home/archmag0s/code/ecmaos/core/utils
 > tsc
 

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ecmaos/coreutils
 
+## 0.5.0
+
+### Minor Changes
+
+- ad7dc2e: add initfs.demo; fix bell flash; rename hex to xxd
+
+### Patch Changes
+
+- Updated dependencies [ad7dc2e]
+  - @ecmaos/types@0.7.2
+
+## 0.4.3
+
+### Patch Changes
+
+- Updated dependencies [f332a2f]
+  - @ecmaos/types@0.7.1
+
 ## 0.4.2
 
 ### Patch Changes

package/dist/commands/mount.js

@@ -66,31 +66,31 @@ function printUsage(process, terminal) {
 Mount a filesystem.
 
 Options:
-  -t, --type TYPE     filesystem type (fetch, indexeddb, webstorage, webaccess, memory, singlebuffer, zip, iso, googledrive)
-  -o, --options OPTS   mount options (comma-separated key=value pairs)
+  -t, --type TYPE     filesystem type
+  -o, --options OPTS  mount options (comma-separated key=value pairs)
   -a, --all           mount all filesystems listed in /etc/fstab
   -l, --list          list all mounted filesystems
   --help              display this help and exit
 
 Filesystem types:
-  fetch         mount a remote filesystem via HTTP fetch
-  indexeddb     mount an IndexedDB-backed filesystem
-  webstorage    mount a WebStorage-backed filesystem (localStorage or sessionStorage)
-  webaccess     mount a filesystem using the File System Access API
-  memory        mount an in-memory filesystem
-  singlebuffer  mount a filesystem backed by a single buffer
-  zip           mount a readonly filesystem from a zip archive (requires SOURCE file or URL)
-  iso           mount a readonly filesystem from an ISO image (requires SOURCE file or URL)
-  googledrive   mount a Google Drive filesystem (requires apiKey via -o apiKey, optionally clientId for OAuth)
+  fetch               mount a remote filesystem via HTTP fetch
+  indexeddb           mount an IndexedDB-backed filesystem
+  webstorage          mount a WebStorage-backed filesystem (localStorage or sessionStorage)
+  webaccess           mount a filesystem using the File System Access API
+  memory              mount an in-memory filesystem
+  singlebuffer        mount a filesystem backed by a single buffer
+  zip                 mount a readonly filesystem from a zip archive (requires SOURCE file or URL)
+  iso                 mount a readonly filesystem from an ISO image (requires SOURCE file or URL)
+  googledrive         mount a Google Drive filesystem (requires apiKey via -o apiKey, optionally clientId for OAuth)
 
 Mount options:
-  baseUrl=URL        base URL for fetch operations (fetch type)
-  size=BYTES         buffer size in bytes for singlebuffer type (default: 1048576)
-  storage=TYPE       storage type for webstorage (localStorage or sessionStorage, default: localStorage)
-  apiKey=KEY         Google API key (googledrive type, required)
-  clientId=ID        Google OAuth client ID (googledrive type, optional)
-  scope=SCOPE        OAuth scope (googledrive type, default: https://www.googleapis.com/auth/drive)
-  cacheTTL=SECONDS   cache TTL in seconds for cloud backends (optional)
+  baseUrl=URL         base URL for fetch operations (fetch type)
+  size=BYTES          buffer size in bytes for singlebuffer type (default: 1048576)
+  storage=TYPE        storage type for webstorage (localStorage or sessionStorage, default: localStorage)
+  apiKey=KEY          Google API key (googledrive type, required)
+  clientId=ID         Google OAuth client ID (googledrive type, optional)
+  scope=SCOPE         OAuth scope (googledrive type, default: https://www.googleapis.com/auth/drive)
+  cacheTTL=SECONDS    cache TTL in seconds for cloud backends (optional)
 
 Examples:
   mount -l                                    list all mounted filesystems

package/dist/commands/xxd.d.ts

@@ -0,0 +1,4 @@
+import type { Kernel, Shell, Terminal } from '@ecmaos/types';
+import { TerminalCommand } from '../shared/terminal-command.js';
+export declare function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand;
+//# sourceMappingURL=xxd.d.ts.map

package/dist/commands/xxd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xxd.d.ts","sourceRoot":"","sources":["../../src/commands/xxd.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAY/D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAG,eAAe,CAiJ/F"}

package/dist/commands/xxd.js

@@ -0,0 +1,144 @@
+import path from 'path';
+import { TerminalCommand } from '../shared/terminal-command.js';
+import { writelnStdout, writelnStderr } from '../shared/helpers.js';
+function printUsage(process, terminal) {
+    const usage = `Usage: xxd [FILE]
+Display file contents or stdin in hexadecimal format.
+
+  FILE    the file to display (if omitted, reads from stdin)
+  --help  display this help and exit`;
+    writelnStderr(process, terminal, usage);
+}
+export function createCommand(kernel, shell, terminal) {
+    return new TerminalCommand({
+        command: 'xxd',
+        description: 'Display file contents or stdin in hexadecimal format',
+        kernel,
+        shell,
+        terminal,
+        run: async (pid, argv) => {
+            const process = kernel.processes.get(pid);
+            if (!process)
+                return 1;
+            if (argv.length > 0 && (argv[0] === '--help' || argv[0] === '-h')) {
+                printUsage(process, terminal);
+                return 0;
+            }
+            const firstArg = argv.length > 0 ? argv[0] : undefined;
+            const filePath = firstArg !== undefined && !firstArg.startsWith('-') ? firstArg : undefined;
+            let data;
+            try {
+                if (!filePath) {
+                    if (!process.stdin) {
+                        await writelnStderr(process, terminal, 'Usage: xxd <file>');
+                        await writelnStderr(process, terminal, '   or: <command> | xxd');
+                        return 1;
+                    }
+                    if (process.stdinIsTTY) {
+                        await writelnStderr(process, terminal, 'Usage: xxd <file>');
+                        await writelnStderr(process, terminal, '   or: <command> | xxd');
+                        return 1;
+                    }
+                    const reader = process.stdin.getReader();
+                    const chunks = [];
+                    try {
+                        const first = await reader.read();
+                        if (first.done && !first.value) {
+                            await writelnStderr(process, terminal, 'Usage: xxd <file>');
+                            await writelnStderr(process, terminal, '   or: <command> | xxd');
+                            return 1;
+                        }
+                        if (first.value) {
+                            chunks.push(first.value);
+                        }
+                        if (!first.done) {
+                            while (true) {
+                                const { done, value } = await reader.read();
+                                if (done)
+                                    break;
+                                if (value) {
+                                    chunks.push(value);
+                                }
+                            }
+                        }
+                    }
+                    finally {
+                        reader.releaseLock();
+                    }
+                    const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0);
+                    if (totalLength === 0) {
+                        await writelnStderr(process, terminal, 'Usage: xxd <file>');
+                        await writelnStderr(process, terminal, '   or: <command> | xxd');
+                        return 1;
+                    }
+                    data = new Uint8Array(totalLength);
+                    let offset = 0;
+                    for (const chunk of chunks) {
+                        data.set(chunk, offset);
+                        offset += chunk.length;
+                    }
+                }
+                else {
+                    const fullPath = path.resolve(shell.cwd, filePath);
+                    const exists = await shell.context.fs.promises.exists(fullPath);
+                    if (!exists) {
+                        await writelnStderr(process, terminal, `xxd: ${filePath}: No such file or directory`);
+                        return 1;
+                    }
+                    const stats = await shell.context.fs.promises.stat(fullPath);
+                    if (stats.isDirectory()) {
+                        await writelnStderr(process, terminal, `xxd: ${filePath}: Is a directory`);
+                        return 1;
+                    }
+                    data = await shell.context.fs.promises.readFile(fullPath);
+                }
+                const bytesPerLine = 16;
+                for (let offset = 0; offset < data.length; offset += bytesPerLine) {
+                    const lineBytes = data.slice(offset, offset + bytesPerLine);
+                    const offsetHex = offset.toString(16).padStart(8, '0');
+                    const hexGroups = [];
+                    const asciiChars = [];
+                    for (let i = 0; i < bytesPerLine; i++) {
+                        if (i < lineBytes.length) {
+                            const byte = lineBytes[i];
+                            if (byte === undefined)
+                                continue;
+                            const hex = byte.toString(16).padStart(2, '0');
+                            if (i % 2 === 0) {
+                                hexGroups.push(hex);
+                            }
+                            else {
+                                hexGroups[hexGroups.length - 1] += hex;
+                            }
+                            if (byte >= 32 && byte <= 126) {
+                                asciiChars.push(String.fromCharCode(byte));
+                            }
+                            else {
+                                asciiChars.push('.');
+                            }
+                        }
+                        else {
+                            if (i % 2 === 0) {
+                                hexGroups.push('  ');
+                            }
+                            else {
+                                hexGroups[hexGroups.length - 1] += '  ';
+                            }
+                            asciiChars.push(' ');
+                        }
+                    }
+                    const hexString = hexGroups.join(' ').padEnd(47, ' ');
+                    const asciiString = asciiChars.join('');
+                    await writelnStdout(process, terminal, `${offsetHex}: ${hexString}  ${asciiString}`);
+                }
+                return 0;
+            }
+            catch (error) {
+                const errorPath = filePath || 'stdin';
+                await writelnStderr(process, terminal, `xxd: ${errorPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                return 1;
+            }
+        }
+    });
+}
+//# sourceMappingURL=xxd.js.map

package/dist/commands/xxd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xxd.js","sourceRoot":"","sources":["../../src/commands/xxd.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -34,7 +34,7 @@ export { createCommand as createRmdir } from './commands/rmdir.js';
 export { createCommand as createStat } from './commands/stat.js';
 export { createCommand as createStrings } from './commands/strings.js';
 export { createCommand as createTouch } from './commands/touch.js';
-export { createCommand as createHex } from './commands/hex.js';
+export { createCommand as createXxd } from './commands/xxd.js';
 export { createCommand as createLess } from './commands/less.js';
 export { createCommand as createMan } from './commands/man.js';
 export { createCommand as createSed } from './commands/sed.js';

package/dist/index.js

@@ -37,7 +37,7 @@ import { createCommand as createRm } from './commands/rm.js';
 import { createCommand as createRmdir } from './commands/rmdir.js';
 import { createCommand as createStat } from './commands/stat.js';
 import { createCommand as createTouch } from './commands/touch.js';
-import { createCommand as createHex } from './commands/hex.js';
+import { createCommand as createXxd } from './commands/xxd.js';
 import { createCommand as createLess } from './commands/less.js';
 import { createCommand as createMan } from './commands/man.js';
 import { createCommand as createPasskey } from './commands/passkey.js';
@@ -125,7 +125,7 @@ export { createCommand as createRmdir } from './commands/rmdir.js';
 export { createCommand as createStat } from './commands/stat.js';
 export { createCommand as createStrings } from './commands/strings.js';
 export { createCommand as createTouch } from './commands/touch.js';
-export { createCommand as createHex } from './commands/hex.js';
+export { createCommand as createXxd } from './commands/xxd.js';
 export { createCommand as createLess } from './commands/less.js';
 export { createCommand as createMan } from './commands/man.js';
 export { createCommand as createSed } from './commands/sed.js';
@@ -208,7 +208,7 @@ export function createAllCommands(kernel, shell, terminal) {
         stat: createStat(kernel, shell, terminal),
         strings: createStrings(kernel, shell, terminal),
         touch: createTouch(kernel, shell, terminal),
-        hex: createHex(kernel, shell, terminal),
+        xxd: createXxd(kernel, shell, terminal),
         less: createLess(kernel, shell, terminal),
         man: createMan(kernel, shell, terminal),
         passkey: createPasskey(kernel, shell, terminal),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ecmaos/coreutils",
   "description": "ecmaOS: Core utilities for the ecmaOS framework",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "license": "MIT+Apache-2.0",
   "homepage": "https://ecmaos.sh",
   "repository": "https://github.com/ecmaos/ecmaos",
@@ -40,7 +40,7 @@
     "human-format": "^1.2.1",
     "marked": "^17.0.1",
     "modern-tar": "^0.7.3",
-    "@ecmaos/types": "^0.7.0"
+    "@ecmaos/types": "^0.7.2"
   },
   "devDependencies": {
     "@types/ansi-escape-sequences": "^4.0.4",

package/src/commands/mount.ts

@@ -79,31 +79,31 @@ function printUsage(process: Process | undefined, terminal: Terminal): void {
 Mount a filesystem.
 
 Options:
-  -t, --type TYPE     filesystem type (fetch, indexeddb, webstorage, webaccess, memory, singlebuffer, zip, iso, googledrive)
-  -o, --options OPTS   mount options (comma-separated key=value pairs)
+  -t, --type TYPE     filesystem type
+  -o, --options OPTS  mount options (comma-separated key=value pairs)
   -a, --all           mount all filesystems listed in /etc/fstab
   -l, --list          list all mounted filesystems
   --help              display this help and exit
 
 Filesystem types:
-  fetch         mount a remote filesystem via HTTP fetch
-  indexeddb     mount an IndexedDB-backed filesystem
-  webstorage    mount a WebStorage-backed filesystem (localStorage or sessionStorage)
-  webaccess     mount a filesystem using the File System Access API
-  memory        mount an in-memory filesystem
-  singlebuffer  mount a filesystem backed by a single buffer
-  zip           mount a readonly filesystem from a zip archive (requires SOURCE file or URL)
-  iso           mount a readonly filesystem from an ISO image (requires SOURCE file or URL)
-  googledrive   mount a Google Drive filesystem (requires apiKey via -o apiKey, optionally clientId for OAuth)
+  fetch               mount a remote filesystem via HTTP fetch
+  indexeddb           mount an IndexedDB-backed filesystem
+  webstorage          mount a WebStorage-backed filesystem (localStorage or sessionStorage)
+  webaccess           mount a filesystem using the File System Access API
+  memory              mount an in-memory filesystem
+  singlebuffer        mount a filesystem backed by a single buffer
+  zip                 mount a readonly filesystem from a zip archive (requires SOURCE file or URL)
+  iso                 mount a readonly filesystem from an ISO image (requires SOURCE file or URL)
+  googledrive         mount a Google Drive filesystem (requires apiKey via -o apiKey, optionally clientId for OAuth)
 
 Mount options:
-  baseUrl=URL        base URL for fetch operations (fetch type)
-  size=BYTES         buffer size in bytes for singlebuffer type (default: 1048576)
-  storage=TYPE       storage type for webstorage (localStorage or sessionStorage, default: localStorage)
-  apiKey=KEY         Google API key (googledrive type, required)
-  clientId=ID        Google OAuth client ID (googledrive type, optional)
-  scope=SCOPE        OAuth scope (googledrive type, default: https://www.googleapis.com/auth/drive)
-  cacheTTL=SECONDS   cache TTL in seconds for cloud backends (optional)
+  baseUrl=URL         base URL for fetch operations (fetch type)
+  size=BYTES          buffer size in bytes for singlebuffer type (default: 1048576)
+  storage=TYPE        storage type for webstorage (localStorage or sessionStorage, default: localStorage)
+  apiKey=KEY          Google API key (googledrive type, required)
+  clientId=ID         Google OAuth client ID (googledrive type, optional)
+  scope=SCOPE         OAuth scope (googledrive type, default: https://www.googleapis.com/auth/drive)
+  cacheTTL=SECONDS    cache TTL in seconds for cloud backends (optional)
 
 Examples:
   mount -l                                    list all mounted filesystems

package/src/commands/{hex.ts → xxd.ts}

@@ -4,7 +4,7 @@ import { TerminalCommand } from '../shared/terminal-command.js'
 import { writelnStdout, writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
-  const usage = `Usage: hex [FILE]
+  const usage = `Usage: xxd [FILE]
 Display file contents or stdin in hexadecimal format.
 
   FILE    the file to display (if omitted, reads from stdin)
@@ -14,7 +14,7 @@ Display file contents or stdin in hexadecimal format.
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {
   return new TerminalCommand({
-    command: 'hex',
+    command: 'xxd',
     description: 'Display file contents or stdin in hexadecimal format',
     kernel,
     shell,
@@ -36,14 +36,14 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
       try {
         if (!filePath) {
           if (!process.stdin) {
-            await writelnStderr(process, terminal, 'Usage: hex <file>')
-            await writelnStderr(process, terminal, '   or: <command> | hex')
+            await writelnStderr(process, terminal, 'Usage: xxd <file>')
+            await writelnStderr(process, terminal, '   or: <command> | xxd')
             return 1
           }
 
           if (process.stdinIsTTY) {
-            await writelnStderr(process, terminal, 'Usage: hex <file>')
-            await writelnStderr(process, terminal, '   or: <command> | hex')
+            await writelnStderr(process, terminal, 'Usage: xxd <file>')
+            await writelnStderr(process, terminal, '   or: <command> | xxd')
             return 1
           }
 
@@ -54,8 +54,8 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
             const first = await reader.read()
             
             if (first.done && !first.value) {
-              await writelnStderr(process, terminal, 'Usage: hex <file>')
-              await writelnStderr(process, terminal, '   or: <command> | hex')
+              await writelnStderr(process, terminal, 'Usage: xxd <file>')
+              await writelnStderr(process, terminal, '   or: <command> | xxd')
               return 1
             }
             
@@ -78,8 +78,8 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
 
           const totalLength = chunks.reduce((sum, chunk) => sum + chunk.length, 0)
           if (totalLength === 0) {
-            await writelnStderr(process, terminal, 'Usage: hex <file>')
-            await writelnStderr(process, terminal, '   or: <command> | hex')
+            await writelnStderr(process, terminal, 'Usage: xxd <file>')
+            await writelnStderr(process, terminal, '   or: <command> | xxd')
             return 1
           }
 
@@ -94,13 +94,13 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
 
           const exists = await shell.context.fs.promises.exists(fullPath)
           if (!exists) {
-            await writelnStderr(process, terminal, `hex: ${filePath}: No such file or directory`)
+            await writelnStderr(process, terminal, `xxd: ${filePath}: No such file or directory`)
             return 1
           }
 
           const stats = await shell.context.fs.promises.stat(fullPath)
           if (stats.isDirectory()) {
-            await writelnStderr(process, terminal, `hex: ${filePath}: Is a directory`)
+            await writelnStderr(process, terminal, `xxd: ${filePath}: Is a directory`)
             return 1
           }
 
@@ -152,7 +152,7 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
         return 0
       } catch (error) {
         const errorPath = filePath || 'stdin'
-        await writelnStderr(process, terminal, `hex: ${errorPath}: ${error instanceof Error ? error.message : 'Unknown error'}`)
+        await writelnStderr(process, terminal, `xxd: ${errorPath}: ${error instanceof Error ? error.message : 'Unknown error'}`)
         return 1
       }
     }

package/src/index.ts

@@ -42,7 +42,7 @@ import { createCommand as createRm } from './commands/rm.js'
 import { createCommand as createRmdir } from './commands/rmdir.js'
 import { createCommand as createStat } from './commands/stat.js'
 import { createCommand as createTouch } from './commands/touch.js'
-import { createCommand as createHex } from './commands/hex.js'
+import { createCommand as createXxd } from './commands/xxd.js'
 import { createCommand as createLess } from './commands/less.js'
 import { createCommand as createMan } from './commands/man.js'
 import { createCommand as createPasskey } from './commands/passkey.js'
@@ -131,7 +131,7 @@ export { createCommand as createRmdir } from './commands/rmdir.js'
 export { createCommand as createStat } from './commands/stat.js'
 export { createCommand as createStrings } from './commands/strings.js'
 export { createCommand as createTouch } from './commands/touch.js'
-export { createCommand as createHex } from './commands/hex.js'
+export { createCommand as createXxd } from './commands/xxd.js'
 export { createCommand as createLess } from './commands/less.js'
 export { createCommand as createMan } from './commands/man.js'
 export { createCommand as createSed } from './commands/sed.js'
@@ -215,7 +215,7 @@ export function createAllCommands(kernel: Kernel, shell: Shell, terminal: Termin
     stat: createStat(kernel, shell, terminal),
     strings: createStrings(kernel, shell, terminal),
     touch: createTouch(kernel, shell, terminal),
-    hex: createHex(kernel, shell, terminal),
+    xxd: createXxd(kernel, shell, terminal),
     less: createLess(kernel, shell, terminal),
     man: createMan(kernel, shell, terminal),
     passkey: createPasskey(kernel, shell, terminal),