@interactive-inc/docs-client 0.0.5 → 0.0.7

package/build/doc-client.js

@@ -1,95 +0,0 @@
-import { DocDirectoryReference } from "./doc-directory-reference";
-import { DocFileIndexReference } from "./doc-file-index-reference";
-import { DocFileMdReference } from "./doc-file-md-reference";
-import { DocFileTreeSystem } from "./doc-file-tree-system";
-import { DocFileUnknownReference } from "./doc-file-unknown-reference";
-import { DocMarkdownSystem } from "./doc-markdown-system";
-import { DocPathSystem } from "./doc-path-system";
-export class DocClient {
-    fileSystem;
-    pathSystem;
-    markdownSystem;
-    fileTreeSystem;
-    indexFileName;
-    archiveDirectoryName;
-    constructor(props) {
-        this.fileSystem = props.fileSystem;
-        this.pathSystem = props.pathSystem ?? new DocPathSystem();
-        this.markdownSystem = props.markdownSystem ?? new DocMarkdownSystem();
-        this.indexFileName = props.indexFileName ?? "index.md";
-        this.archiveDirectoryName = props.archiveDirectoryName ?? "_";
-        this.fileTreeSystem =
-            props.fileTreeSystem ??
-                new DocFileTreeSystem({
-                    fileSystem: this.fileSystem,
-                    pathSystem: this.pathSystem,
-                    indexFileName: this.indexFileName,
-                    archiveDirectoryName: this.archiveDirectoryName,
-                });
-    }
-    basePath() {
-        return this.fileSystem.getBasePath();
-    }
-    /**
-     * ファイル参照を取得
-     */
-    file(relativePath) {
-        if (relativePath.endsWith(".md")) {
-            return this.mdFile(relativePath);
-        }
-        return new DocFileUnknownReference({
-            path: relativePath,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    /**
-     * Markdownファイル参照を取得
-     */
-    mdFile(relativePath) {
-        return new DocFileMdReference({
-            path: relativePath,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    /**
-     * インデックスファイル参照を取得
-     */
-    indexFile(directoryPath) {
-        const indexPath = directoryPath === ""
-            ? this.indexFileName
-            : `${directoryPath}/${this.indexFileName}`;
-        return new DocFileIndexReference({
-            path: indexPath,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    /**
-     * ディレクトリ参照を取得
-     */
-    directory(relativePath) {
-        return new DocDirectoryReference({
-            path: relativePath,
-            indexFileName: this.indexFileName,
-            archiveDirectoryName: this.archiveDirectoryName,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    /**
-     * ファイルツリーを取得
-     */
-    async fileTree(directoryPath = "") {
-        const results = await this.fileTreeSystem.buildFileTree(directoryPath);
-        return results.map((node) => node.toJson());
-    }
-    /**
-     * ディレクトリツリーを取得（ディレクトリのみ）
-     */
-    async directoryTree(directoryPath = "") {
-        const results = await this.fileTreeSystem.buildDirectoryTree(directoryPath);
-        return results.map((node) => node.toJson());
-    }
-}

package/build/doc-client.test.d.ts

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

package/build/doc-client.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-client.test.d.ts","sourceRoot":"","sources":["../lib/doc-client.test.ts"],"names":[],"mappings":""}

package/build/doc-client.test.js

@@ -1,38 +0,0 @@
-import { expect, test } from "bun:test";
-import { DocClient } from "./doc-client";
-import { DocFileSystem } from "./doc-file-system";
-import { DocMarkdownSystem } from "./doc-markdown-system";
-import { DocPathSystem } from "./doc-path-system";
-test("DocClient - デフォルト値でインスタンスを作成", () => {
-    const pathSystem = new DocPathSystem();
-    const fileSystem = new DocFileSystem({ basePath: "/test", pathSystem });
-    const client = new DocClient({ fileSystem });
-    expect(client.fileSystem).toBe(fileSystem);
-    expect(client.pathSystem).toBeInstanceOf(DocPathSystem);
-    expect(client.markdownSystem).toBeInstanceOf(DocMarkdownSystem);
-    expect(client.indexFileName).toBe("index.md");
-    expect(client.archiveDirectoryName).toBe("_");
-});
-test("DocClient - カスタム値でインスタンスを作成", () => {
-    const pathSystem = new DocPathSystem();
-    const fileSystem = new DocFileSystem({ basePath: "/test", pathSystem });
-    const markdownSystem = new DocMarkdownSystem();
-    const client = new DocClient({
-        fileSystem,
-        pathSystem,
-        markdownSystem,
-        indexFileName: "README.md",
-        archiveDirectoryName: ".archive",
-    });
-    expect(client.fileSystem).toBe(fileSystem);
-    expect(client.pathSystem).toBe(pathSystem);
-    expect(client.markdownSystem).toBe(markdownSystem);
-    expect(client.indexFileName).toBe("README.md");
-    expect(client.archiveDirectoryName).toBe(".archive");
-});
-test("DocClient - basePathを取得", () => {
-    const pathSystem = new DocPathSystem();
-    const fileSystem = new DocFileSystem({ basePath: "/test/docs", pathSystem });
-    const client = new DocClient({ fileSystem });
-    expect(client.basePath()).toBe("/test/docs");
-});

package/build/doc-directory-reference.d.ts

@@ -1,65 +0,0 @@
-import { DocFileIndexReference } from "./doc-file-index-reference";
-import { DocFileMdReference } from "./doc-file-md-reference";
-import type { DocFileSystem } from "./doc-file-system";
-import { DocFileUnknownReference } from "./doc-file-unknown-reference";
-import type { DocPathSystem } from "./doc-path-system";
-import { DocFileIndexEntity } from "./entities/doc-file-index-entity";
-import { DocFileMdEntity } from "./entities/doc-file-md-entity";
-import { DocFileUnknownEntity } from "./entities/doc-file-unknown-entity";
-type Props = {
-    path: string;
-    indexFileName: string;
-    archiveDirectoryName: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-};
-/**
- * ディレクトリの参照
- */
-export declare class DocDirectoryReference {
-    private readonly props;
-    private readonly pathSystem;
-    constructor(props: Props);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    get relativePath(): string;
-    get absolutePath(): string;
-    get indexFileName(): string;
-    get indexFilePath(): string;
-    get archiveDirectoryName(): string;
-    fileNames(): Promise<string[]>;
-    archivedFileNames(): Promise<string[]>;
-    filesGenerator(): AsyncGenerator<DocFileMdReference | DocFileUnknownReference, void, unknown>;
-    mdFilesGenerator(): AsyncGenerator<DocFileMdReference, void, unknown>;
-    files(): Promise<(DocFileMdReference | DocFileUnknownReference)[]>;
-    mdFiles(): Promise<DocFileMdReference[]>;
-    file(fileName: string): DocFileMdReference | DocFileUnknownReference;
-    mdFile(fileName: string): DocFileMdReference;
-    readFiles(): Promise<(DocFileMdEntity | DocFileUnknownEntity)[]>;
-    readMdFiles(): Promise<DocFileMdEntity[]>;
-    readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
-    /**
-     * サブディレクトリ名の一覧を取得
-     */
-    directoryNames(): Promise<string[]>;
-    /**
-     * サブディレクトリの参照を取得
-     */
-    directories(): Promise<DocDirectoryReference[]>;
-    /**
-     * 単一のサブディレクトリ参照を取得
-     */
-    directory(directoryName: string): DocDirectoryReference;
-    indexFile(): DocFileIndexReference;
-    readIndexFile(): Promise<DocFileIndexEntity>;
-    writeFile(entity: DocFileIndexEntity | DocFileUnknownEntity | DocFileMdEntity): Promise<Error | null>;
-    exists(): Promise<boolean>;
-    private generateUniqueFileName;
-    private fileExists;
-    /**
-     * 新しいMarkdownファイルを作成する
-     */
-    createMdFile(fileName?: string): Promise<DocFileMdReference>;
-}
-export {};
-//# sourceMappingURL=doc-directory-reference.d.ts.map

package/build/doc-directory-reference.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-directory-reference.d.ts","sourceRoot":"","sources":["../lib/doc-directory-reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAA;AAEzE,KAAK,KAAK,GAAG;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IACrB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,UAAU,EAAE,aAAa,CAAA;IACzB,UAAU,EAAE,aAAa,CAAA;CAC1B,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAGpB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFlC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAE1C,YAA6B,KAAK,EAAE,KAAK,EAGxC;IAED,IAAI,UAAU,IAAI,aAAa,CAE9B;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,aAAa,IAAI,MAAM,CAM1B;IAED,IAAI,oBAAoB,IAAI,MAAM,CAEjC;IAEK,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnC;IAEK,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW3C;IAEM,cAAc,IAAI,cAAc,CACrC,kBAAkB,GAAG,uBAAuB,EAC5C,IAAI,EACJ,OAAO,CACR,CA+CA;IAEM,gBAAgB,IAAI,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,CAQ3E;IAEK,KAAK,IAAI,OAAO,CAAC,CAAC,kBAAkB,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAQvE;IAEK,OAAO,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAS7C;IAED,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,uBAAuB,CAgBnE;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAM3C;IAEK,SAAS,IAAI,OAAO,CAAC,CAAC,eAAe,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAUrE;IAEK,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAW9C;IAEK,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAWxD;IAED;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBxC;IAED;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAcpD;IAED;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,qBAAqB,CAUtD;IAED,SAAS,IAAI,qBAAqB,CAMjC;IAEK,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAIjD;IAEK,SAAS,CACb,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,eAAe,GAClE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAuBvB;IAEK,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/B;YAKa,sBAAsB;YAmBtB,UAAU;IAKxB;;OAEG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqBjE;CACF"}

package/build/doc-directory-reference.js

@@ -1,292 +0,0 @@
-import { DocFileIndexReference } from "./doc-file-index-reference";
-import { DocFileMdReference } from "./doc-file-md-reference";
-import { DocFileUnknownReference } from "./doc-file-unknown-reference";
-import { DocFileIndexEntity } from "./entities/doc-file-index-entity";
-import { DocFileMdEntity } from "./entities/doc-file-md-entity";
-import { DocFileUnknownEntity } from "./entities/doc-file-unknown-entity";
-/**
- * ディレクトリの参照
- */
-export class DocDirectoryReference {
-    props;
-    pathSystem;
-    constructor(props) {
-        this.props = props;
-        this.pathSystem = props.pathSystem;
-        Object.freeze(this);
-    }
-    get fileSystem() {
-        return this.props.fileSystem;
-    }
-    get basePath() {
-        return this.fileSystem.getBasePath();
-    }
-    get relativePath() {
-        return this.props.path;
-    }
-    get absolutePath() {
-        return this.pathSystem.join(this.basePath, this.relativePath);
-    }
-    get indexFileName() {
-        return this.props.indexFileName;
-    }
-    get indexFilePath() {
-        return this.pathSystem.join(this.basePath, this.relativePath, this.props.indexFileName);
-    }
-    get archiveDirectoryName() {
-        return this.props.archiveDirectoryName;
-    }
-    async fileNames() {
-        const filePaths = await this.fileSystem.readDirectoryFilePaths(this.relativePath);
-        return filePaths
-            .map((p) => this.pathSystem.basename(p))
-            .filter((name) => name.includes("."));
-    }
-    async archivedFileNames() {
-        const archivePath = this.pathSystem.join(this.relativePath, this.archiveDirectoryName);
-        const filePaths = await this.fileSystem.readDirectoryFilePaths(archivePath);
-        return filePaths
-            .map((p) => this.pathSystem.basename(p))
-            .filter((name) => name.includes("."));
-    }
-    async *filesGenerator() {
-        const fileNames = await this.fileNames();
-        // 通常のファイルを処理
-        for (const fileName of fileNames) {
-            if (fileName === "index.md")
-                continue;
-            if (fileName.endsWith(".md")) {
-                yield new DocFileMdReference({
-                    path: this.pathSystem.join(this.relativePath, fileName),
-                    fileSystem: this.fileSystem,
-                    pathSystem: this.pathSystem,
-                });
-                continue;
-            }
-            yield new DocFileUnknownReference({
-                path: this.pathSystem.join(this.relativePath, fileName),
-                fileSystem: this.fileSystem,
-                pathSystem: this.pathSystem,
-            });
-        }
-        // アーカイブされたファイルを処理
-        const archivedFileNames = await this.archivedFileNames();
-        for (const fileName of archivedFileNames) {
-            if (fileName === "index.md")
-                continue;
-            if (fileName.endsWith(".md")) {
-                yield new DocFileMdReference({
-                    path: this.pathSystem.join(this.relativePath, this.archiveDirectoryName, fileName),
-                    fileSystem: this.fileSystem,
-                    pathSystem: this.pathSystem,
-                });
-                continue;
-            }
-            yield new DocFileUnknownReference({
-                path: this.pathSystem.join(this.relativePath, this.archiveDirectoryName, fileName),
-                fileSystem: this.fileSystem,
-                pathSystem: this.pathSystem,
-            });
-        }
-    }
-    async *mdFilesGenerator() {
-        const files = this.filesGenerator();
-        for await (const file of files) {
-            if (file instanceof DocFileMdReference) {
-                yield file;
-            }
-        }
-    }
-    async files() {
-        const files = [];
-        for await (const file of this.filesGenerator()) {
-            files.push(file);
-        }
-        return files;
-    }
-    async mdFiles() {
-        const files = [];
-        for await (const file of this.filesGenerator()) {
-            if (file instanceof DocFileUnknownReference)
-                continue;
-            files.push(file);
-        }
-        return files;
-    }
-    file(fileName) {
-        const filePath = this.pathSystem.join(this.relativePath, fileName);
-        if (fileName.endsWith(".md")) {
-            return new DocFileMdReference({
-                path: filePath,
-                fileSystem: this.fileSystem,
-                pathSystem: this.pathSystem,
-            });
-        }
-        return new DocFileUnknownReference({
-            path: filePath,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    mdFile(fileName) {
-        return new DocFileMdReference({
-            path: this.pathSystem.join(this.relativePath, fileName),
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    async readFiles() {
-        const entities = [];
-        for await (const file of this.filesGenerator()) {
-            const entity = await file.read();
-            if (entity instanceof Error)
-                continue;
-            entities.push(entity);
-        }
-        return entities;
-    }
-    async readMdFiles() {
-        const entities = [];
-        for await (const file of this.filesGenerator()) {
-            const entity = await file.read();
-            if (entity instanceof Error)
-                continue;
-            if (entity instanceof DocFileUnknownEntity)
-                continue;
-            entities.push(entity);
-        }
-        return entities;
-    }
-    async readUnknownFiles() {
-        const entities = [];
-        for await (const file of this.filesGenerator()) {
-            const entity = await file.read();
-            if (entity instanceof Error)
-                continue;
-            if (entity instanceof DocFileMdEntity)
-                continue;
-            entities.push(entity);
-        }
-        return entities;
-    }
-    /**
-     * サブディレクトリ名の一覧を取得
-     */
-    async directoryNames() {
-        const allFileNames = await this.fileSystem.readDirectoryFileNames(this.relativePath);
-        const directoryNames = [];
-        for (const fileName of allFileNames) {
-            // アーカイブディレクトリは除外
-            if (fileName.startsWith(this.archiveDirectoryName))
-                continue;
-            const filePath = this.pathSystem.join(this.relativePath, fileName);
-            const isDirectory = await this.fileSystem.isDirectory(filePath);
-            if (isDirectory) {
-                directoryNames.push(fileName);
-            }
-        }
-        return directoryNames;
-    }
-    /**
-     * サブディレクトリの参照を取得
-     */
-    async directories() {
-        const directoryNames = await this.directoryNames();
-        return directoryNames.map((dirName) => {
-            const dirPath = this.pathSystem.join(this.relativePath, dirName);
-            return new DocDirectoryReference({
-                path: dirPath,
-                indexFileName: this.indexFileName,
-                archiveDirectoryName: this.archiveDirectoryName,
-                fileSystem: this.fileSystem,
-                pathSystem: this.pathSystem,
-            });
-        });
-    }
-    /**
-     * 単一のサブディレクトリ参照を取得
-     */
-    directory(directoryName) {
-        const dirPath = this.pathSystem.join(this.relativePath, directoryName);
-        return new DocDirectoryReference({
-            path: dirPath,
-            indexFileName: this.indexFileName,
-            archiveDirectoryName: this.archiveDirectoryName,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    indexFile() {
-        return new DocFileIndexReference({
-            path: this.pathSystem.join(this.relativePath, this.indexFileName),
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-    }
-    async readIndexFile() {
-        const ref = this.indexFile();
-        return ref.read();
-    }
-    async writeFile(entity) {
-        const filePath = this.pathSystem.join(this.relativePath, entity.value.path.nameWithExtension);
-        let content = null;
-        if (entity instanceof DocFileUnknownEntity) {
-            content = entity.value.content;
-        }
-        if (entity instanceof DocFileIndexEntity) {
-            content = entity.content.toText();
-        }
-        if (entity instanceof DocFileMdEntity) {
-            content = entity.content.toText();
-        }
-        if (content === null) {
-            return new Error("Entity content is undefined");
-        }
-        await this.fileSystem.writeFile(filePath, content);
-        return null;
-    }
-    async exists() {
-        return await this.fileSystem.exists(this.relativePath);
-    }
-    /**
-     * 一意なファイル名を生成する
-     */
-    async generateUniqueFileName(prefix = "document") {
-        const now = new Date();
-        const timestamp = now.toISOString().slice(0, 19).replace(/[:-]/g, "");
-        let counter = 0;
-        let fileName;
-        do {
-            const suffix = counter > 0 ? `-${counter}` : "";
-            fileName = `${prefix}-${timestamp}${suffix}.md`;
-            counter++;
-        } while (await this.fileExists(fileName));
-        return fileName;
-    }
-    /**
-     * 指定されたファイル名のファイルが存在するかチェック
-     */
-    async fileExists(fileName) {
-        const filePath = this.pathSystem.join(this.relativePath, fileName);
-        return await this.fileSystem.exists(filePath);
-    }
-    /**
-     * 新しいMarkdownファイルを作成する
-     */
-    async createMdFile(fileName) {
-        const actualFileName = fileName || (await this.generateUniqueFileName("document"));
-        // .mdが付いていない場合は追加
-        const mdFileName = actualFileName.endsWith(".md")
-            ? actualFileName
-            : `${actualFileName}.md`;
-        const filePath = this.pathSystem.join(this.relativePath, mdFileName);
-        const fileRef = new DocFileMdReference({
-            path: filePath,
-            fileSystem: this.fileSystem,
-            pathSystem: this.pathSystem,
-        });
-        // デフォルトコンテンツでファイルを作成
-        await fileRef.writeDefault();
-        return fileRef;
-    }
-}

package/build/doc-directory-reference.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=doc-directory-reference.test.d.ts.map

package/build/doc-directory-reference.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc-directory-reference.test.d.ts","sourceRoot":"","sources":["../lib/doc-directory-reference.test.ts"],"names":[],"mappings":""}

package/build/doc-directory-reference.test.js

@@ -1,100 +0,0 @@
-import { expect, test } from "bun:test";
-import { DocDirectoryReference } from "./doc-directory-reference";
-import { DocPathSystem } from "./doc-path-system";
-test("DocDirectoryReference - directoryNames メソッドでサブディレクトリ名を取得できる", async () => {
-    const mockFileSystem = {
-        getBasePath: () => "/test",
-        readDirectoryFileNames: async (path) => {
-            if (path === "docs") {
-                return ["file1.md", "subdir1", "subdir2", "_archive", "file2.txt"];
-            }
-            return [];
-        },
-        isDirectory: async (path) => {
-            return ["docs/subdir1", "docs/subdir2", "docs/_archive"].includes(path);
-        },
-    };
-    const pathSystem = new DocPathSystem();
-    const dirRef = new DocDirectoryReference({
-        path: "docs",
-        indexFileName: "index.md",
-        archiveDirectoryName: "_",
-        fileSystem: mockFileSystem,
-        pathSystem,
-    });
-    const dirNames = await dirRef.directoryNames();
-    expect(dirNames.length).toBe(2); // _archiveは除外
-    expect(dirNames).toContain("subdir1");
-    expect(dirNames).toContain("subdir2");
-    expect(dirNames).not.toContain("_archive");
-    expect(dirNames).not.toContain("file1.md");
-    expect(dirNames).not.toContain("file2.txt");
-});
-test("DocDirectoryReference - directories メソッドでサブディレクトリ参照を取得できる", async () => {
-    const mockFileSystem = {
-        getBasePath: () => "/test",
-        readDirectoryFileNames: async (path) => {
-            if (path === "docs") {
-                return ["subdir1", "subdir2", "_archive"];
-            }
-            return [];
-        },
-        isDirectory: async (path) => {
-            return ["docs/subdir1", "docs/subdir2", "docs/_archive"].includes(path);
-        },
-    };
-    const pathSystem = new DocPathSystem();
-    const dirRef = new DocDirectoryReference({
-        path: "docs",
-        indexFileName: "index.md",
-        archiveDirectoryName: "_",
-        fileSystem: mockFileSystem,
-        pathSystem,
-    });
-    const directories = await dirRef.directories();
-    expect(directories.length).toBe(2); // _archiveは除外
-    expect(directories[0]).toBeInstanceOf(DocDirectoryReference);
-    expect(directories[0].relativePath).toBe("docs/subdir1");
-    expect(directories[1].relativePath).toBe("docs/subdir2");
-});
-test("DocDirectoryReference - 空のディレクトリでも正常に動作する", async () => {
-    const mockFileSystem = {
-        getBasePath: () => "/test",
-        readDirectoryFileNames: async (_path) => {
-            return []; // 空のディレクトリ
-        },
-        isDirectory: async (_path) => {
-            return false;
-        },
-    };
-    const pathSystem = new DocPathSystem();
-    const dirRef = new DocDirectoryReference({
-        path: "empty",
-        indexFileName: "index.md",
-        archiveDirectoryName: "_",
-        fileSystem: mockFileSystem,
-        pathSystem,
-    });
-    const dirNames = await dirRef.directoryNames();
-    const directories = await dirRef.directories();
-    expect(dirNames.length).toBe(0);
-    expect(directories.length).toBe(0);
-});
-test("DocDirectoryReference - directory メソッドで単一のサブディレクトリ参照を取得できる", () => {
-    const mockFileSystem = {
-        getBasePath: () => "/test",
-    };
-    const pathSystem = new DocPathSystem();
-    const dirRef = new DocDirectoryReference({
-        path: "docs",
-        indexFileName: "index.md",
-        archiveDirectoryName: "_",
-        fileSystem: mockFileSystem,
-        pathSystem,
-    });
-    const subdir = dirRef.directory("guides");
-    expect(subdir).toBeInstanceOf(DocDirectoryReference);
-    expect(subdir.relativePath).toBe("docs/guides");
-    expect(subdir.indexFileName).toBe("index.md");
-    expect(subdir.archiveDirectoryName).toBe("_");
-});

package/build/doc-file-index-reference.d.ts

@@ -1,72 +0,0 @@
-import { DocFileRelationReference } from "./doc-file-relation-reference";
-import type { DocFileSystem } from "./doc-file-system";
-import type { DocPathSystem } from "./doc-path-system";
-import { DocFileIndexEntity } from "./entities/doc-file-index-entity";
-import type { DocRelationValue } from "./values/doc-relation-value";
-type Props = {
-    path: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-};
-/**
- * ファイルを表すクラス
- */
-export declare class DocFileIndexReference {
-    private readonly props;
-    private readonly pathSystem;
-    constructor(props: Props);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    get filePath(): string;
-    get fileFullPath(): string;
-    get durectoryPath(): string;
-    read(): Promise<DocFileIndexEntity>;
-    /**
-     * ファイルの内容を読み込む
-     */
-    readContent(): Promise<Error | string>;
-    /**
-     * ファイルに内容を書き込む
-     */
-    writeContent(content: string): Promise<void>;
-    /**
-     * Entityを書き込む
-     */
-    write(entity: DocFileIndexEntity): Promise<void>;
-    /**
-     * 新しいファイルをデフォルトコンテンツで作成
-     */
-    writeDefault(): Promise<void>;
-    /**
-     * ファイルを削除
-     */
-    delete(): Promise<Error | null>;
-    /**
-     * ファイルが存在するか確認
-     */
-    exists(): Promise<boolean>;
-    relations(): Promise<DocFileRelationReference[]>;
-    readRelations(): Promise<DocRelationValue[]>;
-    /**
-     * ファイルのサイズを取得（バイト単位）
-     */
-    size(): Promise<number>;
-    /**
-     * ファイルの最終更新日時を取得
-     */
-    lastModified(): Promise<Date>;
-    /**
-     * ファイルの作成日時を取得
-     */
-    createdAt(): Promise<Date>;
-    /**
-     * ファイルをアーカイブに移動し、新しい参照を返す
-     */
-    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference>;
-    /**
-     * ファイルをアーカイブから復元し、新しい参照を返す
-     */
-    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference>;
-}
-export {};
-//# sourceMappingURL=doc-file-index-reference.d.ts.map