remove node dependency

Author: keichan34

README.ja.md

@@ -183,31 +183,24 @@ const inspected = inspectTile(encoded.bytes);
 const decoded = await decodeTile(encoded.bytes);
 ```
 
-CLI 出力相当の高レベルヘルパーを使う場合:
+高レベルヘルパーを使う場合（コアライブラリはランタイム非依存で、ファイル I/O は呼び出し側で実施）:
 
 ```ts
 import {
   decodeTile,
   decodeTileToCsv,
-  decodeTileFileToCsv,
-  encodeTileToFile,
-  inspectTileFile,
-  inspectTileToText,
+  encodeTile,
+  inspectTile,
 } from 'mesh-data-tile';
-import { readFile } from 'node:fs/promises';
-
-const inspectResult = await inspectTileFile('in.tile');
-console.log(inspectResult.text);
-
-const { csv } = await decodeTileFileToCsv('in.tile');
-console.log(csv);
+import { readFile, writeFile } from 'node:fs/promises';
 
 const bytes = new Uint8Array(await readFile('in.tile'));
-const fromBytes = inspectTileToText(bytes);
-const csvFromBytes = await decodeTileToCsv(bytes);
+const inspected = inspectTile(bytes);
+const { csv } = await decodeTileToCsv(bytes);
 const decoded = await decodeTile(bytes);
+console.log(inspected.header.tile_id, csv);
 
