Refactor: Replace barrel exports with explicit imports

ARCHITECTURE.md

@@ -112,13 +112,13 @@ scrapeStart → openPage → loadDOMContent → getHTML → waitNetworkIdle
 ```
 crawler/src/
 ├── utils/                      # 型定義 + ユーティリティ
-│   ├── types/                  # ExURL, PageData, ParseURLOptions 等
+│   ├── types/                  # ExURL, PageData, Link, CrawlerError 等
 │   ├── array/                  # eachSplitted
 │   ├── object/                 # cleanObject
 │   └── error/                  # DOMEvaluationError, ErrorEmitter
 ├── archive/                    # SQLite アーカイブストレージ
 │   ├── filesystem/             # 1関数1ファイル（16ファイル）+ tar, untar
-│   └── ...                     # archive, archive-accessor, database, page, resource
+│   └── ...                     # archive, archive-accessor, database, page, resource, safe-path, types
 ├── crawler/                    # Crawler エンジン
 │   ├── crawler.ts              # Crawler クラス
 │   ├── link-list.ts            # URL キュー管理
@@ -143,7 +143,11 @@ crawler/src/
 │   ├── fetch-robots-txt.ts     # robots.txt 取得・パース
 │   ├── robots-checker.ts       # robots.txt 準拠チェッカー（origin 別キャッシュ）
 │   └── ...                     # link-to-page-data, protocol-agnostic-key, net-timeout-error
+├── crawler.ts                  # バレルエクスポート（パッケージ公開 API）
 ├── crawler-orchestrator.ts     # CrawlerOrchestrator
+├── debug.ts                    # デバッグログユーティリティ
+├── resolve-output-path.ts      # 出力パス解決・検証
+├── types.ts                    # CrawlEvent インターフェース
 └── write-queue.ts             # Archive 書き込み直列化キュー
 ```
 
