@interactive-inc/docs-client 0.0.5 → 0.0.7

package/build/index.d.ts

@@ -1,42 +1,1921 @@
-export { DocClient } from "./doc-client";
-export { DocDirectoryReference } from "./doc-directory-reference";
-export { DocFileIndexReference } from "./doc-file-index-reference";
-export { DocFileMdReference } from "./doc-file-md-reference";
-export { DocFileRelationReference } from "./doc-file-relation-reference";
-export { DocFileSystem } from "./doc-file-system";
-export { DocFileTreeSystem as FileTreeSystem } from "./doc-file-tree-system";
-export { DocFileUnknownReference } from "./doc-file-unknown-reference";
-export { DocMarkdownSystem } from "./doc-markdown-system";
-export { DocPathSystem } from "./doc-path-system";
-export { DocFileIndexEntity } from "./entities/doc-file-index-entity";
-export { DocFileMdEntity } from "./entities/doc-file-md-entity";
-export { DocFileUnknownEntity } from "./entities/doc-file-unknown-entity";
-export * from "./models";
-export type * from "./types";
-export { DocContentMdValue } from "./values/doc-content-md-value";
-export { DocDirectoryPathValue } from "./values/doc-directory-path-value";
-export { DocFileContentIndexValue } from "./values/doc-file-content-index-value";
-export { DocFileContentMdValue } from "./values/doc-file-content-md-value";
-export { DocFilePathValue } from "./values/doc-file-path-value";
-export { DocFrontMatterIndexValue } from "./values/doc-front-matter-index-value";
-export { DocFrontMatterMdValue } from "./values/doc-front-matter-md-value";
-export { DocRelationFileValue } from "./values/doc-relation-file-value";
-export { DocRelationValue } from "./values/doc-relation-value";
-export { DocSchemaFieldBooleanMultipleValue } from "./values/doc-schema-field-boolean-multiple-value";
-export { DocSchemaFieldBooleanSingleValue } from "./values/doc-schema-field-boolean-single-value";
-export { DocSchemaFieldFactory } from "./values/doc-schema-field-factory";
-export { DocSchemaFieldNumberMultipleValue } from "./values/doc-schema-field-number-multiple-value";
-export { DocSchemaFieldNumberSingleValue } from "./values/doc-schema-field-number-single-value";
-export { DocSchemaFieldRelationMultipleValue } from "./values/doc-schema-field-relation-multiple-value";
-export { DocSchemaFieldRelationSingleValue } from "./values/doc-schema-field-relation-single-value";
-export { DocSchemaFieldSelectNumberMultipleValue } from "./values/doc-schema-field-select-number-multiple-value";
-export { DocSchemaFieldSelectNumberSingleValue } from "./values/doc-schema-field-select-number-single-value";
-export { DocSchemaFieldSelectTextMultipleValue } from "./values/doc-schema-field-select-text-multiple-value";
-export { DocSchemaFieldSelectTextSingleValue } from "./values/doc-schema-field-select-text-single-value";
-export { DocSchemaFieldTextMultipleValue } from "./values/doc-schema-field-text-multiple-value";
-export { DocSchemaFieldTextSingleValue } from "./values/doc-schema-field-text-single-value";
-export type { DocSchemaFieldValue } from "./values/doc-schema-field-value";
-export { DocSchemaValue } from "./values/doc-schema-value";
-export { DocTreeDirectoryNodeValue } from "./values/doc-tree-directory-node-value";
-export { DocTreeFileNodeValue } from "./values/doc-tree-file-node-value";
-//# sourceMappingURL=index.d.ts.map
+import { z } from 'zod/v4';
+import { zDocFileMd, zDocFileContentMd, zDocFileMdFrontMatter, zDocSchema, zDocSchemaFieldText, zDocSchemaField, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldMultiNumber, zDocSchemaFieldBoolean, zDocSchemaFieldMultiBoolean, zDocSchemaFieldSelectText, zDocSchemaFieldMultiSelectText, zDocSchemaFieldSelectNumber, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldRelation, zDocSchemaFieldMultiRelation, zDocRelationFile, zDocFilePath, zDocFileUnknown, zDocFileIndex, zDocFileContentIndex, zDocFileIndexFrontMatter, zDocRelation, zDocSchemaFieldType, zDocFile, zDocRelationField } from './models.js';
+export { zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } from './models.js';
+
+/**
+ * パス操作システム
+ */
+declare class DocPathSystem {
+    private readonly separator;
+    /**
+     * パスを結合
+     */
+    join(...paths: string[]): string;
+    /**
+     * ファイル名を取得（拡張子付き）
+     */
+    basename(path: string, ext?: string): string;
+    /**
+     * ディレクトリ名を取得
+     */
+    dirname(path: string): string;
+    /**
+     * 拡張子を取得
+     */
+    extname(path: string): string;
+    /**
+     * 相対パスを計算
+     */
+    relative(from: string, to: string): string;
+    /**
+     * 絶対パスに変換
+     */
+    resolve(...paths: string[]): string;
+    /**
+     * パスを正規化
+     */
+    normalize(path: string): string;
+    /**
+     * パスが絶対パスかどうか
+     */
+    isAbsolute(path: string): boolean;
+    /**
+     * パスのセパレータ
+     */
+    get sep(): string;
+}
+
+type Props$9 = {
+    basePath: string;
+    pathSystem: DocPathSystem;
+};
+/**
+ * ファイルシステム
+ */
+declare class DocFileSystem {
+    private readonly basePath;
+    private readonly pathSystem;
+    constructor(props: Props$9);
+    /**
+     * 指定されたパスのファイルの内容を読み込む
+     */
+    readFile(relativePath: string): Promise<string | null>;
+    /**
+     * 指定されたパスのファイルに内容を書き込む（必要に応じてディレクトリも作成）
+     */
+    writeFile(relativePath: string, content: string): Promise<void>;
+    /**
+     * 指定されたパスのファイルを削除
+     */
+    deleteFile(relativePath: string): Promise<Error | null>;
+    /**
+     * 指定されたパスのファイル名を取得
+     */
+    readFileName(relativePath: string): string;
+    /**
+     * 指定されたパスのファイル拡張子を取得
+     */
+    readFileExtension(relativePath: string): string;
+    /**
+     * 指定されたパスのファイルが存在するディレクトリパスを取得
+     */
+    readFileDirectory(relativePath: string): string;
+    /**
+     * ディレクトリ内のエントリ一覧を取得
+     */
+    readDirectoryFileNames(relativePath?: string): Promise<string[]>;
+    readDirectoryFilePaths(relativePath: string): Promise<string[]>;
+    /**
+     * 指定パスがディレクトリかチェック
+     */
+    isDirectory(relativePath: string): Promise<boolean>;
+    /**
+     * 指定パスがファイルかチェック
+     */
+    isFile(relativePath: string): Promise<boolean>;
+    /**
+     * ファイルまたはディレクトリが存在するかチェック
+     */
+    exists(relativePath: string): Promise<boolean>;
+    /**
+     * ディレクトリが存在するかチェック
+     */
+    directoryExists(relativePath: string): Promise<boolean>;
+    /**
+     * ファイルが存在するかチェック
+     */
+    fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * ベースパスを取得
+     */
+    getBasePath(): string;
+    /**
+     * 相対パスを絶対パスに変換
+     */
+    resolve(relativePath: string): string;
+    /**
+     * ディレクトリを作成する
+     */
+    createDirectory(relativePath: string): Promise<void>;
+    /**
+     * ファイルのサイズを取得（バイト単位）
+     */
+    getFileSize(relativePath: string): Promise<number>;
+    /**
+     * ディレクトリが存在しない場合は作成する
+     */
+    ensureDirectoryExists(relativePath: string): Promise<void>;
+    /**
+     * ファイルをコピー
+     */
+    copyFile(sourcePath: string, destinationPath: string): Promise<void>;
+    /**
+     * ファイルを移動
+     */
+    moveFile(sourcePath: string, destinationPath: string): Promise<void>;
+    /**
+     * ファイルの最終更新日時を取得
+     */
+    getFileModifiedTime(relativePath: string): Promise<Date>;
+    /**
+     * ファイルの作成日時を取得
+     */
+    getFileCreatedTime(relativePath: string): Promise<Date>;
+}
+
+/**
+ * スキーマフィールドで使用可能な型
+ */
+type FieldType = "text" | "number" | "boolean" | "multi-text" | "multi-number" | "multi-boolean" | "relation" | "multi-relation" | "select-text" | "select-number" | "multi-select-text" | "multi-select-number";
+/**
+ * 文字列フィールドの型
+ */
+type DocSchemaFieldText = z.infer<typeof zDocSchemaFieldText>;
+/**
+ * 数値フィールドの型
+ */
+type DocSchemaFieldNumber = z.infer<typeof zDocSchemaFieldNumber>;
+/**
+ * ブールフィールドの型
+ */
+type DocSchemaFieldBoolean = z.infer<typeof zDocSchemaFieldBoolean>;
+/**
+ * マルチテキストフィールドの型
+ */
+type DocFieldMultiText = z.infer<typeof zDocSchemaFieldMultiText>;
+/**
+ * マルチ数値フィールドの型
+ */
+type DocFieldMultiNumber = z.infer<typeof zDocSchemaFieldMultiNumber>;
+/**
+ * マルチブールフィールドの型
+ */
+type DocFieldMultiBoolean = z.infer<typeof zDocSchemaFieldMultiBoolean>;
+/**
+ * リレーションフィールドの型
+ */
+type DocSchemaFieldRelation = z.infer<typeof zDocSchemaFieldRelation>;
+/**
+ * マルチリレーションフィールドの型
+ */
+type DocFieldMultiRelation = z.infer<typeof zDocSchemaFieldMultiRelation>;
+/**
+ * 選択テキストフィールドの型
+ */
+type DocSchemaFieldSelectText = z.infer<typeof zDocSchemaFieldSelectText>;
+/**
+ * 選択数値フィールドの型
+ */
+type DocSchemaFieldSelectNumber = z.infer<typeof zDocSchemaFieldSelectNumber>;
+/**
+ * マルチ選択テキストフィールドの型
+ */
+type DocSchemaFieldMultiSelectText = z.infer<typeof zDocSchemaFieldMultiSelectText>;
+/**
+ * マルチ選択数値フィールドの型
+ */
+type DocSchemaFieldMultiSelectNumber = z.infer<typeof zDocSchemaFieldMultiSelectNumber>;
+type DocFileMdFrontMatter = z.infer<typeof zDocFileMdFrontMatter>;
+/**
+ * スキーマフィールドタイプの型
+ */
+type DocSchemaFieldType = z.infer<typeof zDocSchemaFieldType>;
+/**
+ * スキーマフィールドの型
+ */
+type DocSchemaField = z.infer<typeof zDocSchemaField>;
+/**
+ * スキーマ定義の型
+ */
+type DocSchemaRecord = z.infer<typeof zDocSchema>;
+/**
+ * リレーション型フィールドのUnion型
+ */
+type RelationFieldTypes = DocSchemaFieldRelation | DocFieldMultiRelation;
+/**
+ * ファイルノードの型（ファイル専用）
+ */
+type DocTreeFileNode = {
+    type: "file";
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+};
+/**
+ * ディレクトリノードの型（ディレクトリ専用）
+ */
+type DocTreeDirectoryNode = {
+    type: "directory";
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+    children: DocTreeNode[];
+};
+/**
+ * ツリーノードの統合型
+ */
+type DocTreeNode = DocTreeFileNode | DocTreeDirectoryNode;
+/**
+ * 後方互換性のためのエイリアス
+ */
+type DocFileNode = DocTreeNode;
+/**
+ * インデックスファイルの型
+ */
+type DocFileIndex = z.infer<typeof zDocFileIndex>;
+/**
+ * マークダウンファイル（index.md以外）の型
+ */
+type DocFileMd = z.infer<typeof zDocFileMd>;
+/**
+ * その他のファイル（非マークダウン）の型
+ */
+type DocFileUnknown = z.infer<typeof zDocFileUnknown>;
+/**
+ * ファイルのunion型（index.md、通常のmd、その他）
+ */
+type DocFile = z.infer<typeof zDocFile>;
+/**
+ * ディレクトリFrontMatterの型
+ */
+type DocFileIndexFrontMatter = z.infer<typeof zDocFileIndexFrontMatter>;
+/**
+ * リレーションオプションの型
+ */
+type DocRelationFile = z.infer<typeof zDocRelationFile>;
+/**
+ * リレーション情報の型
+ */
+type DocRelation = z.infer<typeof zDocRelation>;
+/**
+ * リレーションフィールドの型
+ */
+type DocRelationField = z.infer<typeof zDocRelationField>;
+/**
+ * ファイルパス情報の型
+ */
+type DocFilePath = z.infer<typeof zDocFilePath>;
+/**
+ * Markdownコンテンツ情報の型
+ */
+type DocFileContentMd = z.infer<typeof zDocFileContentMd>;
+/**
+ * Indexファイルコンテンツ情報の型
+ */
+type DocFileContentIndex = z.infer<typeof zDocFileContentIndex>;
+/**
+ * ディレクトリレスポンスの型（serverパッケージの型を再エクスポート）
+ */
+type DocDirectory = {
+    cwd: string;
+    indexFile: DocFileIndex;
+    files: DocFile[];
+    relations: DocRelation[];
+};
+
+/**
+ * リレーションファイル
+ */
+declare class DocRelationFileValue {
+    private readonly value;
+    constructor(value: DocRelationFile);
+    /**
+     * ファイルパス
+     */
+    get id(): string;
+    /**
+     * スラッグ
+     */
+    get slug(): string;
+    /**
+     * 表示用ラベル
+     */
+    get label(): string;
+    /**
+     * ファイルパスとタイトルから生成
+     */
+    static from(filePath: string, title: string | null): DocRelationFileValue;
+    /**
+     * ファイルパスからファイル名を抽出（拡張子なし）
+     */
+    private static extractFileName;
+    /**
+     * JSON形式に変換
+     */
+    toJson(): DocRelationFile;
+}
+
+/**
+ * リレーション情報を管理する
+ */
+declare class DocRelationValue {
+    readonly value: DocRelation;
+    constructor(value: DocRelation);
+    /**
+     * リレーションパス
+     */
+    get path(): string;
+    /**
+     * リレーション対象ファイル一覧（値オブジェクト）
+     */
+    get files(): DocRelationFileValue[];
+    /**
+     * ファイル数を取得
+     */
+    get fileCount(): number;
+    /**
+     * 空かどうか
+     */
+    get isEmpty(): boolean;
+    /**
+     * 空のリレーションエンティティを作成
+     */
+    static empty(path: string): DocRelationValue;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocRelation;
+}
+
+type Props$8 = {
+    filePath: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * リレーションファイルの参照
+ */
+declare class DocFileRelationReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$8);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
+    /**
+     * リレーションパス
+     */
+    get path(): string;
+    /**
+     * フルパス
+     */
+    get fullPath(): string;
+    read(): Promise<DocRelationValue | null>;
+    /**
+     * リレーションファイルの一覧を読み込む
+     */
+    readFiles(): Promise<DocRelationFileValue[]>;
+    /**
+     * 単一のリレーションファイルを読み込む
+     */
+    readFile(filePath: string): Promise<DocRelationFileValue | null>;
+    /**
+     * ファイルの存在確認
+     */
+    exists(slug: string): Promise<boolean>;
+    /**
+     * ファイル名の一覧を取得（拡張子なし）
+     */
+    readSlugs(): Promise<string[]>;
+    /**
+     * ファイル数を取得
+     */
+    count(): Promise<number>;
+    /**
+     * 空かどうかを確認
+     */
+    isEmpty(): Promise<boolean>;
+}
+
+/**
+ * リレーション複数型スキーマフィールド
+ */
+declare class DocSchemaFieldRelationMultipleValue {
+    readonly key: string;
+    readonly value: DocFieldMultiRelation;
+    constructor(key: string, value: DocFieldMultiRelation);
+    get type(): "multi-relation";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string[] | null;
+    get path(): string;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isRelation = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * 単一リレーション型スキーマフィールド
+ */
+declare class DocSchemaFieldRelationSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldRelation;
+    constructor(key: string, value: DocSchemaFieldRelation);
+    get type(): "relation";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string | null;
+    get path(): string;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isRelation = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * ブール複数型スキーマフィールド
+ */
+declare class DocSchemaFieldBooleanMultipleValue {
+    readonly key: string;
+    readonly value: DocFieldMultiBoolean;
+    constructor(key: string, value: DocFieldMultiBoolean);
+    get type(): "multi-boolean";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): boolean[] | null;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isBoolean = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * 単一ブール型スキーマフィールド
+ */
+declare class DocSchemaFieldBooleanSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldBoolean;
+    constructor(key: string, value: DocSchemaFieldBoolean);
+    get type(): "boolean";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): boolean | null;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isBoolean = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * 数値複数型スキーマフィールド
+ */
+declare class DocSchemaFieldNumberMultipleValue {
+    readonly key: string;
+    readonly value: DocFieldMultiNumber;
+    constructor(key: string, value: DocFieldMultiNumber);
+    get type(): "multi-number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number[] | null;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isNumber = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * 単一数値型スキーマフィールド
+ */
+declare class DocSchemaFieldNumberSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldNumber;
+    constructor(key: string, value: DocSchemaFieldNumber);
+    get type(): "number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number | null;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isNumber = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * 数値選択複数型スキーマフィールド
+ */
+declare class DocSchemaFieldSelectNumberMultipleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldMultiSelectNumber;
+    constructor(key: string, value: DocSchemaFieldMultiSelectNumber);
+    get type(): "multi-select-number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number[] | null;
+    get options(): number[];
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isSelect = true;
+    readonly isNumberSelect = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * 単一選択数値型スキーマフィールド
+ */
+declare class DocSchemaFieldSelectNumberSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldSelectNumber;
+    constructor(key: string, value: DocSchemaFieldSelectNumber);
+    get type(): "select-number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number | null;
+    get options(): number[];
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isSelect = true;
+    readonly isNumberSelect = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * テキスト選択複数型スキーマフィールド
+ */
+declare class DocSchemaFieldSelectTextMultipleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldMultiSelectText;
+    constructor(key: string, value: DocSchemaFieldMultiSelectText);
+    get type(): "multi-select-text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string[] | null;
+    get options(): string[];
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isSelect = true;
+    readonly isTextSelect = true;
+    /**
+     * 値を検証する
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocSchemaField;
+}
+
+/**
+ * 単一選択テキスト型スキーマフィールド
+ */
+declare class DocSchemaFieldSelectTextSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldSelectText;
+    constructor(key: string, value: DocSchemaFieldSelectText);
+    get type(): "select-text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string | null;
+    get options(): string[];
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isSelect = true;
+    readonly isTextSelect = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * テキスト複数型スキーマフィールド
+ */
+declare class DocSchemaFieldTextMultipleValue {
+    readonly key: string;
+    readonly value: DocFieldMultiText;
+    constructor(key: string, value: DocFieldMultiText);
+    get type(): "multi-text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string[] | null;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isText = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * 単一テキスト型スキーマフィールド
+ */
+declare class DocSchemaFieldTextSingleValue {
+    readonly key: string;
+    readonly value: DocSchemaFieldText;
+    constructor(key: string, value: DocSchemaFieldText);
+    get type(): "text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string | null;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isText = true;
+    toJson(): DocSchemaField;
+    /**
+     * 値の型を検証する
+     */
+    validate(value: unknown): boolean;
+}
+
+/**
+ * テキスト型フィールド
+ */
+type DocSchemaFieldTextTypes = DocSchemaFieldTextSingleValue | DocSchemaFieldTextMultipleValue;
+/**
+ * 数値型フィールド
+ */
+type DocSchemaFieldNumberTypes = DocSchemaFieldNumberSingleValue | DocSchemaFieldNumberMultipleValue;
+/**
+ * ブール型フィールド
+ */
+type DocSchemaFieldBooleanTypes = DocSchemaFieldBooleanSingleValue | DocSchemaFieldBooleanMultipleValue;
+/**
+ * 選択型フィールド
+ */
+type DocSchemaFieldSelectTypes = DocSchemaFieldSelectTextSingleValue | DocSchemaFieldSelectTextMultipleValue | DocSchemaFieldSelectNumberSingleValue | DocSchemaFieldSelectNumberMultipleValue;
+/**
+ * リレーション型フィールド
+ */
+type DocSchemaFieldRelationTypes = DocSchemaFieldRelationSingleValue | DocSchemaFieldRelationMultipleValue;
+/**
+ * スキーマフィールドの型共用体
+ */
+type DocSchemaFieldValue = DocSchemaFieldTextTypes | DocSchemaFieldNumberTypes | DocSchemaFieldBooleanTypes | DocSchemaFieldSelectTypes | DocSchemaFieldRelationTypes;
+
+/**
+ * スキーマとリレーション
+ */
+declare class DocSchemaValue {
+    readonly value: DocSchemaRecord;
+    constructor(value: DocSchemaRecord);
+    /**
+     * フィールド名の一覧を取得
+     */
+    get fieldNames(): string[];
+    /**
+     * 指定されたフィールド名のフィールドを取得
+     */
+    field(name: string): DocSchemaFieldValue | null;
+    get fields(): DocSchemaFieldValue[];
+    get relationFields(): (DocSchemaFieldRelationSingleValue | DocSchemaFieldRelationMultipleValue)[];
+    /**
+     * 空のスキーマエンティティを作成
+     */
+    static empty(): DocSchemaValue;
+    /**
+     * スキーマからリレーションパスを抽出
+     */
+    extractRelationPaths(): Set<string>;
+    /**
+     * フィールドがリレーション型かどうかを判定
+     */
+    private isRelationField;
+    /**
+     * リレーションオプションを作成
+     */
+    createRelationOption(filePath: string, title: string | null): DocRelationFile;
+    /**
+     * ファイルをスキップすべきかどうかを判定
+     */
+    shouldSkipFile(filePath: string): boolean;
+    /**
+     * 値を指定された型に変換する（デフォルト値フォールバック付き）
+     */
+    convertValue(value: unknown, targetType: string, defaultValue: unknown): unknown;
+    /**
+     * 型別の変換処理
+     */
+    private convertByType;
+    /**
+     * 文字列型への変換
+     */
+    private convertToString;
+    /**
+     * 数値型への変換
+     */
+    private convertToNumber;
+    /**
+     * ブール型への変換
+     */
+    private convertToBoolean;
+    /**
+     * 配列型への変換
+     */
+    private convertToArray;
+    /**
+     * リレーション型への変換
+     */
+    private convertToRelation;
+    /**
+     * マルチリレーション型への変換
+     */
+    private convertToMultiRelation;
+    /**
+     * パスからファイル名を抽出（拡張子除去）
+     */
+    private extractFileNameFromPath;
+    /**
+     * スキーマベースでFrontMatterを補完する
+     */
+    getCompleteFrontMatter(rawFrontMatter: unknown): DocFileMdFrontMatter;
+    /**
+     * スキーマからデフォルトFrontMatterを生成
+     */
+    private generateDefaultFrontMatter;
+    /**
+     * 既存の値を保持しながらマージ
+     */
+    private mergePreservingExistingValues;
+    /**
+     * ファイルパスからファイル名を抽出（拡張子なし）
+     */
+    private extractFileName;
+    /**
+     * nullまundefinedのチェック
+     */
+    private isNullOrUndefined;
+    toJson(): DocSchemaRecord;
+}
+
+/**
+ * FrontMatter
+ */
+declare class DocFrontMatterIndexValue {
+    readonly value: DocFileIndexFrontMatter;
+    constructor(value: DocFileIndexFrontMatter);
+    /**
+     * アイコンを取得
+     */
+    get icon(): string | null;
+    /**
+     * スキーマを取得
+     */
+    get schema(): DocSchemaValue;
+    /**
+     * iconフィールドを更新
+     */
+    withIcon(value: unknown): DocFrontMatterIndexValue;
+    /**
+     * schemaフィールドを更新
+     */
+    withSchema(value: unknown): DocFrontMatterIndexValue;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocFileIndexFrontMatter;
+    /**
+     * YAML形式で出力
+     */
+    toYaml(): string;
+    /**
+     * スキーマ全体を正規化
+     */
+    private static createSchema;
+    /**
+     * スキーマフィールドを正規化
+     */
+    private static createSchemaField;
+    /**
+     * Markdownテキストから生成（不完全なデータも処理可能）
+     */
+    static from(markdownText: string): DocFrontMatterIndexValue;
+    /**
+     * データから直接生成（不完全なデータも処理可能）
+     */
+    static fromRecord(record: Record<string, unknown>): DocFrontMatterIndexValue;
+    /**
+     * 空のFrontMatterを生成
+     */
+    static empty(): DocFrontMatterIndexValue;
+    /**
+     * アイコンを抽出
+     */
+    private static extractIcon;
+    /**
+     * スキーマを抽出
+     */
+    private static extractSchema;
+    /**
+     * デフォルトのアイコンを取得
+     */
+    private static getDefaultIcon;
+}
+
+/**
+ * Indexファイルコンテンツ情報の値オブジェクト
+ */
+declare class DocFileContentIndexValue {
+    readonly value: DocFileContentIndex;
+    constructor(value: DocFileContentIndex);
+    /**
+     * コンテンツ本文（frontMatterを含まない）
+     */
+    get body(): string;
+    /**
+     * タイトル
+     */
+    get title(): string;
+    /**
+     * 説明
+     */
+    get description(): string;
+    /**
+     * FrontMatter
+     */
+    get frontMatter(): DocFrontMatterIndexValue;
+    /**
+     * タイトルを更新
+     */
+    withTitle(title: string): DocFileContentIndexValue;
+    /**
+     * 説明を更新
+     */
+    withDescription(description: string, defaultTitle?: string): DocFileContentIndexValue;
+    /**
+     * Markdownテキストから生成
+     */
+    static fromMarkdown(markdown: string): DocFileContentIndexValue;
+    /**
+     * 完全なMarkdownテキストを生成
+     */
+    toMarkdownText(): string;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: string): DocFileContentIndexValue;
+    /**
+     * FrontMatterを更新
+     */
+    withFrontMatter(frontMatter: DocFrontMatterIndexValue): DocFileContentIndexValue;
+    /**
+     * デフォルトのindex.mdコンテンツを生成
+     */
+    static empty(directoryName: string): DocFileContentIndexValue;
+    /**
+     * FrontMatterとbodyを結合した完全なテキストを生成
+     */
+    toText(): string;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocFileContentIndex;
+}
+
+/**
+ * ドキュメントのディレクトリ
+ */
+declare class DocFileIndexEntity {
+    readonly value: DocFileIndex;
+    constructor(value: DocFileIndex);
+    /**
+     * コンテンツ
+     */
+    get content(): DocFileContentIndexValue;
+    /**
+     * パス情報
+     */
+    get path(): DocFilePath;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: DocFileContentIndexValue): DocFileIndexEntity;
+    /**
+     * パスを更新
+     */
+    withPath(path: DocFilePath): DocFileIndexEntity;
+    /**
+     * indexFileSchemaの形式に変換
+     */
+    toJson(): DocFileIndex;
+}
+
+type Props$7 = {
+    path: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * ファイルを表すクラス
+ */
+declare class DocFileIndexReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$7);
+    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>;
+}
+
+/**
+ * FrontMatter
+ */
+declare class DocFrontMatterMdValue {
+    readonly value: DocFileMdFrontMatter;
+    constructor(value: DocFileMdFrontMatter);
+    toJson(): DocFileMdFrontMatter;
+    toYaml(): string;
+    /**
+     * Markdownテキストから生成
+     */
+    static from(markdownText: string): DocFrontMatterMdValue;
+    /**
+     * 空のFrontMatterを生成
+     */
+    static empty(): DocFrontMatterMdValue;
+    /**
+     * データから直接生成
+     */
+    static fromData(data: unknown): DocFrontMatterMdValue;
+    /**
+     * スキーマフィールドに基づいてデフォルト値を生成する
+     */
+    static generateDefaultValueFromSchemaField(fieldDef: {
+        type: string;
+        default?: unknown;
+    }): unknown;
+    /**
+     * 単一のプロパティを更新した新しいインスタンスを返す
+     * スキーマに基づいて型を検証し、スキーマのフィールドのみを含む新しいインスタンスを生成
+     */
+    withProperty(key: string, value: unknown, schema: DocSchemaValue): DocFrontMatterMdValue;
+    /**
+     * フィールド値の検証
+     */
+    private validateFieldValue;
+    /**
+     * テキスト型のプロパティを取得
+     */
+    text(key: string): string | null;
+    /**
+     * 数値型のプロパティを取得
+     */
+    number(key: string): number | null;
+    /**
+     * 真偽値型のプロパティを取得
+     */
+    boolean(key: string): boolean | null;
+    /**
+     * 単一リレーション型のプロパティを取得
+     */
+    relation(key: string): string | null;
+    /**
+     * 複数リレーション型のプロパティを取得
+     */
+    multiRelation(key: string): string[];
+    /**
+     * 複数テキスト型のプロパティを取得
+     */
+    multiText(key: string): string[];
+    /**
+     * 複数数値型のプロパティを取得
+     */
+    multiNumber(key: string): number[];
+    /**
+     * 複数真偽値型のプロパティを取得
+     */
+    multiBoolean(key: string): boolean[];
+    /**
+     * プロパティが存在するかチェック
+     */
+    has(key: string): boolean;
+    /**
+     * すべてのキーを取得
+     */
+    get keys(): string[];
+}
+
+/**
+ * Markdownコンテンツ情報の値オブジェクト
+ */
+declare class DocFileContentMdValue {
+    readonly value: DocFileContentMd;
+    constructor(value: DocFileContentMd);
+    /**
+     * コンテンツ本文（frontMatterを含まない）
+     */
+    get body(): string;
+    /**
+     * タイトル
+     */
+    get title(): string;
+    /**
+     * 説明
+     */
+    get description(): string;
+    /**
+     * FrontMatter
+     */
+    get frontMatter(): DocFrontMatterMdValue;
+    /**
+     * タイトルを更新
+     */
+    withTitle(title: string): DocFileContentMdValue;
+    /**
+     * 説明を更新
+     */
+    withDescription(description: string, defaultTitle?: string): DocFileContentMdValue;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: string): DocFileContentMdValue;
+    /**
+     * FrontMatterを更新
+     */
+    withFrontMatter(frontMatter: DocFrontMatterMdValue): DocFileContentMdValue;
+    /**
+     * Markdownテキストから生成
+     */
+    static fromMarkdown(markdown: string): DocFileContentMdValue;
+    /**
+     * 完全なMarkdownテキストを生成
+     */
+    toMarkdownText(): string;
+    /**
+     * FrontMatterとbodyを結合した完全なテキストを生成
+     */
+    toText(): string;
+    /**
+     * 空のコンテンツを生成
+     */
+    static empty(title: string): DocFileContentMdValue;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocFileContentMd;
+}
+
+/**
+ * ドキュメントのファイル
+ */
+declare class DocFileMdEntity {
+    readonly value: DocFileMd;
+    constructor(value: DocFileMd);
+    /**
+     * コンテンツ
+     */
+    get content(): DocFileContentMdValue;
+    /**
+     * パス情報
+     */
+    get path(): DocFilePath;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: DocFileContentMdValue): DocFileMdEntity;
+    /**
+     * パスを更新
+     */
+    withPath(path: DocFilePath): DocFileMdEntity;
+    /**
+     * JSON形式に変換
+     */
+    toJson(): DocFileMd;
+}
+
+type Props$6 = {
+    path: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * ファイルの参照
+ */
+declare class DocFileMdReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$6);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
+    get path(): string;
+    get fullPath(): string;
+    get directoryPath(): string;
+    get archivedPath(): string;
+    get name(): string;
+    get nameWithExtension(): string;
+    directory(): DocDirectoryReference;
+    read(): Promise<Error | DocFileMdEntity>;
+    /**
+     * ファイルの内容を読み込む
+     */
+    readContent(): Promise<Error | string>;
+    /**
+     * ファイルに内容を書き込む
+     */
+    writeContent(content: string): Promise<void>;
+    /**
+     * Entityを書き込む
+     */
+    write(entity: DocFileMdEntity): Promise<void>;
+    /**
+     * 新しいファイルをデフォルトコンテンツで作成
+     */
+    writeDefault(): Promise<void>;
+    /**
+     * ファイルを削除
+     */
+    delete(): Promise<Error | null>;
+    /**
+     * ファイルが存在するか確認（アーカイブも含む）
+     */
+    exists(): Promise<boolean>;
+    /**
+     * ファイルをコピー
+     */
+    copyTo(destinationPath: string): Promise<void>;
+    /**
+     * ファイルを移動
+     */
+    moveTo(destinationPath: string): Promise<void>;
+    /**
+     * ファイルのサイズを取得（バイト単位）
+     */
+    size(): Promise<number>;
+    /**
+     * ファイルの最終更新日時を取得
+     */
+    lastModified(): Promise<Date>;
+    /**
+     * ファイルの作成日時を取得
+     */
+    createdAt(): Promise<Date>;
+    /**
+     * ファイルをアーカイブに移動し、新しい参照を返す
+     */
+    archive(archiveDirectoryName?: string): Promise<DocFileMdReference>;
+    /**
+     * ファイルをアーカイブから復元し、新しい参照を返す
+     */
+    restore(archiveDirectoryName?: string): Promise<DocFileMdReference>;
+    /**
+     * スキーマに基づいてリレーションを取得する
+     */
+    relation(key: string): Promise<DocFileMdReference | Error | null>;
+    /**
+     * 同じディレクトリのindex.mdを取得する
+     */
+    getDirectoryIndex(): Promise<DocFileMdEntity | null>;
+    /**
+     * 複数のリレーションを取得する
+     */
+    relations(key: string): Promise<DocFileMdReference[]>;
+    /**
+     * スキーマに基づいて複数のリレーションを取得する
+     */
+    multiRelation(key: string): Promise<DocFileMdReference[]>;
+}
+
+/**
+ * ドキュメントのファイル
+ */
+declare class DocFileUnknownEntity {
+    readonly value: DocFileUnknown;
+    constructor(value: DocFileUnknown);
+    /**
+     * コンテンツ
+     */
+    get content(): string;
+    /**
+     * パス情報
+     */
+    get path(): DocFilePath;
+    /**
+     * コンテンツを更新
+     */
+    withContent(content: string): DocFileUnknownEntity;
+    /**
+     * パスを更新
+     */
+    withPath(path: DocFilePath): DocFileUnknownEntity;
+    toJson(): DocFileUnknown;
+}
+
+type Props$5 = {
+    path: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * ファイルの参照
+ */
+declare class DocFileUnknownReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$5);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
+    get path(): string;
+    get directoryPath(): string;
+    get fileFullPath(): string;
+    get durectoryPath(): string;
+    directory(): DocDirectoryReference;
+    read(): Promise<Error | DocFileMdEntity | DocFileUnknownEntity>;
+    /**
+     * ファイルの内容を読み込む
+     */
+    readContent(): Promise<Error | string>;
+    /**
+     * ファイルに内容を書き込む
+     */
+    writeContent(content: string): Promise<void>;
+    /**
+     * Entityを書き込む
+     */
+    write(entity: DocFileUnknownEntity): Promise<void>;
+    /**
+     * 生のコンテンツを書き込む
+     */
+    writeRaw(content: string): Promise<void>;
+    /**
+     * ファイルを削除
+     */
+    delete(): Promise<Error | null>;
+    /**
+     * ファイルが存在するか確認
+     */
+    exists(): Promise<boolean>;
+    /**
+     * ファイルをコピー
+     */
+    copyTo(destinationPath: string): Promise<void>;
+    /**
+     * ファイルを移動
+     */
+    moveTo(destinationPath: string): Promise<void>;
+    /**
+     * ファイルのサイズを取得（バイト単位）
+     */
+    size(): Promise<number>;
+    /**
+     * ファイルの最終更新日時を取得
+     */
+    lastModified(): Promise<Date>;
+    /**
+     * ファイルの作成日時を取得
+     */
+    createdAt(): Promise<Date>;
+    /**
+     * ファイルをアーカイブに移動し、新しい参照を返す
+     */
+    archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+    /**
+     * ファイルをアーカイブから復元し、新しい参照を返す
+     */
+    restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+}
+
+type Props$4 = {
+    path: string;
+    indexFileName: string;
+    archiveDirectoryName: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * ディレクトリの参照
+ */
+declare class DocDirectoryReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$4);
+    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>;
+}
+
+type Props$3 = {
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+};
+/**
+ * ツリーファイルノード値オブジェクト
+ */
+declare class DocTreeFileNodeValue {
+    private readonly props;
+    constructor(props: Props$3);
+    get name(): string;
+    get path(): string;
+    get icon(): string;
+    get title(): string;
+    get type(): "file";
+    /**
+     * プレーンオブジェクトに変換
+     */
+    toJson(): DocTreeFileNode;
+    /**
+     * プロパティから作成
+     */
+    static from(props: Props$3): DocTreeFileNodeValue;
+    /**
+     * JSONオブジェクトから作成
+     */
+    static fromJson(json: unknown): DocTreeFileNodeValue;
+}
+
+type Props$2 = {
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+    children: (DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[];
+};
+/**
+ * ツリーディレクトリノード値オブジェクト
+ */
+declare class DocTreeDirectoryNodeValue {
+    private readonly props;
+    constructor(props: Props$2);
+    get name(): string;
+    get path(): string;
+    get icon(): string;
+    get title(): string;
+    get children(): (DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[];
+    get type(): "directory";
+    /**
+     * プレーンオブジェクトに変換
+     */
+    toJson(): DocTreeDirectoryNode;
+    /**
+     * プロパティから作成
+     */
+    static from(props: Props$2): DocTreeDirectoryNodeValue;
+    /**
+     * JSONオブジェクトから作成
+     */
+    static fromJson(json: unknown): DocTreeDirectoryNodeValue;
+}
+
+type Props$1 = {
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+    indexFileName: string;
+    archiveDirectoryName: string;
+};
+/**
+ * ファイルツリー構築システム
+ */
+declare class DocFileTreeSystem {
+    private readonly props;
+    constructor(props: Props$1);
+    /**
+     * ファイルツリーを再帰的に構築
+     */
+    buildFileTree(directoryPath?: string): Promise<(DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[]>;
+    /**
+     * ファイルノードを作成
+     */
+    private createFileNode;
+    /**
+     * ディレクトリノードを作成
+     */
+    private createDirectoryNode;
+    /**
+     * インデックスファイル参照を作成
+     */
+    private createIndexFileReference;
+    /**
+     * MDファイル参照を作成
+     */
+    private createMdFileReference;
+    /**
+     * ディレクトリツリーを再帰的に構築（ディレクトリのみ）
+     */
+    buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[]>;
+    /**
+     * ディレクトリツリー用のディレクトリノードを作成
+     */
+    private createDirectoryNodeForTree;
+}
+
+/**
+ * Markdownの解析と処理システム
+ */
+declare class DocMarkdownSystem {
+    private readonly frontMatterSeparator;
+    constructor();
+    /**
+     * FrontMatterの区切り線を検出
+     */
+    private detectFrontMatterSeparator;
+    /**
+     * FrontMatterを抽出
+     */
+    extractFrontMatter(text: string): string | null;
+    /**
+     * FrontMatterを除去したbody（titleとdescriptionを含む）
+     */
+    extractBody(text: string): string;
+    /**
+     * タイトル
+     */
+    extractTitle(text: string): string | null;
+    /**
+     * 説明（タイトルの後の最初の段落）
+     */
+    extractDescription(text: string): string | null;
+    /**
+     * body内のタイトルを更新
+     */
+    updateTitle(text: string, newTitle: string): string;
+    /**
+     * body内の説明を更新
+     */
+    updateDescription(text: string, newDescription: string, defaultTitle: string): string;
+    /**
+     * 空行をスキップ
+     */
+    private skipEmptyLines;
+    /**
+     * Markdownテキストを生成（タイトル + 説明 + body）
+     */
+    static from(title: string, description: string, body: string): string;
+}
+
+type Props = {
+    fileSystem: DocFileSystem;
+    pathSystem?: DocPathSystem;
+    markdownSystem?: DocMarkdownSystem;
+    fileTreeSystem?: DocFileTreeSystem;
+    /**
+     * default: "index.md"
+     */
+    indexFileName?: string;
+    /**
+     * default: "_"
+     */
+    archiveDirectoryName?: string;
+};
+declare class DocClient {
+    readonly fileSystem: DocFileSystem;
+    readonly pathSystem: DocPathSystem;
+    readonly markdownSystem: DocMarkdownSystem;
+    readonly fileTreeSystem: DocFileTreeSystem;
+    readonly indexFileName: string;
+    readonly archiveDirectoryName: string;
+    constructor(props: Props);
+    basePath(): string;
+    /**
+     * ファイル参照を取得
+     */
+    file(relativePath: string): DocFileMdReference | DocFileUnknownReference;
+    /**
+     * Markdownファイル参照を取得
+     */
+    mdFile(relativePath: string): DocFileMdReference;
+    /**
+     * インデックスファイル参照を取得
+     */
+    indexFile(directoryPath: string): DocFileIndexReference;
+    /**
+     * ディレクトリ参照を取得
+     */
+    directory(relativePath: string): DocDirectoryReference;
+    /**
+     * ファイルツリーを取得
+     */
+    fileTree(directoryPath?: string): Promise<(DocTreeFileNode | DocTreeDirectoryNode)[]>;
+    /**
+     * ディレクトリツリーを取得（ディレクトリのみ）
+     */
+    directoryTree(directoryPath?: string): Promise<DocTreeDirectoryNode[]>;
+}
+
+/**
+ * フロントマターの処理を担当
+ */
+declare class DocContentMdFrontMatterValue {
+    readonly data: Record<string, unknown> | null;
+    readonly yamlText: string;
+    constructor(data: Record<string, unknown> | null, yamlText?: string);
+    /**
+     * YAMLテキストからフロントマターインスタンスを作成
+     */
+    static fromYamlText(yamlText: string): DocContentMdFrontMatterValue;
+    /**
+     * Markdownテキストからフロントマターインスタンスを作成
+     */
+    static fromMarkdown(markdownText: string): DocContentMdFrontMatterValue;
+    /**
+     * 空のフロントマターインスタンスを作成
+     */
+    static empty(): DocContentMdFrontMatterValue;
+    /**
+     * フロントマターデータからインスタンスを作成
+     */
+    static fromFrontMatter(data: Record<string, unknown>): DocContentMdFrontMatterValue;
+    /**
+     * フロントマターをYAMLテキストに変換
+     */
+    frontMatterText(): string;
+    /**
+     * フロントマターを更新した新しいインスタンスを作成
+     */
+    update(draft: Record<string, unknown>): DocContentMdFrontMatterValue;
+    /**
+     * フロントマターが空かどうか
+     */
+    isEmpty(): boolean;
+    /**
+     * 指定したキーの値を取得
+     */
+    get(key: string): unknown;
+    /**
+     * 指定したキーが存在するか
+     */
+    has(key: string): boolean;
+    /**
+     * フロントマターのキー一覧を取得
+     */
+    keys(): string[];
+}
+
+/**
+ * Markdownの解析と生成
+ */
+declare class DocContentMdValue {
+    readonly text: string;
+    constructor(text: string);
+    /**
+     * Front Matter
+     */
+    get frontMatter(): DocContentMdFrontMatterValue;
+    /**
+     * body
+     */
+    get content(): string;
+    /**
+     * title
+     */
+    get title(): string;
+    /**
+     * H1の次の段落、またはH1がない場合は最初の段落をdescriptionとして取得する
+     */
+    get description(): string | null;
+    /**
+     * 新しいフロントマターとコンテンツでMarkdownインスタンスを作成
+     */
+    static fromProps(props: {
+        frontMatter: Record<string, unknown>;
+        content: string;
+    }): DocContentMdValue;
+    /**
+     * 現在のフロントマターをYAMLテキストに変換する
+     */
+    frontMatterToText(): string;
+    /**
+     * 現在のフロントマターを更新して新しいMarkdownテキストを生成
+     */
+    updateFrontMatter(draft: Record<string, unknown>): string;
+    /**
+     * 新しいフロントマターでOpenMarkdownインスタンスを作成
+     */
+    withFrontMatter(frontMatter: Record<string, unknown>): DocContentMdValue;
+    /**
+     * フロントマターを更新した新しいOpenMarkdownインスタンスを作成
+     */
+    withUpdatedFrontMatter(draft: Record<string, unknown>): DocContentMdValue;
+    /**
+     * マークダウンをtitle、description、本文の3つの部分に分離する
+     */
+    private parseContentParts;
+    /**
+     * title、description、本文からマークダウンを構築する
+     */
+    private buildContent;
+    /**
+     * H1タイトルを更新した新しいOpenMarkdownインスタンスを作成
+     */
+    withTitle(newTitle: string): DocContentMdValue;
+    /**
+     * H1の次のdescription段落を更新した新しいOpenMarkdownインスタンスを作成
+     * @param newDescription 新しいdescription
+     * @param defaultTitle H1がない場合に使用するデフォルトタイトル
+     */
+    withDescription(newDescription: string, defaultTitle?: string): DocContentMdValue;
+}
+
+/**
+ * ファイルパス情報の値オブジェクト
+ */
+declare class DocFilePathValue {
+    readonly value: DocFilePath;
+    private readonly pathSystem;
+    constructor(value: DocFilePath, pathSystem: DocPathSystem);
+    /**
+     * ファイル名（拡張子なし）
+     */
+    get name(): string;
+    /**
+     * ファイルパス（相対パス）
+     */
+    get path(): string;
+    /**
+     * ファイル名（拡張子付き）
+     */
+    get nameWithExtension(): string;
+    /**
+     * フルパス（絶対パス）
+     */
+    get fullPath(): string;
+    /**
+     * ディレクトリパス
+     */
+    get directoryPath(): string;
+    /**
+     * 拡張子
+     */
+    get extension(): string;
+    /**
+     * アーカイブされているかどうか
+     */
+    get isArchived(): boolean;
+    /**
+     * 相対パスからインスタンスを生成（DI対応）
+     */
+    static fromPathWithSystem(filePath: string, pathSystem: DocPathSystem, basePath?: string): DocFilePathValue;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocFilePath;
+}
+
+type DocDirectoryPath = {
+    path: string;
+    name: string;
+    fullPath: string;
+};
+/**
+ * ディレクトリパスを表す値オブジェクト
+ */
+declare class DocDirectoryPathValue {
+    private readonly value;
+    private readonly pathSystem;
+    constructor(value: DocDirectoryPath, pathSystem: DocPathSystem);
+    /**
+     * 相対ディレクトリパス
+     */
+    get path(): string;
+    /**
+     * ディレクトリ名
+     */
+    get name(): string;
+    /**
+     * 親ディレクトリパスを取得
+     */
+    get parent(): DocDirectoryPathValue | null;
+    /**
+     * 親ディレクトリパス
+     */
+    get parentPath(): string;
+    /**
+     * 深さ（ディレクトリの階層数）
+     */
+    get depth(): number;
+    /**
+     * パスセグメント（ディレクトリの配列）
+     */
+    get segments(): string[];
+    /**
+     * ルートからの相対パス（先頭のスラッシュなし）
+     */
+    get normalizedPath(): string;
+    /**
+     * アーカイブディレクトリかどうか（ディレクトリ名が「_」の場合）
+     */
+    get isArchived(): boolean;
+    /**
+     * 隠しディレクトリかどうか
+     */
+    get isHidden(): boolean;
+    /**
+     * ルートディレクトリかどうか
+     */
+    get isRoot(): boolean;
+    /**
+     * 絶対パス
+     */
+    get fullPath(): string;
+    /**
+     * インデックスファイルのパスを取得
+     */
+    get indexFile(): DocFilePathValue;
+    /**
+     * ファイルパスを作成
+     */
+    file(fileName: string): DocFilePathValue;
+    /**
+     * サブディレクトリのパスを作成
+     */
+    subdirectory(dirName: string): DocDirectoryPathValue;
+    /**
+     * 相対パスからインスタンスを生成（DI対応）
+     */
+    static fromPathWithSystem(dirPath: string, basePath: string, pathSystem: DocPathSystem): DocDirectoryPathValue;
+    /**
+     * JSON形式で出力
+     */
+    toJson(): DocDirectoryPath;
+    /**
+     * パスが等しいかどうか
+     */
+    equals(other: DocDirectoryPathValue): boolean;
+    /**
+     * 指定されたディレクトリがこのディレクトリの子孫かどうか
+     */
+    contains(other: DocDirectoryPathValue): boolean;
+}
+
+/**
+ * スキーマフィールドファクトリ
+ */
+declare class DocSchemaFieldFactory {
+    constructor();
+    /**
+     * スキーマエントリから適切な型のフィールドを生成
+     */
+    fromSchemaEntry(key: string, field: DocSchemaField): DocSchemaFieldValue;
+    /**
+     * 未検証のデータから正規化して生成
+     */
+    fromUnknown(key: string, data: unknown): DocSchemaFieldValue;
+    /**
+     * フィールド定義を正規化
+     */
+    private normalizeField;
+    /**
+     * デフォルトのテキストフィールドを作成
+     */
+    private createDefaultTextField;
+    /**
+     * 型名を正規化
+     */
+    private normalizeType;
+    /**
+     * オブジェクトからプロパティを安全に取得
+     */
+    private getFieldProperty;
+    /**
+     * 型固有のデフォルト値を取得（イミュータブル）
+     */
+    private getTypeSpecificDefaults;
+}
+
+export { DocClient, DocContentMdValue, type DocDirectory, DocDirectoryPathValue, DocDirectoryReference, type DocFieldMultiBoolean, type DocFieldMultiNumber, type DocFieldMultiRelation, type DocFieldMultiText, type DocFile, type DocFileContentIndex, DocFileContentIndexValue, type DocFileContentMd, DocFileContentMdValue, type DocFileIndex, DocFileIndexEntity, type DocFileIndexFrontMatter, DocFileIndexReference, type DocFileMd, DocFileMdEntity, type DocFileMdFrontMatter, DocFileMdReference, type DocFileNode, type DocFilePath, DocFilePathValue, DocFileRelationReference, DocFileSystem, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocFrontMatterIndexValue, DocFrontMatterMdValue, DocMarkdownSystem, DocPathSystem, type DocRelation, type DocRelationField, type DocRelationFile, DocRelationFileValue, DocRelationValue, type DocSchemaField, type DocSchemaFieldBoolean, DocSchemaFieldBooleanMultipleValue, DocSchemaFieldBooleanSingleValue, DocSchemaFieldFactory, type DocSchemaFieldMultiSelectNumber, type DocSchemaFieldMultiSelectText, type DocSchemaFieldNumber, DocSchemaFieldNumberMultipleValue, DocSchemaFieldNumberSingleValue, type DocSchemaFieldRelation, DocSchemaFieldRelationMultipleValue, DocSchemaFieldRelationSingleValue, type DocSchemaFieldSelectNumber, DocSchemaFieldSelectNumberMultipleValue, DocSchemaFieldSelectNumberSingleValue, type DocSchemaFieldSelectText, DocSchemaFieldSelectTextMultipleValue, DocSchemaFieldSelectTextSingleValue, type DocSchemaFieldText, DocSchemaFieldTextMultipleValue, DocSchemaFieldTextSingleValue, type DocSchemaFieldType, type DocSchemaFieldValue, type DocSchemaRecord, DocSchemaValue, type DocTreeDirectoryNode, DocTreeDirectoryNodeValue, type DocTreeFileNode, DocTreeFileNodeValue, type DocTreeNode, type FieldType, DocFileTreeSystem as FileTreeSystem, type RelationFieldTypes, zDocFile, zDocFileContentIndex, zDocFileContentMd, zDocFileIndex, zDocFileIndexFrontMatter, zDocFileMd, zDocFileMdFrontMatter, zDocFilePath, zDocFileUnknown, zDocRelation, zDocRelationField, zDocRelationFile, zDocSchema, zDocSchemaField, zDocSchemaFieldBoolean, zDocSchemaFieldMultiBoolean, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldRelation, zDocSchemaFieldSelectNumber, zDocSchemaFieldSelectText, zDocSchemaFieldText, zDocSchemaFieldType };