-await encodeTileToFile('out.tile', {
+const encoded = await encodeTile({
   tile_id: 99n,
   mesh_kind: 'jis-x0410',
   rows: 2,
@@ -217,8 +210,11 @@ await encodeTileToFile('out.tile', {
   endianness: 'little',
   data: [1, 2, 3, 4],
 });
+await writeFile('out.tile', encoded.bytes);
 ```
 
+CLI と同等の inspect テキスト出力やファイルパス直接処理は `mesh-data-tile-cli` を利用してください。
+
 ## MapLibre addProtocol 対応
 
 ```ts

README.md

@@ -183,31 +183,24 @@ const inspected = inspectTile(encoded.bytes);
 const decoded = await decodeTile(encoded.bytes);
 ```
 
-Use high-level helpers equivalent to CLI output:
+Use high-level helpers (core library is runtime-neutral; file I/O is caller-managed):
 
 ```ts
 import {
   decodeTile,
   decodeTileToCsv,
-  decodeTileFileToCsv,
-  encodeTileToFile,
-  inspectTileFile,
-  inspectTileToText,
+  encodeTile,
+  inspectTile,
 } from 'mesh-data-tile';
-import { readFile } from 'node:fs/promises';
-
-const inspectResult = await inspectTileFile('in.tile');
-console.log(inspectResult.text);
-
-const { csv } = await decodeTileFileToCsv('in.tile');
-console.log(csv);
+import { readFile, writeFile } from 'node:fs/promises';
 
 const bytes = new Uint8Array(await readFile('in.tile'));
-const fromBytes = inspectTileToText(bytes);
-const csvFromBytes = await decodeTileToCsv(bytes);
+const inspected = inspectTile(bytes);
+const { csv } = await decodeTileToCsv(bytes);
 const decoded = await decodeTile(bytes);
+console.log(inspected.header.tile_id, csv);
 
-await encodeTileToFile('out.tile', {
+const encoded = await encodeTile({
   tile_id: 99n,
   mesh_kind: 'jis-x0410',
   rows: 2,
@@ -217,8 +210,11 @@ await encodeTileToFile('out.tile', {
   endianness: 'little',
   data: [1, 2, 3, 4],
 });
+await writeFile('out.tile', encoded.bytes);
 ```
 
+For CLI-style inspect text output and file-path based operations, use `mesh-data-tile-cli`.
+
 ## MapLibre addProtocol support
 
 ```ts

packages/mesh-data-tile-cli/src/cli.ts

@@ -3,9 +3,11 @@ import { readFile, writeFile } from 'node:fs/promises';
 import { Command } from 'commander';
 import {
   decodeTileToCsv,
-  encodeTileToFile,
-  inspectTileToText,
+  decodeXyzTileId,
+  encodeTile,
+  inspectTile,
   TileFormatError,
+  type InspectTileResult,
   type TileEncodeInput,
   type DType,
   type Endianness,
@@ -38,6 +40,11 @@ interface EncodeCommandOptions {
   noData?: string;
 }
 
+interface InspectTileTextResult {
+  info: InspectTileResult;
+  text: string;
+}
+
 function fail(message: string, code = 1): never {
   console.error(`error: ${message}`);
   process.exit(code);
@@ -114,15 +121,65 @@ async function writeOutput(path: string | undefined, content: Uint8Array | strin
   await writeFile(path, content);
 }
 
+function formatInspectOutput(info: InspectTileResult): string {
+  const lines = [
+    `Format Major: ${info.header.format_major}`,
+    `Tile ID: ${info.header.tile_id.toString()}`,
+    `Mesh Kind: ${info.header.mesh_kind}`,
+    `DType: ${info.header.dtype}`,
+    `Endianness: ${info.header.endianness}`,
+    `Compression: ${info.header.compression}`,
+    `Rows: ${info.header.dimensions.rows}`,
+    `Cols: ${info.header.dimensions.cols}`,
+    `Bands: ${info.header.dimensions.bands}`,
+    `NoData: ${info.header.no_data === null ? 'null' : String(info.header.no_data)}`,
+    `Uncompressed Payload Bytes: ${info.header.payload.uncompressed_bytes}`,
+    `Compressed Payload Bytes: ${info.header.payload.compressed_bytes}`,
+    `Payload CRC32: ${info.header.checksum.payload_crc32}`,
+    `Header CRC32: ${info.header.checksum.header_crc32}`,
+    `Header Length: ${info.header_length}`,
+    `Payload Offset: ${info.payload_offset}`,
+    `Payload Length: ${info.payload_length}`,
+  ];
+
+  if (info.header.mesh_kind === 'xyz') {
+    const xyz = decodeXyzTileId(info.header.tile_id);
+    lines.push(`XYZ Zoom: ${xyz.zoom}`);
+    lines.push(`XYZ X: ${xyz.x}`);
+    lines.push(`XYZ Y: ${xyz.y}`);
+    lines.push(`XYZ Quadkey Integer: ${xyz.quadkey_integer.toString()}`);
+  }
+
+  return lines.join('\n');
+}
+
+function inspectTileToText(bytes: Uint8Array): InspectTileTextResult {
+  const info = inspectTile(bytes);
+  return {
+    info,
+    text: formatInspectOutput(info),
+  };
+}
+
+async function decodeTileFileToCsv(path: string) {
+  const bytes = new Uint8Array(await readFile(path));
+  return decodeTileToCsv(bytes);
+}
+
+async function encodeTileToFile(path: string, input: TileEncodeInput) {
+  const encoded = await encodeTile(input);
+  await writeFile(path, encoded.bytes);
+  return encoded;
+}
+
 async function runInspect(inputPath: string): Promise<void> {
   const input = new Uint8Array(await readFile(inputPath));
   const result = inspectTileToText(input);
   console.log(result.text);
 }
 
 async function runDecode(inputPath: string, options: DecodeCommandOptions): Promise<void> {
-  const input = new Uint8Array(await readFile(inputPath));
-  const result = await decodeTileToCsv(input);
+  const result = await decodeTileFileToCsv(inputPath);
   await writeOutput(options.output, result.csv);
 }
 

src/api.ts

@@ -1,52 +1,12 @@
-import { readFile, writeFile } from 'node:fs/promises';
 import { createError } from './errors.js';
-import { decodeTile, encodeTile, inspectTile } from './tile-format.js';
-import { decodeXyzTileId } from './tile-id.js';
-import type { EncodeResult } from './tile-format.js';
-import type { DecodedTile, InspectTileResult, TileEncodeInput } from './types.js';
-
-export interface InspectTileTextResult {
-  info: InspectTileResult;
-  text: string;
-}
+import { decodeTile } from './tile-format.js';
+import type { DecodedTile } from './types.js';
 
 export interface DecodeTileCsvResult {
   decoded: DecodedTile;
   csv: string;
 }
 
-export function formatInspectOutput(info: InspectTileResult): string {
-  const lines = [
-    `Format Major: ${info.header.format_major}`,
-    `Tile ID: ${info.header.tile_id.toString()}`,
-    `Mesh Kind: ${info.header.mesh_kind}`,
-    `DType: ${info.header.dtype}`,
-    `Endianness: ${info.header.endianness}`,
-    `Compression: ${info.header.compression}`,
-    `Rows: ${info.header.dimensions.rows}`,
-    `Cols: ${info.header.dimensions.cols}`,
-    `Bands: ${info.header.dimensions.bands}`,
-    `NoData: ${info.header.no_data === null ? 'null' : String(info.header.no_data)}`,
-    `Uncompressed Payload Bytes: ${info.header.payload.uncompressed_bytes}`,
-    `Compressed Payload Bytes: ${info.header.payload.compressed_bytes}`,
-    `Payload CRC32: ${info.header.checksum.payload_crc32}`,
-    `Header CRC32: ${info.header.checksum.header_crc32}`,
-    `Header Length: ${info.header_length}`,
-    `Payload Offset: ${info.payload_offset}`,
-    `Payload Length: ${info.payload_length}`,
-  ];
-
-  if (info.header.mesh_kind === 'xyz') {
-    const xyz = decodeXyzTileId(info.header.tile_id);
-    lines.push(`XYZ Zoom: ${xyz.zoom}`);
-    lines.push(`XYZ X: ${xyz.x}`);
-    lines.push(`XYZ Y: ${xyz.y}`);
-    lines.push(`XYZ Quadkey Integer: ${xyz.quadkey_integer.toString()}`);
-  }
-
-  return lines.join('\n');
-}
-
 export function formatDecodedCsv(values: ArrayLike<number>, rows: number, cols: number, bands: number): string {
   const expected = rows * cols * bands;
   if (values.length !== expected) {
@@ -72,14 +32,6 @@ export function formatDecodedCsv(values: ArrayLike<number>, rows: number, cols:
   return lines.join('\n');
 }
 
-export function inspectTileToText(bytes: Uint8Array): InspectTileTextResult {
-  const info = inspectTile(bytes);
-  return {
-    info,
-    text: formatInspectOutput(info),
-  };
-}
-
 export async function decodeTileToCsv(bytes: Uint8Array): Promise<DecodeTileCsvResult> {
   const decoded = await decodeTile(bytes);
   const { rows, cols, bands } = decoded.header.dimensions;
@@ -88,19 +40,3 @@ export async function decodeTileToCsv(bytes: Uint8Array): Promise<DecodeTileCsvR
     csv: formatDecodedCsv(decoded.data, rows, cols, bands),
   };
 }
-
-export async function inspectTileFile(path: string): Promise<InspectTileTextResult> {
-  const bytes = new Uint8Array(await readFile(path));
-  return inspectTileToText(bytes);
-}
-
-export async function decodeTileFileToCsv(path: string): Promise<DecodeTileCsvResult> {
-  const bytes = new Uint8Array(await readFile(path));
-  return decodeTileToCsv(bytes);
-}
-
-export async function encodeTileToFile(path: string, input: TileEncodeInput): Promise<EncodeResult> {
-  const encoded = await encodeTile(input);
-  await writeFile(path, encoded.bytes);
-  return encoded;
-}

src/index.ts

@@ -39,13 +39,8 @@ export {
   renderMeshTileUrlTemplate,
 } from './maplibre-source.js';
 export {
-  formatInspectOutput,
   formatDecodedCsv,
-  inspectTileToText,
   decodeTileToCsv,
-  inspectTileFile,
-  decodeTileFileToCsv,
-  encodeTileToFile,
 } from './api.js';
 export {
   encodeTile,

test/conformance.test.ts

@@ -6,17 +6,12 @@ import { join } from 'node:path';
 import { tmpdir } from 'node:os';
 import {
   decodeTile,
-  decodeTileFileToCsv,
   decodeTileToCsv,
   decodeXyzTileId,
   encodeTile,
-  encodeTileToFile,
   encodeXyzTileId,
   formatDecodedCsv,
-  formatInspectOutput,
   inspectTile,
-  inspectTileFile,
-  inspectTileToText,
 } from '../src/index.js';
 import { TileFormatError } from '../src/errors.js';
 
@@ -346,33 +341,24 @@ describe('mesh tile v1 conformance', () => {
     );
   });
 
-  it('library api inspect text includes xyz coordinates', async () => {
-    const input = new Uint8Array(await fs.readFile(join(fixturesDir, 'xyz-uncompressed.tile')));
-    const result = inspectTileToText(input);
-    const fromFormatter = formatInspectOutput(inspectTile(input));
-
-    assert.equal(result.text, fromFormatter);
-    assert.match(result.text, /XYZ Zoom: 12/);
-    assert.match(result.text, /XYZ X: 3639/);
-    assert.match(result.text, /XYZ Y: 1612/);
-  });
-
-  it('library api file helpers roundtrip', async () => {
+  it('library api roundtrip with caller-managed file io', async () => {
     const tempDir = await fs.mkdtemp(join(tmpdir(), 'mesh-data-tile-'));
     const outputPath = join(tempDir, 'api-roundtrip.tile');
 
     try {
-      await encodeTileToFile(outputPath, {
+      const encoded = await encodeTile({
         ...tileTemplate(),
         tile_id: 2001n,
         dtype: 'uint16',
         data: [10, 20, 30, 40],
       });
+      await fs.writeFile(outputPath, encoded.bytes);
 
-      const inspected = await inspectTileFile(outputPath);
-      const decoded = await decodeTileFileToCsv(outputPath);
+      const bytes = new Uint8Array(await fs.readFile(outputPath));
+      const inspected = inspectTile(bytes);
+      const decoded = await decodeTileToCsv(bytes);
 
-      assert.equal(inspected.info.header.tile_id, 2001n);
+      assert.equal(inspected.header.tile_id, 2001n);
       assert.equal(decoded.csv, ['x,y,b0', '0,0,10', '1,0,20', '0,1,30', '1,1,40'].join('\n'));
     } finally {
       await fs.rm(tempDir, { recursive: true, force: true });