@@ -592,7 +596,7 @@ CrawlAggregateError
 ```
 packages/test-server/
 ├── src/
-│   ├── index.ts              # createApp(), startServer()
+│   ├── server.ts             # createApp(), startServer()
 │   ├── routes/
 │   │   ├── basic.ts          # /, /about
 │   │   ├── recursive.ts      # /recursive/**

packages/@nitpicker/analyze-axe/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/axe-plugin.js",
+			"types": "./lib/axe-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-axe/src/index.spec.ts → packages/@nitpicker/analyze-axe/src/axe-plugin.spec.ts

@@ -11,11 +11,11 @@ vi.mock('axe-core', () => ({
 }));
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./axe-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
-	const mod = await import('./index.js');
+	const mod = await import('./axe-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/analyze-lighthouse/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/lighthouse-plugin.js",
+			"types": "./lib/lighthouse-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-lighthouse/src/index.spec.ts → packages/@nitpicker/analyze-lighthouse/src/lighthouse-plugin.spec.ts

@@ -28,12 +28,12 @@ vi.mock('lighthouse/report/renderer/report-utils.js', () => ({
 }));
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./lighthouse-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
 	launchMock.mockResolvedValue({ port: 9222, kill: killMock });
-	const mod = await import('./index.js');
+	const mod = await import('./lighthouse-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/analyze-main-contents/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/main-contents-plugin.js",
+			"types": "./lib/main-contents-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-main-contents/src/index.spec.ts → packages/@nitpicker/analyze-main-contents/src/main-contents-plugin.spec.ts

@@ -6,11 +6,11 @@ vi.mock('@medv/finder', () => ({
 }));
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./main-contents-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
-	const mod = await import('./index.js');
+	const mod = await import('./main-contents-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/analyze-markuplint/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/markuplint-plugin.js",
+			"types": "./lib/markuplint-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-markuplint/src/index.spec.ts → packages/@nitpicker/analyze-markuplint/src/markuplint-plugin.spec.ts

@@ -11,11 +11,11 @@ vi.mock('markuplint', () => ({
 }));
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./markuplint-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
-	const mod = await import('./index.js');
+	const mod = await import('./markuplint-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/analyze-search/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/search-plugin.js",
+			"types": "./lib/search-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-search/src/index.spec.ts → packages/@nitpicker/analyze-search/src/search-plugin.spec.ts

@@ -2,11 +2,11 @@ import { JSDOM } from 'jsdom';
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./search-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
-	const mod = await import('./index.js');
+	const mod = await import('./search-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/analyze-textlint/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/textlint-plugin.js",
+			"types": "./lib/textlint-plugin.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/analyze-textlint/src/index.spec.ts → packages/@nitpicker/analyze-textlint/src/textlint-plugin.spec.ts

@@ -48,11 +48,11 @@ vi.mock('@textlint-ja/textlint-rule-no-synonyms', () => ({ default: {} }));
 vi.mock('textlint-plugin-html', () => ({ default: {} }));
 
 // eslint-disable-next-line @typescript-eslint/consistent-type-imports
-let pluginFactory: typeof import('./index.js').default;
+let pluginFactory: typeof import('./textlint-plugin.js').default;
 
 beforeEach(async () => {
 	vi.clearAllMocks();
-	const mod = await import('./index.js');
+	const mod = await import('./textlint-plugin.js');
 	pluginFactory = mod.default;
 });
 

packages/@nitpicker/cli/bin/nitpicker.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-import '../lib/index.js';
+import '../lib/cli.js';

packages/@nitpicker/cli/package.json

@@ -19,8 +19,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/cli.js",
+			"types": "./lib/cli.d.ts"
 		}
 	},
 	"bin": {

packages/@nitpicker/core/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/core.js",
+			"types": "./lib/core.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/core/src/index.ts → packages/@nitpicker/core/src/core.ts

@@ -1,5 +1,5 @@
 export { Nitpicker } from './nitpicker.js';
-export { definePlugin } from './hooks/index.js';
+export { definePlugin } from './hooks/define-plugin.js';
 export { readPluginLabels } from './read-plugin-labels.js';
 export { runInWorker } from './worker/run-in-worker.js';
 export * from './types.js';

packages/@nitpicker/crawler/package.json

@@ -18,8 +18,8 @@
 	"type": "module",
 	"exports": {
 		".": {
-			"import": "./lib/index.js",
-			"types": "./lib/index.d.ts"
+			"import": "./lib/crawler.js",
+			"types": "./lib/crawler.d.ts"
 		}
 	},
 	"scripts": {

packages/@nitpicker/crawler/src/archive/archive-accessor.ts

@@ -11,18 +11,15 @@ import type { ParseURLOptions } from '@d-zero/shared/parse-url';
 
 import path from 'node:path';
 
+import { extractZip, unzip } from '@d-zero/fs/zip';
 import { TypedAwaitEventEmitter as EventEmitter } from '@d-zero/shared/typed-await-event-emitter';
 
 import { log } from './debug.js';
-import {
-	exists,
-	extractZip,
-	outputJSON,
-	outputText,
-	readJSON,
-	readText,
-	unzip,
-} from './filesystem/index.js';
+import { exists } from './filesystem/exists.js';
+import { outputJSON } from './filesystem/output-json.js';
+import { outputText } from './filesystem/output-text.js';
+import { readJSON } from './filesystem/read-json.js';
+import { readText } from './filesystem/read-text.js';
 import Page from './page.js';
 import Resource from './resource.js';
 import { safePath } from './safe-path.js';

packages/@nitpicker/crawler/src/archive/archive.spec.ts

@@ -5,15 +5,15 @@ import { afterAll, describe, expect, it, vi, type MockInstance } from 'vitest';
 
 import Archive from './archive.js';
 import { Database } from './database.js';
-import { remove } from './filesystem/index.js';
+import { remove } from './filesystem/remove.js';
 
 const __filename = new URL(import.meta.url).pathname;
 const __dirname = path.dirname(__filename);
 const workingDir = path.resolve(__dirname, '__mock__');
 
-vi.mock('./filesystem/index.js', async (importOriginal) => {
+vi.mock('./filesystem/output-text.js', async (importOriginal) => {
 	// eslint-disable-next-line @typescript-eslint/consistent-type-imports
-	const original = await importOriginal<typeof import('./filesystem/index.js')>();
+	const original = await importOriginal<typeof import('./filesystem/output-text.js')>();
 	return {
 		...original,
 		outputText: vi.fn(original.outputText),
@@ -33,7 +33,7 @@ describe('setPage', () => {
 	});
 
 	it('スナップショット書き込み失敗時にDB上のHTMLパスがクリアされエラーが伝搬する', async () => {
-		const fsIndex = await import('./filesystem/index.js');
+		const fsIndex = await import('./filesystem/output-text.js');
 		const mockedOutputText = vi.mocked(fsIndex.outputText);
 		mockedOutputText.mockRejectedValueOnce(new Error('Disk write failure'));
 
@@ -86,7 +86,7 @@ describe('setPage', () => {
 	});
 
 	it('clearHtmlPath失敗時も元のスナップショットエラーが伝搬する', async () => {
-		const fsIndex = await import('./filesystem/index.js');
+		const fsIndex = await import('./filesystem/output-text.js');
 		const mockedOutputText = vi.mocked(fsIndex.outputText);
 		mockedOutputText.mockRejectedValueOnce(new Error('Disk full'));
 

packages/@nitpicker/crawler/src/archive/archive.ts

@@ -1,23 +1,22 @@
 import type { Config } from './types.js';
-import type { PageData, CrawlerError, Resource } from '../utils/index.js';
+import type { PageData, CrawlerError, Resource } from '../utils/types/types.js';
 import type { ParseURLOptions } from '@d-zero/shared/parse-url';
 
 import path from 'node:path';
 
+import { zip } from '@d-zero/fs/zip';
+
 import { ArchiveAccessor } from './archive-accessor.js';
 import { Database } from './database.js';
 import { dbLog, log, saveLog } from './debug.js';
-import {
-	appendText,
-	exists,
-	isDir,
-	outputText,
-	remove,
-	rename,
-	tar,
-	untar,
-	zip,
-} from './filesystem/index.js';
+import { appendText } from './filesystem/append-text.js';
+import { exists } from './filesystem/exists.js';
+import { isDir } from './filesystem/is-dir.js';
+import { outputText } from './filesystem/output-text.js';
+import { remove } from './filesystem/remove.js';
+import { rename } from './filesystem/rename.js';
+import { tar } from './filesystem/tar.js';
+import { untar } from './filesystem/untar.js';
 
 /**
  * Main archive class for creating, opening, resuming, and writing Nitpicker archive files (`.nitpicker`).

packages/@nitpicker/crawler/src/archive/database.spec.ts

@@ -6,7 +6,7 @@ import { tryParseUrl as parseUrl } from '@d-zero/shared/parse-url';
 import { afterAll, describe, expect, it } from 'vitest';
 
 import { Database } from './database.js';
-import { remove } from './filesystem/index.js';
+import { remove } from './filesystem/remove.js';
 
 const __filename = new URL(import.meta.url).pathname;
 const __dirname = path.dirname(__filename);

packages/@nitpicker/crawler/src/archive/database.ts

@@ -8,7 +8,7 @@ import type {
 	DatabaseEvent,
 	PageFilter,
 } from './types.js';
-import type { PageData, Resource } from '../utils/index.js';
+import type { PageData, Resource } from '../utils/types/types.js';
 import type { RetryDecoratorOptions } from '@d-zero/shared/retry';
 import type { Knex } from 'knex';
 
@@ -20,10 +20,11 @@ import { pathComparator } from '@d-zero/shared/sort/path';
 import { TypedAwaitEventEmitter as EventEmitter } from '@d-zero/shared/typed-await-event-emitter';
 import knex from 'knex';
 
-import { ErrorEmitter, eachSplitted } from '../utils/index.js';
+import { eachSplitted } from '../utils/array/each-splitted.js';
+import { ErrorEmitter } from '../utils/error/error-emitter.js';
 
 import { dbLog } from './debug.js';
-import { mkdir } from './filesystem/index.js';
+import { mkdir } from './filesystem/mkdir.js';
 
 const retrySetting: RetryDecoratorOptions = {
 	interval: 300,