cffs-image-tool 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aaron Wright
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# cffs
+
+A CLI tool for creating and managing CompactFlash filesystem images for the A.C. Wright 6502 project.
+
+The filesystem uses a simple flat layout: a single 512-byte directory sector (LBA 0) holding up to 16 entries in 8.3 filename format, followed by contiguous data sectors starting at LBA 1.
+
+## Features
+
+- Create blank CF images of configurable size
+- Add, remove, list, and extract files
+- Defragment images to reclaim gaps
+- Display image statistics
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/) (v18 or later recommended)
+- npm
+
+## Build
+
+```bash
+npm install
+npm run build
+```
+
+The compiled output is written to the `dist/` directory.
+
+## Usage
+
+After building, run the tool directly with Node or via the `cffs` bin entry:
+
+```bash
+# Create a 32 MB image
+npx cffs create disk.img --size 32M
+
+# Add a file
+npx cffs add disk.img firmware.bin
+
+# List files
+npx cffs list disk.img
+
+# Extract a file
+npx cffs extract disk.img FIRMWARE.BIN output.bin
+
+# Show image info
+npx cffs info disk.img
+
+# Remove a file
+npx cffs remove disk.img FIRMWARE.BIN
+
+# Defragment
+npx cffs defrag disk.img
+
+# Clear all entries
+npx cffs clear disk.img
+```
+
+### Development
+
+Run directly from TypeScript without compiling:
+
+```bash
+npm run dev -- <command> [options]
+```
+
+## Filesystem Layout
+
+| Region    | LBA   | Size       | Description                          |
+|-----------|-------|------------|--------------------------------------|
+| Directory | 0     | 512 bytes  | Up to 16 × 32-byte directory entries |
+| Data      | 1+    | Remainder  | Contiguous file data sectors         |
+
+Each directory entry is 32 bytes:
+
+| Offset | Length | Field        |
+|--------|--------|--------------|
+| 0      | 8      | Filename     |
+| 8      | 3      | Extension    |
+| 11     | 1      | Flags        |
+| 12     | 2      | Start sector |
+| 14     | 2      | File size    |
+| 16     | 16     | Reserved     |
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { openImage, saveImage, createImage } from './lib/image.js';
+import { formatName } from './lib/filename.js';
+import { calcSectorCount } from './lib/directory.js';
+import { addFile, removeFile, listFiles, extractFile, defragment, clearImage, imageInfo, } from './lib/operations.js';
+const program = new Command();
+program
+    .name('cffs')
+    .description('CompactFlash Filesystem Image Tool for A.C. Wright 6502 Project')
+    .version('1.0.0');
+/**
+ * Parse a size string like "32M", "512K", "1G", or a plain number (bytes).
+ */
+function parseSize(value) {
+    const match = value.match(/^(\d+)\s*([KMGkmg])?[Bb]?$/);
+    if (!match) {
+        throw new Error(`Invalid size format: "${value}". Use e.g. 32M, 512K, or bytes.`);
+    }
+    const num = parseInt(match[1], 10);
+    const unit = (match[2] ?? '').toUpperCase();
+    switch (unit) {
+        case 'K': return num * 1024;
+        case 'M': return num * 1024 * 1024;
+        case 'G': return num * 1024 * 1024 * 1024;
+        default: return num;
+    }
+}
+// ── create ──────────────────────────────────────────────────────────────────
+program
+    .command('create')
+    .description('Create a blank CompactFlash image')
+    .argument('<image>', 'Path to image file to create')
+    .option('-s, --size <size>', 'Image size (e.g. 32M, 512K)', '32M')
+    .action((image, opts) => {
+    const totalBytes = parseSize(opts.size);
+    if (totalBytes % 512 !== 0) {
+        console.error('Error: size must be a multiple of 512 bytes');
+        process.exit(1);
+    }
+    const totalSectors = totalBytes / 512;
+    const buf = createImage(totalSectors);
+    saveImage(image, buf);
+    console.log(`Created ${image} (${totalBytes.toLocaleString()} bytes, ${totalSectors.toLocaleString()} sectors)`);
+});
+// ── list ────────────────────────────────────────────────────────────────────
+program
+    .command('list')
+    .description('List files in the image')
+    .argument('<image>', 'Path to image file')
+    .action((image) => {
+    const buf = openImage(image);
+    const files = listFiles(buf);
+    if (files.length === 0) {
+        console.log('No files in image.');
+        return;
+    }
+    console.log('Name          Size     Start  Sectors');
+    console.log('────────────  ───────  ─────  ───────');
+    for (const f of files) {
+        const display = formatName(f).padEnd(12);
+        const size = f.fileSize.toString().padStart(7);
+        const start = f.startSector.toString().padStart(5);
+        const sectors = calcSectorCount(f.fileSize).toString().padStart(7);
+        console.log(`${display}  ${size}  ${start}  ${sectors}`);
+    }
+});
+// ── add ─────────────────────────────────────────────────────────────────────
+program
+    .command('add')
+    .description('Add a host file to the image')
+    .argument('<image>', 'Path to image file')
+    .argument('<file>', 'Host file to add')
+    .option('-n, --name <name>', 'Target 8.3 filename (default: source filename)')
+    .action((image, file, opts) => {
+    const buf = openImage(image);
+    addFile(buf, file, opts.name);
+    saveImage(image, buf);
+    console.log(`Added ${opts.name ?? file} to ${image}`);
+});
+// ── remove ──────────────────────────────────────────────────────────────────
+program
+    .command('remove')
+    .description('Delete a file entry from the image')
+    .argument('<image>', 'Path to image file')
+    .argument('<name>', 'Filename to remove (8.3 format)')
+    .action((image, name) => {
+    const buf = openImage(image);
+    removeFile(buf, name);
+    saveImage(image, buf);
+    console.log(`Removed ${name} from ${image}`);
+});
+// ── extract ─────────────────────────────────────────────────────────────────
+program
+    .command('extract')
+    .description('Extract a file from the image to the host filesystem')
+    .argument('<image>', 'Path to image file')
+    .argument('<name>', 'Filename to extract (8.3 format)')
+    .argument('[output]', 'Output path (default: original filename)')
+    .action((image, name, output) => {
+    const buf = openImage(image);
+    extractFile(buf, name, output);
+    console.log(`Extracted ${name} from ${image}`);
+});
+// ── defrag ──────────────────────────────────────────────────────────────────
+program
+    .command('defrag')
+    .description('Defragment the image (compact files)')
+    .argument('<image>', 'Path to image file')
+    .action((image) => {
+    const buf = openImage(image);
+    defragment(buf);
+    saveImage(image, buf);
+    console.log(`Defragmented ${image}`);
+});
+// ── clear ───────────────────────────────────────────────────────────────────
+program
+    .command('clear')
+    .description('Clear all directory entries')
+    .argument('<image>', 'Path to image file')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .action(async (image, opts) => {
+    if (!opts.yes) {
+        const rl = createInterface({ input: stdin, output: stdout });
+        const answer = await rl.question(`Clear all entries in ${image}? [y/N] `);
+        rl.close();
+        if (answer.toLowerCase() !== 'y') {
+            console.log('Aborted.');
+            return;
+        }
+    }
+    const buf = openImage(image);
+    clearImage(buf);
+    saveImage(image, buf);
+    console.log(`Cleared all directory entries in ${image}`);
+});
+// ── info ────────────────────────────────────────────────────────────────────
+program
+    .command('info')
+    .description('Display image statistics')
+    .argument('<image>', 'Path to image file')
+    .action((image) => {
+    const buf = openImage(image);
+    const info = imageInfo(buf);
+    console.log(`Image size:       ${(info.totalSectors * 512).toLocaleString()} bytes (${info.totalSectors.toLocaleString()} sectors)`);
+    console.log(`Directory:        ${info.usedEntries}/16 entries used, ${info.freeEntries} free`);
+    console.log(`Data sectors:     ${info.usedDataSectors} used, ${info.freeDataSectors.toLocaleString()} free`);
+    console.log(`Next free sector: ${info.nextFreeSector}`);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/lib/constants.d.ts

@@ -0,0 +1,15 @@
+export declare const SECTOR_SIZE = 512;
+export declare const DIR_LBA = 0;
+export declare const DATA_START = 1;
+export declare const MAX_FILES = 16;
+export declare const ENTRY_SIZE = 32;
+export declare const NAME_OFFSET = 0;
+export declare const NAME_LENGTH = 8;
+export declare const EXT_OFFSET = 8;
+export declare const EXT_LENGTH = 3;
+export declare const FLAGS_OFFSET = 11;
+export declare const START_OFFSET = 12;
+export declare const FSIZE_OFFSET = 14;
+export declare const RESERVED_OFFSET = 16;
+export declare const RESERVED_LENGTH = 16;
+export declare const FLAG_USED = 1;

package/dist/lib/constants.js

@@ -0,0 +1,18 @@
+export const SECTOR_SIZE = 512;
+export const DIR_LBA = 0;
+export const DATA_START = 1;
+export const MAX_FILES = 16;
+export const ENTRY_SIZE = 32;
+// Field offsets within a directory entry
+export const NAME_OFFSET = 0;
+export const NAME_LENGTH = 8;
+export const EXT_OFFSET = 8;
+export const EXT_LENGTH = 3;
+export const FLAGS_OFFSET = 11;
+export const START_OFFSET = 12;
+export const FSIZE_OFFSET = 14;
+export const RESERVED_OFFSET = 16;
+export const RESERVED_LENGTH = 16;
+// Flags
+export const FLAG_USED = 0x01;
+//# sourceMappingURL=constants.js.map

package/dist/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/lib/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC;AACzB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAE7B,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAElC,QAAQ;AACR,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC"}

package/dist/lib/directory.d.ts

@@ -0,0 +1,28 @@
+import { DirEntry } from './types.js';
+/**
+ * Parse all 16 directory entries from LBA 0.
+ */
+export declare function readDirectory(buf: Buffer): DirEntry[];
+/**
+ * Serialize directory entries back to LBA 0.
+ */
+export declare function writeDirectory(buf: Buffer, entries: DirEntry[]): void;
+/**
+ * Find a used directory entry by name and extension (space-padded, uppercase).
+ */
+export declare function findFile(entries: DirEntry[], name: string, ext: string): DirEntry | undefined;
+/**
+ * Find the first free (unused) directory slot index, or -1 if full.
+ */
+export declare function findFreeSlot(entries: DirEntry[]): number;
+/**
+ * Calculate the next free sector after all allocated files.
+ * Replicates BIOS FsCalcNextSec logic:
+ *   sectors = highByte >> 1; if (highByte & 1 || lowByte != 0) sectors++
+ */
+export declare function calcSectorCount(fileSize: number): number;
+/**
+ * Calculate the next free sector for allocation.
+ * Returns max(startSector + sectorCount) across all used entries, minimum DATA_START.
+ */
+export declare function calcNextSector(entries: DirEntry[]): number;

package/dist/lib/directory.js

@@ -0,0 +1,85 @@
+import { SECTOR_SIZE, DIR_LBA, MAX_FILES, ENTRY_SIZE, NAME_OFFSET, NAME_LENGTH, EXT_OFFSET, EXT_LENGTH, FLAGS_OFFSET, START_OFFSET, FSIZE_OFFSET, FLAG_USED, DATA_START, } from './constants.js';
+import { readSector, writeSector } from './image.js';
+/**
+ * Parse all 16 directory entries from LBA 0.
+ */
+export function readDirectory(buf) {
+    const sector = readSector(buf, DIR_LBA);
+    const entries = [];
+    for (let i = 0; i < MAX_FILES; i++) {
+        const off = i * ENTRY_SIZE;
+        const name = sector.subarray(off + NAME_OFFSET, off + NAME_OFFSET + NAME_LENGTH).toString('ascii');
+        const ext = sector.subarray(off + EXT_OFFSET, off + EXT_OFFSET + EXT_LENGTH).toString('ascii');
+        const flags = sector[off + FLAGS_OFFSET];
+        const startSector = sector.readUInt16LE(off + START_OFFSET);
+        const fileSize = sector.readUInt16LE(off + FSIZE_OFFSET);
+        entries.push({ name, ext, flags, startSector, fileSize, index: i });
+    }
+    return entries;
+}
+/**
+ * Serialize directory entries back to LBA 0.
+ */
+export function writeDirectory(buf, entries) {
+    const sector = Buffer.alloc(SECTOR_SIZE);
+    for (const entry of entries) {
+        const off = entry.index * ENTRY_SIZE;
+        // Write name (8 bytes, space-padded)
+        sector.write(entry.name.padEnd(NAME_LENGTH, ' '), off + NAME_OFFSET, NAME_LENGTH, 'ascii');
+        // Write extension (3 bytes, space-padded)
+        sector.write(entry.ext.padEnd(EXT_LENGTH, ' '), off + EXT_OFFSET, EXT_LENGTH, 'ascii');
+        // Flags
+        sector[off + FLAGS_OFFSET] = entry.flags;
+        // Start sector (u16 LE)
+        sector.writeUInt16LE(entry.startSector, off + START_OFFSET);
+        // File size (u16 LE)
+        sector.writeUInt16LE(entry.fileSize, off + FSIZE_OFFSET);
+        // Reserved bytes stay zeroed
+    }
+    writeSector(buf, DIR_LBA, sector);
+}
+/**
+ * Find a used directory entry by name and extension (space-padded, uppercase).
+ */
+export function findFile(entries, name, ext) {
+    return entries.find((e) => (e.flags & FLAG_USED) !== 0 && e.name === name && e.ext === ext);
+}
+/**
+ * Find the first free (unused) directory slot index, or -1 if full.
+ */
+export function findFreeSlot(entries) {
+    const entry = entries.find((e) => (e.flags & FLAG_USED) === 0);
+    return entry ? entry.index : -1;
+}
+/**
+ * Calculate the next free sector after all allocated files.
+ * Replicates BIOS FsCalcNextSec logic:
+ *   sectors = highByte >> 1; if (highByte & 1 || lowByte != 0) sectors++
+ */
+export function calcSectorCount(fileSize) {
+    const lowByte = fileSize & 0xFF;
+    const highByte = (fileSize >> 8) & 0xFF;
+    let sectors = highByte >> 1;
+    if ((highByte & 1) !== 0 || lowByte !== 0) {
+        sectors++;
+    }
+    return sectors;
+}
+/**
+ * Calculate the next free sector for allocation.
+ * Returns max(startSector + sectorCount) across all used entries, minimum DATA_START.
+ */
+export function calcNextSector(entries) {
+    let next = DATA_START;
+    for (const e of entries) {
+        if ((e.flags & FLAG_USED) === 0)
+            continue;
+        const sectorCount = calcSectorCount(e.fileSize);
+        const end = e.startSector + sectorCount;
+        if (end > next) {
+            next = end;
+        }
+    }
+    return next;
+}
+//# sourceMappingURL=directory.js.map

package/dist/lib/directory.js.map

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

package/dist/lib/filename.d.ts

@@ -0,0 +1,13 @@
+import { DirEntry } from './types.js';
+/**
+ * Parse user input into 8.3 filename components.
+ * Splits on first dot, uppercases, space-pads to 8+3.
+ */
+export declare function parseName(input: string): {
+    name: string;
+    ext: string;
+};
+/**
+ * Format a directory entry's name for display as NAME.EXT (trimmed).
+ */
+export declare function formatName(entry: DirEntry): string;

package/dist/lib/filename.js

@@ -0,0 +1,48 @@
+/**
+ * Parse user input into 8.3 filename components.
+ * Splits on first dot, uppercases, space-pads to 8+3.
+ */
+export function parseName(input) {
+    const dotIndex = input.indexOf('.');
+    let rawName;
+    let rawExt;
+    if (dotIndex === -1) {
+        rawName = input;
+        rawExt = '';
+    }
+    else {
+        rawName = input.substring(0, dotIndex);
+        rawExt = input.substring(dotIndex + 1);
+    }
+    rawName = rawName.toUpperCase();
+    rawExt = rawExt.toUpperCase();
+    if (rawName.length === 0 || rawName.length > 8) {
+        throw new Error(`Invalid filename: name part must be 1-8 characters, got "${rawName}"`);
+    }
+    if (rawExt.length > 3) {
+        throw new Error(`Invalid filename: extension must be 0-3 characters, got "${rawExt}"`);
+    }
+    // Validate ASCII printable (no spaces or special control chars in input)
+    const validChars = /^[A-Z0-9!#$%&'()\-@^_`{}~]+$/;
+    if (!validChars.test(rawName)) {
+        throw new Error(`Invalid filename: name contains invalid characters "${rawName}"`);
+    }
+    if (rawExt.length > 0 && !validChars.test(rawExt)) {
+        throw new Error(`Invalid filename: extension contains invalid characters "${rawExt}"`);
+    }
+    const name = rawName.padEnd(8, ' ');
+    const ext = rawExt.padEnd(3, ' ');
+    return { name, ext };
+}
+/**
+ * Format a directory entry's name for display as NAME.EXT (trimmed).
+ */
+export function formatName(entry) {
+    const name = entry.name.trimEnd();
+    const ext = entry.ext.trimEnd();
+    if (ext.length === 0) {
+        return name;
+    }
+    return `${name}.${ext}`;
+}
+//# sourceMappingURL=filename.js.map

package/dist/lib/filename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.js","sourceRoot":"","sources":["../../src/lib/filename.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,OAAe,CAAC;IACpB,IAAI,MAAc,CAAC;IAEnB,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,4DAA4D,OAAO,GAAG,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,4DAA4D,MAAM,GAAG,CAAC,CAAC;IACzF,CAAC;IAED,yEAAyE;IACzE,MAAM,UAAU,GAAG,8BAA8B,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uDAAuD,OAAO,GAAG,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,4DAA4D,MAAM,GAAG,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAElC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC1B,CAAC"}

package/dist/lib/image.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Read an entire image file into a Buffer.
+ */
+export declare function openImage(path: string): Buffer;
+/**
+ * Write a Buffer to disk as an image file.
+ */
+export declare function saveImage(path: string, buf: Buffer): void;
+/**
+ * Create a new zeroed image buffer with the given number of sectors.
+ */
+export declare function createImage(totalSectors: number): Buffer;
+/**
+ * Read a single sector (512 bytes) from the image buffer at the given LBA.
+ */
+export declare function readSector(buf: Buffer, lba: number): Buffer;
+/**
+ * Write 512 bytes of data to the image buffer at the given LBA.
+ */
+export declare function writeSector(buf: Buffer, lba: number, data: Buffer): void;

package/dist/lib/image.js

@@ -0,0 +1,46 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { SECTOR_SIZE } from './constants.js';
+/**
+ * Read an entire image file into a Buffer.
+ */
+export function openImage(path) {
+    return readFileSync(path);
+}
+/**
+ * Write a Buffer to disk as an image file.
+ */
+export function saveImage(path, buf) {
+    writeFileSync(path, buf);
+}
+/**
+ * Create a new zeroed image buffer with the given number of sectors.
+ */
+export function createImage(totalSectors) {
+    return Buffer.alloc(totalSectors * SECTOR_SIZE);
+}
+/**
+ * Read a single sector (512 bytes) from the image buffer at the given LBA.
+ */
+export function readSector(buf, lba) {
+    const offset = lba * SECTOR_SIZE;
+    if (offset + SECTOR_SIZE > buf.length) {
+        throw new Error(`Sector ${lba} is out of bounds (image size: ${buf.length} bytes)`);
+    }
+    return Buffer.from(buf.subarray(offset, offset + SECTOR_SIZE));
+}
+/**
+ * Write 512 bytes of data to the image buffer at the given LBA.
+ */
+export function writeSector(buf, lba, data) {
+    const offset = lba * SECTOR_SIZE;
+    if (offset + SECTOR_SIZE > buf.length) {
+        throw new Error(`Sector ${lba} is out of bounds (image size: ${buf.length} bytes)`);
+    }
+    if (data.length > SECTOR_SIZE) {
+        throw new Error(`Data exceeds sector size (${data.length} > ${SECTOR_SIZE})`);
+    }
+    // Zero the sector first, then copy data (handles data shorter than 512)
+    buf.fill(0, offset, offset + SECTOR_SIZE);
+    data.copy(buf, offset);
+}
+//# sourceMappingURL=image.js.map

package/dist/lib/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","sourceRoot":"","sources":["../../src/lib/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW;IACjD,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,YAAoB;IAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,WAAW,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,GAAW;IACjD,MAAM,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC;IACjC,IAAI,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,kCAAkC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY;IAChE,MAAM,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC;IACjC,IAAI,MAAM,GAAG,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,UAAU,GAAG,kCAAkC,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,wEAAwE;IACxE,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACzB,CAAC"}

package/dist/lib/operations.d.ts

@@ -0,0 +1,36 @@
+import { DirEntry } from './types.js';
+/**
+ * Add a host file to the image. Optionally rename with targetName (8.3 format).
+ */
+export declare function addFile(buf: Buffer, hostPath: string, targetName?: string): void;
+/**
+ * Remove a file by name (clears flags only, no compaction — matches BIOS FsDeleteFile).
+ */
+export declare function removeFile(buf: Buffer, nameInput: string): void;
+/**
+ * List all in-use directory entries.
+ */
+export declare function listFiles(buf: Buffer): DirEntry[];
+/**
+ * Extract a file from the image to the host filesystem.
+ */
+export declare function extractFile(buf: Buffer, nameInput: string, outputPath?: string): void;
+/**
+ * Defragment the image: sort used entries by startSector, rewrite contiguously from LBA 1.
+ */
+export declare function defragment(buf: Buffer): void;
+/**
+ * Clear all directory entries (zero the directory sector).
+ */
+export declare function clearImage(buf: Buffer): void;
+/**
+ * Return image stats.
+ */
+export declare function imageInfo(buf: Buffer): {
+    totalSectors: number;
+    usedEntries: number;
+    freeEntries: number;
+    nextFreeSector: number;
+    usedDataSectors: number;
+    freeDataSectors: number;
+};