@interactive-inc/docs-client 0.0.10 → 0.0.13

package/build/index.d.ts

@@ -1,561 +1,300 @@
 import { z } from 'zod';
-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, zDocSchemaFieldMinimal, zDocSchemaMinimal, zDocFile, zDocRelationField } from './models.js';
-export { zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } from './models.js';
+import { zDocClientConfig, zDocCustomSchemaField, zDocFilePath, zDocMetaFieldRelation, zDocMetaFieldMultiRelation, zDocMetaFieldText, zDocMetaFieldNumber, zDocMetaFieldBoolean, zDocMetaFieldMultiText, zDocMetaFieldMultiNumber, zDocMetaFieldMultiBoolean, zDocFileUnknown, zDocFileIndexSchemaField, zDocSchemaFieldText, zDocSchemaFieldNumber, zDocSchemaFieldBoolean, zDocSchemaFieldRelation, zDocSchemaFieldSelectText, zDocSchemaFieldSelectNumber, zDocSchemaFieldMultiText, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiSelectNumber, zDocRelation, zDocRelationFile, zDocMetaField, zDocMetaFieldSelectText, zDocMetaFieldSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiSelectNumber, zDocMetaFieldTypeText, zDocMetaFieldTypeNumber, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeRelation, zDocMetaFieldType, zDocCustomSchemaFieldText, zDocCustomSchemaFieldNumber, zDocCustomSchemaFieldBoolean, zDocCustomSchemaFieldRelation, zDocCustomSchemaFieldSelectText, zDocCustomSchemaFieldSelectNumber, zDocCustomSchemaFieldMultiText, zDocCustomSchemaFieldMultiNumber, zDocCustomSchemaFieldMultiRelation, zDocCustomSchemaFieldMultiSelectText, zDocCustomSchemaFieldMultiSelectNumber, zDocRelationField } from './models.js';
+export { zDocCustomSchema, zDocFile, zDocFileIndex, zDocFileIndexContent, zDocFileIndexMeta, zDocFileIndexMetaInput, zDocFileIndexSchema, zDocFileIndexSchemaInput, zDocFileMd, zDocFileMdContent, zDocFileMdContentInput, zDocFileMdInput, zDocFileMdMeta, zDocFileMdMetaInput, zDocMetaFieldTypeMultiNumber, zDocMetaFieldTypeMultiRelation, zDocMetaFieldTypeMultiSelectNumber, zDocMetaFieldTypeMultiSelectText, zDocMetaFieldTypeMultiText, zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } from './models.js';
 
 /**
- * パス操作システム
+ * Path operations system
  */
 declare class DocPathSystem {
-    private readonly separator;
+    readonly separator = "/";
     /**
-     * パスを結合
+     * Join paths
      */
     join(...paths: string[]): string;
     /**
-     * ファイル名を取得（拡張子付き）
+     * Get filename with extension
      */
     basename(path: string, ext?: string): string;
     /**
-     * ディレクトリ名を取得
+     * Get directory name
      */
     dirname(path: string): string;
     /**
-     * 拡張子を取得
+     * Get extension
      */
     extname(path: string): string;
     /**
-     * 相対パスを計算
+     * Calculate relative path
      */
     relative(from: string, to: string): string;
     /**
-     * 絶対パスに変換
+     * Convert to absolute path
      */
     resolve(...paths: string[]): string;
     /**
-     * パスを正規化
+     * Normalize path
      */
     normalize(path: string): string;
     /**
-     * パスが絶対パスかどうか
+     * Check if path is absolute
      */
     isAbsolute(path: string): boolean;
-    /**
-     * パスのセパレータ
-     */
-    get sep(): string;
 }
 
 type Props$9 = {
     basePath: string;
-    pathSystem: DocPathSystem;
+    pathSystem?: DocPathSystem;
 };
 /**
- * ファイルシステム
+ * File system wrapper
  */
 declare class DocFileSystem {
     private readonly basePath;
     private readonly pathSystem;
     constructor(props: Props$9);
     /**
-     * 指定されたパスのファイルの内容を読み込む
+     * Read file content at the specified path
      */
     readFile(relativePath: string): Promise<string | null>;
     /**
-     * 指定されたパスのファイルに内容を書き込む（必要に応じてディレクトリも作成）
+     * Write content to file at the specified path (creates directory if needed)
      */
     writeFile(relativePath: string, content: string): Promise<void>;
     /**
-     * 指定されたパスのファイルを削除
+     * Delete file at the specified path
      */
     deleteFile(relativePath: string): Promise<Error | null>;
     /**
-     * 指定されたパスのファイル名を取得
+     * Get file name from path
      */
     readFileName(relativePath: string): string;
     /**
-     * 指定されたパスのファイル拡張子を取得
+     * Get file extension from path
      */
     readFileExtension(relativePath: string): string;
     /**
-     * 指定されたパスのファイルが存在するディレクトリパスを取得
+     * Get directory path where the file exists
      */
     readFileDirectory(relativePath: string): string;
     /**
-     * ディレクトリ内のエントリ一覧を取得
+     * Get list of entries in directory
      */
     readDirectoryFileNames(relativePath?: string): Promise<string[]>;
     readDirectoryFilePaths(relativePath: string): Promise<string[]>;
     /**
-     * 指定パスがディレクトリかチェック
+     * Check if path is a directory
      */
     isDirectory(relativePath: string): Promise<boolean>;
     /**
-     * 指定パスがファイルかチェック
+     * Check if path is a file
      */
     isFile(relativePath: string): Promise<boolean>;
     /**
-     * ファイルまたはディレクトリが存在するかチェック
+     * Check if file or directory exists
      */
     exists(relativePath: string): Promise<boolean>;
     /**
-     * ディレクトリが存在するかチェック
+     * Check if directory exists
      */
     directoryExists(relativePath: string): Promise<boolean>;
     /**
-     * ファイルが存在するかチェック
+     * Check if file exists
      */
     fileExists(relativePath: string): Promise<boolean>;
     /**
-     * ベースパスを取得
+     * Get base path
      */
     getBasePath(): string;
     /**
-     * 相対パスを絶対パスに変換
+     * Convert relative path to absolute path
      */
     resolve(relativePath: string): string;
     /**
-     * ディレクトリを作成する
+     * Create directory
      */
     createDirectory(relativePath: string): Promise<void>;
     /**
-     * ファイルのサイズを取得（バイト単位）
+     * Get file size in bytes
      */
     getFileSize(relativePath: string): Promise<number>;
     /**
-     * ディレクトリが存在しない場合は作成する
+     * Create directory if it doesn't exist
      */
     ensureDirectoryExists(relativePath: string): Promise<void>;
     /**
-     * ファイルをコピー
+     * Copy file
      */
     copyFile(sourcePath: string, destinationPath: string): Promise<void>;
     /**
-     * ファイルを移動
+     * Move file
      */
     moveFile(sourcePath: string, destinationPath: string): Promise<void>;
     /**
-     * ファイルの最終更新日時を取得
+     * Get file last modified time
      */
     getFileModifiedTime(relativePath: string): Promise<Date>;
     /**
-     * ファイルの作成日時を取得
+     * Get file creation time
      */
     getFileCreatedTime(relativePath: string): Promise<Date>;
 }
 
 /**
- * FrontMatterのスキーマ型
- * - ZodRecord: 動的なキーを持つ場合（デフォルト）
- * - ZodObject: 固定されたキーを持つ場合（型安全）
- */
-type FrontMatterSchema = z.ZodTypeAny;
-
-/**
- * スキーマフィールドで使用可能な型
- */
-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>;
-/**
- * 最小限のスキーマフィールドの型
- */
-type DocSchemaFieldMinimal = z.infer<typeof zDocSchemaFieldMinimal>;
-/**
- * 最小限のスキーマ定義の型
- */
-type DocSchemaMinimal = z.infer<typeof zDocSchemaMinimal>;
-/**
- * リレーション型フィールドの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パッケージの型を再エクスポート）
+ * Single boolean type schema field
  */
-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>;
-}
-
-/**
- * 動的にZodスキーマを生成するビルダー
- */
-declare class DocSchemaBuilder {
-    /**
-     * 動的にZodスキーマを生成
-     */
-    createDynamicSchema(value: unknown): z.ZodTypeAny;
+declare class DocSchemaFieldBooleanValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldBoolean;
+    constructor(key: T, 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(): DocFileIndexSchemaField;
     /**
-     * フィールドタイプに応じたZodスキーマを生成
+     * Validate value type
      */
-    private createFieldSchema;
+    validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
 }
 
 /**
- * リレーション複数型スキーマフィールド
+ * Multiple number type schema field
  */
-declare class DocSchemaFieldRelationMultipleValue {
-    readonly key: string;
-    readonly value: DocFieldMultiRelation;
-    constructor(key: string, value: DocFieldMultiRelation);
-    get type(): "multi-relation";
+declare class DocSchemaFieldMultiNumberValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldMultiNumber;
+    constructor(key: T, value: DocSchemaFieldMultiNumber);
+    get type(): "multi-number";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): string[] | null;
-    get path(): string;
+    get default(): number[] | null;
     readonly isArray = true;
     readonly isSingle = false;
-    readonly isRelation = true;
+    readonly isNumber = true;
     /**
-     * 値を検証する
+     * Validate value
      */
     validate(value: unknown): boolean;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiNumberValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiNumberValue<RecordKey>;
 }
 
 /**
- * 単一リレーション型スキーマフィールド
+ * Multiple relation type schema field
  */
-declare class DocSchemaFieldRelationSingleValue {
-    readonly key: string;
-    readonly value: DocSchemaFieldRelation;
-    constructor(key: string, value: DocSchemaFieldRelation);
-    get type(): "relation";
+declare class DocSchemaFieldMultiRelationValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldMultiRelation;
+    constructor(key: T, value: DocSchemaFieldMultiRelation);
+    get type(): "multi-relation";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): string | null;
+    get default(): string[] | null;
     get path(): string;
-    readonly isArray = false;
-    readonly isSingle = true;
+    readonly isArray = true;
+    readonly isSingle = false;
     readonly isRelation = true;
-    toJson(): DocSchemaField;
     /**
-     * 値の型を検証する
+     * Validate value
      */
     validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiRelationValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiRelationValue<RecordKey>;
 }
 
 /**
- * ブール複数型スキーマフィールド
+ * Multiple select number type schema field
  */
-declare class DocSchemaFieldBooleanMultipleValue {
-    readonly key: string;
-    readonly value: DocFieldMultiBoolean;
-    constructor(key: string, value: DocFieldMultiBoolean);
-    get type(): "multi-boolean";
+declare class DocSchemaFieldMultiSelectNumberValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldMultiSelectNumber;
+    constructor(key: T, value: DocSchemaFieldMultiSelectNumber);
+    get type(): "multi-select-number";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): boolean[] | null;
+    get default(): number[] | null;
+    get options(): number[];
     readonly isArray = true;
     readonly isSingle = false;
-    readonly isBoolean = true;
+    readonly isSelect = true;
+    readonly isNumberSelect = true;
     /**
-     * 値を検証する
+     * Validate value
      */
     validate(value: unknown): boolean;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectNumberValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectNumberValue<RecordKey>;
 }
 
 /**
- * 単一ブール型スキーマフィールド
+ * Multiple select text type schema field
  */
-declare class DocSchemaFieldBooleanSingleValue {
-    readonly key: string;
-    readonly value: DocSchemaFieldBoolean;
-    constructor(key: string, value: DocSchemaFieldBoolean);
-    get type(): "boolean";
+declare class DocSchemaFieldMultiSelectTextValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldMultiSelectText;
+    constructor(key: T, value: DocSchemaFieldMultiSelectText);
+    get type(): "multi-select-text";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): boolean | null;
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isBoolean = true;
-    toJson(): DocSchemaField;
+    get default(): string[] | null;
+    get options(): string[];
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isSelect = true;
+    readonly isTextSelect = true;
     /**
-     * 値の型を検証する
+     * Validate value
      */
     validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectTextValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectTextValue<RecordKey>;
 }
 
 /**
- * 数値複数型スキーマフィールド
+ * Multiple text type schema field
  */
-declare class DocSchemaFieldNumberMultipleValue {
-    readonly key: string;
-    readonly value: DocFieldMultiNumber;
-    constructor(key: string, value: DocFieldMultiNumber);
-    get type(): "multi-number";
+declare class DocSchemaFieldMultiTextValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldMultiText;
+    constructor(key: T, value: DocSchemaFieldMultiText);
+    get type(): "multi-text";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): number[] | null;
+    get default(): string[] | null;
     readonly isArray = true;
     readonly isSingle = false;
-    readonly isNumber = true;
+    readonly isText = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * 値を検証する
+     * Validate value type
      */
     validate(value: unknown): boolean;
-    toJson(): DocSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiTextValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiTextValue<RecordKey>;
 }
 
 /**
- * 単一数値型スキーマフィールド
+ * Single number type schema field
  */
-declare class DocSchemaFieldNumberSingleValue {
-    readonly key: string;
+declare class DocSchemaFieldNumberValue<T extends RecordKey> {
+    readonly key: T;
     readonly value: DocSchemaFieldNumber;
-    constructor(key: string, value: DocSchemaFieldNumber);
+    constructor(key: T, value: DocSchemaFieldNumber);
     get type(): "number";
     get required(): boolean;
     get title(): string;
@@ -564,44 +303,47 @@ declare class DocSchemaFieldNumberSingleValue {
     readonly isArray = false;
     readonly isSingle = true;
     readonly isNumber = true;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * 値の型を検証する
+     * Validate value type
      */
     validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldNumberValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberValue<RecordKey>;
 }
 
 /**
- * 数値選択複数型スキーマフィールド
+ * Single relation type schema field
  */
-declare class DocSchemaFieldSelectNumberMultipleValue {
-    readonly key: string;
-    readonly value: DocSchemaFieldMultiSelectNumber;
-    constructor(key: string, value: DocSchemaFieldMultiSelectNumber);
-    get type(): "multi-select-number";
+declare class DocSchemaFieldRelationValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldRelation;
+    constructor(key: T, value: DocSchemaFieldRelation);
+    get type(): "relation";
     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;
+    get default(): string | null;
+    get path(): string;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isRelation = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * 値を検証する
+     * Validate value type
      */
     validate(value: unknown): boolean;
-    toJson(): DocSchemaField;
+    static empty(key: RecordKey): DocSchemaFieldRelationValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldRelationValue<RecordKey>;
 }
 
 /**
- * 単一選択数値型スキーマフィールド
+ * Single select number type schema field
  */
-declare class DocSchemaFieldSelectNumberSingleValue {
-    readonly key: string;
+declare class DocSchemaFieldSelectNumberValue<T extends RecordKey> {
+    readonly key: T;
     readonly value: DocSchemaFieldSelectNumber;
-    constructor(key: string, value: DocSchemaFieldSelectNumber);
+    constructor(key: T, value: DocSchemaFieldSelectNumber);
     get type(): "select-number";
     get required(): boolean;
     get title(): string;
@@ -613,43 +355,21 @@ declare class DocSchemaFieldSelectNumberSingleValue {
     readonly isSelect = true;
     readonly isNumberSelect = true;
     /**
-     * 値を検証する
+     * Validate value
      */
     validate(value: unknown): boolean;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberValue<RecordKey>;
 }
 
 /**
- * テキスト選択複数型スキーマフィールド
+ * Single select text type schema field
  */
-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;
+declare class DocSchemaFieldSelectTextValue<T extends RecordKey> {
+    readonly key: T;
     readonly value: DocSchemaFieldSelectText;
-    constructor(key: string, value: DocSchemaFieldSelectText);
+    constructor(key: T, value: DocSchemaFieldSelectText);
     get type(): "select-text";
     get required(): boolean;
     get title(): string;
@@ -660,42 +380,22 @@ declare class DocSchemaFieldSelectTextSingleValue {
     readonly isSingle = true;
     readonly isSelect = true;
     readonly isTextSelect = true;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * 値の型を検証する
+     * Validate value type
      */
     validate(value: unknown): boolean;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextValue<RecordKey>;
 }
 
 /**
- * テキスト複数型スキーマフィールド
+ * Single text type schema field
  */
-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;
+declare class DocSchemaFieldTextValue<T extends RecordKey> {
+    readonly key: T;
     readonly value: DocSchemaFieldText;
-    constructor(key: string, value: DocSchemaFieldText);
+    constructor(key: T, value: DocSchemaFieldText);
     get type(): "text";
     get required(): boolean;
     get title(): string;
@@ -704,557 +404,810 @@ declare class DocSchemaFieldTextSingleValue {
     readonly isArray = false;
     readonly isSingle = true;
     readonly isText = true;
-    toJson(): DocSchemaField;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * 値の型を検証する
+     * Validate value type
      */
     validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldTextValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldTextValue<RecordKey>;
 }
 
 /**
- * テキスト型フィールド
+ * Text field type
+ */
+type DocSchemaFieldText = z.infer<typeof zDocSchemaFieldText>;
+/**
+ * Number field type
+ */
+type DocSchemaFieldNumber = z.infer<typeof zDocSchemaFieldNumber>;
+/**
+ * Boolean field type
+ */
+type DocSchemaFieldBoolean = z.infer<typeof zDocSchemaFieldBoolean>;
+/**
+ * Multi-text field type
+ */
+type DocSchemaFieldMultiText = z.infer<typeof zDocSchemaFieldMultiText>;
+/**
+ * Multi-number field type
+ */
+type DocSchemaFieldMultiNumber = z.infer<typeof zDocSchemaFieldMultiNumber>;
+/**
+ * Relation field type
+ */
+type DocSchemaFieldRelation = z.infer<typeof zDocSchemaFieldRelation>;
+/**
+ * Multi-relation field type
+ */
+type DocSchemaFieldMultiRelation = z.infer<typeof zDocSchemaFieldMultiRelation>;
+/**
+ * Select text field type
+ */
+type DocSchemaFieldSelectText = z.infer<typeof zDocSchemaFieldSelectText>;
+/**
+ * Select number field type
+ */
+type DocSchemaFieldSelectNumber = z.infer<typeof zDocSchemaFieldSelectNumber>;
+/**
+ * Multi-select text field type
+ */
+type DocSchemaFieldMultiSelectText = z.infer<typeof zDocSchemaFieldMultiSelectText>;
+/**
+ * Multi-select number field type
+ */
+type DocSchemaFieldMultiSelectNumber = z.infer<typeof zDocSchemaFieldMultiSelectNumber>;
+type DocMetaField = z.infer<typeof zDocMetaField>;
+type DocMetaFieldText = z.infer<typeof zDocMetaFieldText>;
+type DocMetaFieldNumber = z.infer<typeof zDocMetaFieldNumber>;
+type DocMetaFieldBoolean = z.infer<typeof zDocMetaFieldBoolean>;
+type DocMetaFieldSelectText = z.infer<typeof zDocMetaFieldSelectText>;
+type DocMetaFieldSelectNumber = z.infer<typeof zDocMetaFieldSelectNumber>;
+type DocMetaFieldRelation = z.infer<typeof zDocMetaFieldRelation>;
+type DocMetaFieldMultiText = z.infer<typeof zDocMetaFieldMultiText>;
+type DocMetaFieldMultiNumber = z.infer<typeof zDocMetaFieldMultiNumber>;
+type DocMetaFieldMultiBoolean = z.infer<typeof zDocMetaFieldMultiBoolean>;
+type DocMetaFieldMultiSelectText = z.infer<typeof zDocMetaFieldMultiSelectText>;
+type DocMetaFieldMultiSelectNumber = z.infer<typeof zDocMetaFieldMultiSelectNumber>;
+type DocMetaFieldMultiRelation = z.infer<typeof zDocMetaFieldMultiRelation>;
+type DocFileMdMeta<T extends RecordKey> = Record<T, DocMetaField>;
+type DocMetaFieldTypeText = z.infer<typeof zDocMetaFieldTypeText>;
+type DocMetaFieldTypeNumber = z.infer<typeof zDocMetaFieldTypeNumber>;
+type DocMetaFieldTypeBoolean = z.infer<typeof zDocMetaFieldTypeBoolean>;
+type DocMetaFieldTypeSelectText = z.infer<typeof zDocMetaFieldTypeSelectText>;
+type DocMetaFieldTypeSelectNumber = z.infer<typeof zDocMetaFieldTypeSelectNumber>;
+type DocMetaFieldTypeRelation = z.infer<typeof zDocMetaFieldTypeRelation>;
+/**
+ * Schema field type
+ */
+type DocMetaFieldType = z.infer<typeof zDocMetaFieldType>;
+type DocCustomSchemaFieldText = z.infer<typeof zDocCustomSchemaFieldText>;
+type DocCustomSchemaFieldNumber = z.infer<typeof zDocCustomSchemaFieldNumber>;
+type DocCustomSchemaFieldBoolean = z.infer<typeof zDocCustomSchemaFieldBoolean>;
+type DocCustomSchemaFieldRelation = z.infer<typeof zDocCustomSchemaFieldRelation>;
+type DocCustomSchemaFieldSelectText = z.infer<typeof zDocCustomSchemaFieldSelectText>;
+type DocCustomSchemaFieldSelectNumber = z.infer<typeof zDocCustomSchemaFieldSelectNumber>;
+type DocCustomSchemaFieldMultiText = z.infer<typeof zDocCustomSchemaFieldMultiText>;
+type DocCustomSchemaFieldMultiNumber = z.infer<typeof zDocCustomSchemaFieldMultiNumber>;
+type DocCustomSchemaFieldMultiRelation = z.infer<typeof zDocCustomSchemaFieldMultiRelation>;
+type DocCustomSchemaFieldMultiSelectText = z.infer<typeof zDocCustomSchemaFieldMultiSelectText>;
+type DocCustomSchemaFieldMultiSelectNumber = z.infer<typeof zDocCustomSchemaFieldMultiSelectNumber>;
+/**
+ * Schema field type
+ */
+type DocFileIndexSchemaField = z.infer<typeof zDocFileIndexSchemaField>;
+/**
+ * Schema definition type
+ */
+type DocFileIndexSchema<T extends RecordKey> = Record<T, DocFileIndexSchemaField>;
+/**
+ * Schema field to override
+ * ex: { xxx: { type: "text", required: true } }
+ */
+type DocCustomSchemaField = z.infer<typeof zDocCustomSchemaField>;
+/**
+ * Minimal schema definition type
+ */
+type DocCustomSchema<T extends RecordKey = RecordKey> = Record<T, DocCustomSchemaField>;
+/**
+ * Union type for relation fields
+ */
+type DocSchemaRelationFieldUnion = DocSchemaFieldRelation | DocSchemaFieldMultiRelation;
+/**
+ * File node type (for files only)
+ */
+type DocTreeFileNode = {
+    type: "file";
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+};
+/**
+ * Directory node type (for directories only)
+ */
+type DocTreeDirectoryNode = {
+    type: "directory";
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+    children: DocTreeNode[];
+};
+/**
+ * Unified tree node type
+ */
+type DocTreeNode = DocTreeFileNode | DocTreeDirectoryNode;
+/**
+ * Index file type
+ */
+type DocFileIndex<T extends DocCustomSchema> = {
+    type: "index";
+    path: DocFilePath;
+    isArchived: boolean;
+    content: DocFileIndexContent<T>;
+};
+/**
+ * Type to check if two types are equal
+ */
+type Equals<T, U> = (<G>() => G extends T ? 1 : 2) extends <G>() => G extends U ? 1 : 2 ? true : false;
+/**
+ * Extract relation field keys from schema
+ */
+type RelationKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K]["type"] extends "relation" ? K : never;
+}[keyof T];
+/**
+ * Extract multi-relation field keys from schema
+ */
+type MultiRelationKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K]["type"] extends "multi-relation" ? K : never;
+}[keyof T];
+/**
+ * Markdown file type (excluding index.md)
+ */
+type DocFileMd<T extends DocCustomSchema> = {
+    type: "markdown";
+    path: DocFilePath;
+    isArchived: boolean;
+    content: DocFileMdContent<T>;
+};
+/**
+ * Other file type (non-markdown)
+ */
+type DocFileUnknown = z.infer<typeof zDocFileUnknown>;
+/**
+ * File union type (index.md, regular md, other)
+ */
+type DocFile<T extends DocCustomSchema> = DocFileIndex<T> | DocFileMd<T> | DocFileUnknown;
+/**
+ * Directory FrontMatter type
+ */
+type DocFileIndexMeta<T extends DocCustomSchema> = {
+    type: "index-meta";
+    icon: string | null;
+    schema: DocFileIndexSchema<keyof T>;
+};
+/**
+ * Relation options type
+ */
+type DocRelationFile = z.infer<typeof zDocRelationFile>;
+/**
+ * Relation information type
+ */
+type DocRelation = z.infer<typeof zDocRelation>;
+/**
+ * Relation field type
+ */
+type DocRelationField = z.infer<typeof zDocRelationField>;
+/**
+ * File path information type
+ */
+type DocFilePath = z.infer<typeof zDocFilePath>;
+/**
+ * Markdown content information type
+ */
+type DocFileMdContent<T extends DocCustomSchema> = {
+    type: "markdown-content";
+    body: string;
+    title: string;
+    description: string;
+    meta: SchemaToValueType<T>;
+};
+/**
+ * Index file content information type
+ */
+type DocFileIndexContent<T extends DocCustomSchema> = {
+    type: "markdown-index";
+    body: string;
+    title: string;
+    description: string;
+    meta: DocFileIndexMeta<T>;
+};
+/**
+ * Directory response type (re-export from server package)
+ */
+type DocDirectory<T extends DocCustomSchema> = {
+    cwd: string;
+    indexFile: DocFileIndex<T>;
+    files: DocFile<T>[];
+    relations: DocRelation[];
+};
+type RecordKey = string | number | symbol;
+/**
+ * DocClient configuration
+ */
+type DocClientConfig = z.infer<typeof zDocClientConfig>;
+/**
+ * Type definitions for DocFileMdMetaValue
  */
-type DocSchemaFieldTextTypes = DocSchemaFieldTextSingleValue | DocSchemaFieldTextMultipleValue;
+type ExtractFieldType<T> = T extends {
+    type: infer Type;
+} ? Type : never;
+type ExtractRequired<T> = T extends {
+    required: infer Required;
+} ? Required : false;
+type BaseFieldValueType<Type> = Type extends "text" ? string : Type extends "number" ? number : Type extends "boolean" ? boolean : Type extends "multi-text" ? string[] : Type extends "multi-number" ? number[] : Type extends "multi-boolean" ? boolean[] : Type extends "relation" ? string : Type extends "multi-relation" ? string[] : Type extends "select-text" ? string : Type extends "select-number" ? number : Type extends "multi-select-text" ? string[] : Type extends "multi-select-number" ? number[] : never;
+type FieldValueType<Type, Required> = Required extends true ? BaseFieldValueType<Type> : BaseFieldValueType<Type> | null;
 /**
- * 数値型フィールド
+ * Extract required field keys
  */
-type DocSchemaFieldNumberTypes = DocSchemaFieldNumberSingleValue | DocSchemaFieldNumberMultipleValue;
+type RequiredKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K] extends {
+        required: true;
+    } ? K : never;
+}[keyof T];
 /**
- * ブール型フィールド
+ * Extract optional field keys
  */
-type DocSchemaFieldBooleanTypes = DocSchemaFieldBooleanSingleValue | DocSchemaFieldBooleanMultipleValue;
+type OptionalKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K] extends {
+        required: true;
+    } ? never : K;
+}[keyof T];
 /**
- * 選択型フィールド
+ * Generate expected value type from schema (considering required)
  */
-type DocSchemaFieldSelectTypes = DocSchemaFieldSelectTextSingleValue | DocSchemaFieldSelectTextMultipleValue | DocSchemaFieldSelectNumberSingleValue | DocSchemaFieldSelectNumberMultipleValue;
+type SchemaToValueType<T extends DocCustomSchema> = {
+    [K in RequiredKeys<T>]: BaseFieldValueType<ExtractFieldType<T[K]>>;
+} & {
+    [K in OptionalKeys<T>]?: BaseFieldValueType<ExtractFieldType<T[K]>>;
+};
 /**
- * リレーション型フィールド
+ * Helper type for type-safe property access
  */
-type DocSchemaFieldRelationTypes = DocSchemaFieldRelationSingleValue | DocSchemaFieldRelationMultipleValue;
+type GetValueType<T extends DocCustomSchema, K extends keyof T> = K extends RequiredKeys<T> ? BaseFieldValueType<ExtractFieldType<T[K]>> : BaseFieldValueType<ExtractFieldType<T[K]>> | undefined;
 /**
- * スキーマフィールドの型共用体
+ * Type definitions for DocFileIndexSchema
  */
-type DocSchemaFieldValue = DocSchemaFieldTextTypes | DocSchemaFieldNumberTypes | DocSchemaFieldBooleanTypes | DocSchemaFieldSelectTypes | DocSchemaFieldRelationTypes;
+type ExtractIndexFieldType<T> = T extends {
+    type: infer Type;
+} ? Type : never;
+type GetIndexFieldType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends DocFileIndexSchemaField ? Schema[K] : never;
+type GetIndexFieldValueType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends {
+    type: infer Type;
+} ? Type extends "text" ? DocSchemaFieldTextValue<K> : Type extends "number" ? DocSchemaFieldNumberValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanValue<K> : Type extends "relation" ? DocSchemaFieldRelationValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberValue<K> : Type extends "multi-text" ? DocSchemaFieldMultiTextValue<K> : Type extends "multi-number" ? DocSchemaFieldMultiNumberValue<K> : Type extends "multi-relation" ? DocSchemaFieldMultiRelationValue<K> : Type extends "multi-select-text" ? DocSchemaFieldMultiSelectTextValue<K> : Type extends "multi-select-number" ? DocSchemaFieldMultiSelectNumberValue<K> : never : never;
 
 /**
- * 型安全なスキーマ値オブジェクト
- * @template T - Zodスキーマの型（オプショナル）
+ * Relation file
  */
-declare class DocSchemaValue<T extends z.ZodTypeAny = z.ZodTypeAny> {
-    readonly value: DocSchemaRecord;
-    private readonly zodSchema;
-    constructor(value: unknown, zodSchema?: T, schemaBuilder?: DocSchemaBuilder);
+declare class DocRelationFileValue {
+    private readonly value;
+    constructor(value: DocRelationFile);
     /**
-     * フィールド名の一覧を取得
-     * Zodスキーマを使用している場合は自動的に型安全
+     * File path
      */
-    get fieldNames(): string[];
+    get id(): string;
     /**
-     * 指定されたフィールド名のフィールドを取得
-     * Zodスキーマを使用している場合は型安全
+     * Slug
      */
-    field<K extends keyof z.infer<T> & string>(name: K): DocSchemaFieldValue | null;
-    field(name: string): DocSchemaFieldValue | null;
+    get slug(): string;
     /**
-     * すべてのフィールドを取得
-     * 注意: 型安全性のため、個別にfield()メソッドを使用することを推奨
+     * Display label
      */
-    get fields(): DocSchemaFieldValue[];
-    get relationFields(): (DocSchemaFieldRelationSingleValue | DocSchemaFieldRelationMultipleValue)[];
+    get label(): string;
     /**
-     * 空のスキーマエンティティを作成
+     * Create from file path and title
      */
-    static empty<T extends z.ZodTypeAny = z.ZodTypeAny>(zodSchema?: T, dynamicBuilder?: DocSchemaBuilder): DocSchemaValue<T>;
+    static from(filePath: string, title: string | null): DocRelationFileValue;
     /**
-     * スキーマからリレーションパスを抽出
+     * Extract file name from file path (without extension)
      */
-    extractRelationPaths(): Set<string>;
+    private static extractFileName;
     /**
-     * フィールドがリレーション型かどうかを判定
+     * Convert to JSON format
      */
-    private isRelationField;
+    toJson(): DocRelationFile;
+}
+
+/**
+ * Manages relation information
+ */
+declare class DocRelationValue {
+    readonly value: DocRelation;
+    constructor(value: DocRelation);
     /**
-     * リレーションオプションを作成
+     * Relation path
      */
-    createRelationOption(filePath: string, title: string | null): DocRelationFile;
+    get path(): string;
     /**
-     * ファイルをスキップすべきかどうかを判定
+     * List of related files (value objects)
      */
-    shouldSkipFile(filePath: string): boolean;
+    get files(): DocRelationFileValue[];
     /**
-     * 値を指定された型に変換する（デフォルト値フォールバック付き）
+     * Get file count
      */
-    convertValue(value: unknown, targetType: string, defaultValue: unknown): unknown;
+    get fileCount(): number;
     /**
-     * 型別の変換処理
+     * Whether it's empty
      */
-    private convertByType;
+    get isEmpty(): boolean;
     /**
-     * 文字列型への変換
+     * Create empty relation entity
      */
-    private convertToString;
+    static empty(path: string): DocRelationValue;
     /**
-     * 数値型への変換
+     * Export as JSON format
      */
-    private convertToNumber;
+    toJson(): DocRelation;
+}
+
+type Props$8 = {
+    filePath: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+};
+/**
+ * Relation file reference
+ */
+declare class DocFileRelationReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$8);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
     /**
-     * ブール型への変換
+     * Relation path
      */
-    private convertToBoolean;
+    get path(): string;
     /**
-     * 配列型への変換
+     * Full path
      */
-    private convertToArray;
+    get fullPath(): string;
+    read(): Promise<DocRelationValue | null>;
     /**
-     * リレーション型への変換
+     * Read list of relation files
      */
-    private convertToRelation;
+    readFiles(): Promise<DocRelationFileValue[]>;
     /**
-     * マルチリレーション型への変換
+     * Read single relation file
      */
-    private convertToMultiRelation;
+    readFile(filePath: string): Promise<DocRelationFileValue | null>;
     /**
-     * パスからファイル名を抽出（拡張子除去）
+     * Check if file exists
      */
-    private extractFileNameFromPath;
+    exists(slug: string): Promise<boolean>;
     /**
-     * スキーマベースでFrontMatterを補完する
+     * Get list of file names (without extension)
      */
-    getCompleteFrontMatter(rawFrontMatter: unknown): DocFileMdFrontMatter;
+    readSlugs(): Promise<string[]>;
     /**
-     * 型安全にFrontMatterを補完する（Zodスキーマを使用している場合）
+     * Get file count
      */
-    getTypedCompleteFrontMatter(rawFrontMatter: Partial<z.infer<T>>): z.infer<T>;
+    count(): Promise<number>;
     /**
-     * スキーマからデフォルトFrontMatterを生成
+     * Check if empty
      */
-    private generateDefaultFrontMatter;
+    isEmpty(): Promise<boolean>;
+}
+
+/**
+ * Type-safe schema value object
+ */
+declare class DocFileIndexSchemaValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexSchema<keyof T>;
+    readonly customSchema: T;
+    constructor(value: DocFileIndexSchema<keyof T>, customSchema: T);
     /**
-     * 既存の値を保持しながらマージ
+     * Get list of field names
+     * Automatically type-safe when using Zod schema
      */
-    private mergePreservingExistingValues;
+    get fieldNames(): Array<keyof T>;
     /**
-     * ファイルパスからファイル名を抽出（拡張子なし）
+     * Get field with specified field name
+     * Returns type-safe specific field Value object
      */
-    private extractFileName;
+    field<K extends keyof T>(key: K): T[K]["type"] extends infer Type ? Type extends "text" ? DocSchemaFieldTextValue<K> : Type extends "number" ? DocSchemaFieldNumberValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanValue<K> : Type extends "relation" ? DocSchemaFieldRelationValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberValue<K> : Type extends "multi-text" ? DocSchemaFieldMultiTextValue<K> : Type extends "multi-number" ? DocSchemaFieldMultiNumberValue<K> : Type extends "multi-relation" ? DocSchemaFieldMultiRelationValue<K> : Type extends "multi-select-text" ? DocSchemaFieldMultiSelectTextValue<K> : Type extends "multi-select-number" ? DocSchemaFieldMultiSelectNumberValue<K> : never : never;
+    relation<K extends keyof T>(key: K): DocSchemaFieldRelationValue<K>;
+    multiRelation<K extends keyof T>(key: K): DocSchemaFieldMultiRelationValue<K>;
     /**
-     * nullまundefinedのチェック
+     * Get all fields
+     * Note: For type safety, it's recommended to use field() method individually
      */
-    private isNullOrUndefined;
-    toJson(): DocSchemaRecord;
+    get fields(): DocFileIndexSchema<keyof T>[keyof T][];
+    get relationFields(): (DocSchemaFieldRelationValue<string> | DocSchemaFieldMultiRelationValue<string>)[];
+    toJson(): DocFileIndexSchema<keyof T>;
     /**
-     * スキーマを正規化（エラーを出すように変更）
+     * Create empty schema entity
+     * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
      */
-    private static normalizeSchema;
+    static empty(): DocFileIndexSchemaValue<{}>;
 }
 
 /**
- * FrontMatter
+ * File: index.md > content > FrontMatter
  */
-declare class DocFrontMatterIndexValue {
-    readonly value: DocFileIndexFrontMatter;
-    constructor(value: DocFileIndexFrontMatter);
+declare class DocFileIndexMetaValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexMeta<T>;
+    readonly customSchema: T;
+    private readonly config;
     /**
-     * アイコンを取得
+     * Additional properties to include in the meta data
      */
-    icon(): string;
+    private readonly additionalProperties;
+    constructor(value: DocFileIndexMeta<T>, customSchema: T, config: DocClientConfig, additionalProperties?: Record<string, unknown>);
     /**
-     * スキーマを取得
+     * Get icon
      */
-    schema<T extends z.ZodTypeAny = z.ZodTypeAny>(zodSchema?: T): DocSchemaValue<T>;
+    get icon(): string | null;
     /**
-     * iconフィールドを更新
+     * Get schema
      */
-    withIcon(value: unknown): DocFrontMatterIndexValue;
+    schema(): DocFileIndexSchemaValue<T>;
     /**
-     * schemaフィールドを更新
+     * Check if schema is defined
      */
-    withSchema(value: unknown): DocFrontMatterIndexValue;
+    get hasSchema(): boolean;
     /**
-     * JSON形式で出力
+     * Update icon field
      */
-    toJson(): DocFileIndexFrontMatter;
+    withIcon(value: string | null): DocFileIndexMetaValue<T>;
     /**
-     * YAML形式で出力
+     * Update schema field
      */
-    toYaml(): string;
+    withSchema(value: DocFileIndexSchema<keyof T>): DocFileIndexMetaValue<T>;
     /**
-     * スキーマ全体を正規化
+     * Output in JSON format
      */
-    private static createSchema;
+    toJson(): DocFileIndexMeta<T>;
     /**
-     * スキーマフィールドを正規化
+     * Output in YAML format
      */
-    private static createSchemaField;
+    toYaml(): string;
     /**
-     * Markdownテキストから生成（不完全なデータも処理可能）
+     * Generate from Markdown text (can process incomplete data)
      */
-    static from(markdownText: string): DocFrontMatterIndexValue;
+    static from<T extends DocCustomSchema>(markdownText: string, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * データから直接生成（不完全なデータも処理可能）
+     * Generate directly from data (can process incomplete data)
      */
-    static fromRecord(record: Record<string, unknown>): DocFrontMatterIndexValue;
+    static fromRecord<T extends DocCustomSchema>(record: Record<string, unknown>, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * 空のFrontMatterを生成
+     * Generate empty FrontMatter
      */
-    static empty(): DocFrontMatterIndexValue;
+    static empty<T extends DocCustomSchema>(customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * アイコンを抽出
+     * Extract icon
      */
     private static extractIcon;
     /**
-     * スキーマを抽出
+     * Extract schema part
      */
     private static extractSchema;
     /**
-     * デフォルトのアイコンを取得
+     * Normalize entire schema
      */
-    private static getDefaultIcon;
+    private static normalizeSchema;
+    static emptySchema<T extends DocCustomSchema>(customSchema: T): DocFileIndexSchema<keyof T>;
 }
 
 /**
- * Indexファイルコンテンツ情報の値オブジェクト
+ * File: index.md > content
  */
-declare class DocFileContentIndexValue {
-    readonly value: DocFileContentIndex;
-    constructor(value: DocFileContentIndex);
+declare class DocFileIndexContentValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexContent<T>;
+    private readonly customSchema;
+    private readonly config;
+    constructor(value: DocFileIndexContent<T>, customSchema: T, config: DocClientConfig);
     /**
-     * コンテンツ本文（frontMatterを含まない）
+     * Content body (does not include frontMatter)
      */
     get body(): string;
     /**
-     * タイトル
+     * Title
      */
     get title(): string;
     /**
-     * 説明
+     * Description
      */
     get description(): string;
     /**
      * FrontMatter
      */
-    get frontMatter(): DocFrontMatterIndexValue;
+    meta(): DocFileIndexMetaValue<T>;
     /**
-     * タイトルを更新
+     * Update title
      */
-    withTitle(title: string): DocFileContentIndexValue;
+    withTitle(title: string): DocFileIndexContentValue<T>;
     /**
-     * 説明を更新
+     * Update description
      */
-    withDescription(description: string, defaultTitle?: string): DocFileContentIndexValue;
+    withDescription(description: string, defaultTitle?: string): DocFileIndexContentValue<T>;
     /**
-     * Markdownテキストから生成
+     * Generate from Markdown text
      */
-    static fromMarkdown(markdown: string): DocFileContentIndexValue;
+    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
     /**
-     * 完全なMarkdownテキストを生成
+     * Generate complete Markdown text
      */
     toMarkdownText(): string;
     /**
-     * コンテンツを更新
+     * Update content
      */
-    withContent(content: string): DocFileContentIndexValue;
+    withContent(content: string): DocFileIndexContentValue<T>;
     /**
-     * FrontMatterを更新
+     * Update FrontMatter
      */
-    withFrontMatter(frontMatter: DocFrontMatterIndexValue): DocFileContentIndexValue;
+    withMeta(meta: DocFileIndexMeta<T>): DocFileIndexContentValue<T>;
     /**
-     * デフォルトのindex.mdコンテンツを生成
+     * Generate default index.md content
      */
-    static empty(directoryName: string): DocFileContentIndexValue;
+    static empty<T extends DocCustomSchema = DocCustomSchema>(directoryName: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
     /**
-     * FrontMatterとbodyを結合した完全なテキストを生成
+     * Generate complete text combining FrontMatter and body
      */
     toText(): string;
     /**
-     * JSON形式で出力
+     * Output in JSON format
      */
-    toJson(): DocFileContentIndex;
+    toJson(): DocFileIndexContent<T>;
 }
 
 /**
- * ドキュメントのディレクトリ
+ * Document directory entity
  */
-declare class DocFileIndexEntity {
-    readonly value: DocFileIndex;
-    constructor(value: DocFileIndex);
+declare class DocFileIndexEntity<T extends DocCustomSchema> {
+    readonly value: DocFileIndex<T>;
+    private readonly customSchema;
+    private readonly config;
+    constructor(value: DocFileIndex<T>, customSchema: T, config?: DocClientConfig);
     /**
-     * コンテンツ
+     * Content
      */
-    get content(): DocFileContentIndexValue;
+    get content(): DocFileIndexContentValue<T>;
     /**
-     * パス情報
+     * Path information
      */
     get path(): DocFilePath;
     /**
-     * コンテンツを更新
+     * Update content
      */
-    withContent(content: DocFileContentIndexValue): DocFileIndexEntity;
+    withContent(content: DocFileIndexContentValue<T>): DocFileIndexEntity<T>;
     /**
-     * パスを更新
+     * Update path
      */
-    withPath(path: DocFilePath): DocFileIndexEntity;
+    withPath(path: DocFilePath): DocFileIndexEntity<T>;
     /**
-     * indexFileSchemaの形式に変換
+     * Convert to index file schema format
      */
-    toJson(): DocFileIndex;
+    toJson(): DocFileIndex<T>;
 }
 
-type Props$7 = {
+type Props$7<T extends DocCustomSchema> = {
+    customSchema: T;
     path: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
+    config: DocClientConfig;
 };
 /**
- * ファイルを表すクラス
+ * File reference class
  */
-declare class DocFileIndexReference {
+declare class DocFileIndexReference<T extends DocCustomSchema> {
     private readonly props;
     private readonly pathSystem;
-    constructor(props: Props$7);
+    private readonly customSchema;
+    constructor(props: Props$7<T>);
     get fileSystem(): DocFileSystem;
     get basePath(): string;
     get filePath(): string;
     get fileFullPath(): string;
     get durectoryPath(): string;
-    read(): Promise<DocFileIndexEntity>;
+    read(): Promise<DocFileIndexEntity<T>>;
     /**
-     * ファイルの内容を読み込む
+     * Read file content
      */
     readContent(): Promise<Error | string>;
     /**
-     * ファイルに内容を書き込む
+     * Write content to file
      */
     writeContent(content: string): Promise<void>;
     /**
-     * Entityを書き込む
+     * Write entity
      */
-    write(entity: DocFileIndexEntity): Promise<void>;
+    write(entity: DocFileIndexEntity<T>): Promise<void>;
     /**
-     * 新しいファイルをデフォルトコンテンツで作成
+     * Create new file with default content
      */
-    writeDefault(): Promise<void>;
+    writeDefault(): Promise<null>;
     /**
-     * ファイルを削除
+     * Delete file
      */
     delete(): Promise<Error | null>;
     /**
-     * ファイルが存在するか確認
+     * Check if file exists
      */
     exists(): Promise<boolean>;
     relations(): Promise<DocFileRelationReference[]>;
     readRelations(): Promise<DocRelationValue[]>;
     /**
-     * ファイルのサイズを取得（バイト単位）
+     * Get file size in bytes
      */
     size(): Promise<number>;
     /**
-     * ファイルの最終更新日時を取得
+     * Get last modified date
      */
     lastModified(): Promise<Date>;
     /**
-     * ファイルの作成日時を取得
+     * Get file creation date
      */
     createdAt(): Promise<Date>;
     /**
-     * ファイルをアーカイブに移動し、新しい参照を返す
+     * Move file to archive and return new reference
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference>;
+    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
     /**
-     * ファイルをアーカイブから復元し、新しい参照を返す
+     * Restore file from archive and return new reference
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference>;
+    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
 }
 
 /**
- * FrontMatter
- */
-declare class DocFrontMatterMdValue<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter> {
-    private readonly zodSchema;
-    constructor(value: DocFileMdFrontMatter, zodSchema: T);
-    readonly value: DocFileMdFrontMatter;
-    toJson(): DocFileMdFrontMatter;
+ * Meta
+ */
+declare class DocFileMdMetaValue<T extends DocCustomSchema> {
+    readonly value: SchemaToValueType<T>;
+    readonly customSchema: T;
+    constructor(value: SchemaToValueType<T>, customSchema: T);
+    private validateValue;
+    private getValueField;
+    get keys(): Array<keyof T>;
+    /**
+     * Return a new instance with a single property updated
+     */
+    withProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdMetaValue<T>;
+    schemaField<K extends keyof T>(key: K): T[K];
+    field<K extends keyof T>(key: K): FieldValueType<ExtractFieldType<T[K]>, ExtractRequired<T[K]>>;
+    relation(key: keyof T): DocMetaFieldRelation;
+    multiRelation(key: keyof T): DocMetaFieldMultiRelation;
+    text(key: keyof T): DocMetaFieldText;
+    number(key: keyof T): DocMetaFieldNumber;
+    boolean(key: keyof T): DocMetaFieldBoolean;
+    multiText(key: keyof T): DocMetaFieldMultiText;
+    multiNumber(key: keyof T): DocMetaFieldMultiNumber;
+    multiBoolean(key: keyof T): DocMetaFieldMultiBoolean;
+    hasKey(key: keyof T): boolean;
+    /**
+     * Generate from Markdown text
+     */
+    static fromYamlText<T extends DocCustomSchema>(yamlText: string, customSchema: T): DocFileMdMetaValue<T>;
+    static empty<T extends DocCustomSchema>(customSchema: T): DocFileMdMetaValue<T>;
+    toJson(): SchemaToValueType<T>;
     toYaml(): string;
-    schema<U extends z.ZodTypeAny = z.ZodTypeAny>(zodSchema?: U): DocSchemaValue<U>;
-    /**
-     * Markdownテキストから生成
-     */
-    static from<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(markdownText: string, zodSchema: T): DocFrontMatterMdValue<T>;
-    /**
-     * 空のFrontMatterを生成
-     */
-    static empty<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(zodSchema: T): DocFrontMatterMdValue<T>;
-    /**
-     * データから直接生成
-     */
-    static fromData<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(data: unknown, zodSchema: T): DocFrontMatterMdValue<T>;
-    /**
-     * スキーマフィールドに基づいてデフォルト値を生成する
-     */
-    static generateDefaultValueFromSchemaField(fieldDef: {
-        type: string;
-        default?: unknown;
-    }): unknown;
-    /**
-     * 単一のプロパティを更新した新しいインスタンスを返す
-     */
-    withProperty(key: string, value: unknown): DocFrontMatterMdValue<T>;
-    /**
-     * テキスト型のプロパティを取得
-     */
-    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[];
-    /**
-     * フィールドアクセス（Zodスキーマで型安全）
-     */
-    field<K extends keyof z.infer<T> & string>(key: K): T extends z.ZodTypeAny ? z.infer<T>[K] | null : unknown;
-    field(key: string): unknown;
-    /**
-     * 型安全な値の取得
-     */
-    get typedValue(): z.infer<T> | null;
 }
 
 /**
- * Markdownコンテンツ情報の値オブジェクト
+ * File: Markdown > Content
  */
-declare class DocFileContentMdValue<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter> {
-    readonly value: DocFileContentMd;
-    private readonly zodSchema;
-    constructor(value: DocFileContentMd, zodSchema: T);
+declare class DocFileMdContentValue<T extends DocCustomSchema> {
+    readonly value: DocFileMdContent<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMdContent<T>, customSchema: T);
     /**
-     * コンテンツ本文（frontMatterを含まない）
+     * Content body (does not include frontMatter)
      */
     get body(): string;
     /**
-     * タイトル
+     * Title
      */
     get title(): string;
     /**
-     * 説明
+     * Description
      */
     get description(): string;
     /**
-     * FrontMatter（コンストラクタのZodスキーマまたは引数のスキーマを使用）
+     * FrontMatter (uses constructor's Zod schema or argument schema)
      */
-    frontMatter<U extends FrontMatterSchema = T>(zodSchema?: U): DocFrontMatterMdValue<U extends FrontMatterSchema ? U : T>;
+    meta(): DocFileMdMetaValue<T>;
     /**
-     * タイトルを更新
+     * Update title
      */
-    withTitle(title: string): DocFileContentMdValue<T>;
+    withTitle(title: string): DocFileMdContentValue<T>;
     /**
-     * 説明を更新
+     * Update description
      */
-    withDescription(description: string, defaultTitle?: string): DocFileContentMdValue<T>;
+    withDescription(description: string, defaultTitle?: string): DocFileMdContentValue<T>;
     /**
-     * コンテンツを更新
+     * Update content
      */
-    withContent(content: string): DocFileContentMdValue<T>;
+    withContent(content: string): DocFileMdContentValue<T>;
     /**
-     * FrontMatterを更新
+     * Update FrontMatter
      */
-    withFrontMatter<U extends FrontMatterSchema>(frontMatter: DocFrontMatterMdValue<U>, zodSchema: U): DocFileContentMdValue<U>;
+    withMeta<U extends DocCustomSchema>(meta: DocFileMdMetaValue<U>): DocFileMdContentValue<U>;
     /**
-     * FrontMatterの特定のプロパティを更新
+     * Update specific property of FrontMatter
      */
-    withFrontMatterProperty(key: string, value: unknown): DocFileContentMdValue<T>;
+    withMetaProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdContentValue<T>;
     /**
-     * Markdownテキストから生成
+     * Generate from Markdown text
      */
-    static fromMarkdown<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(markdown: string, zodSchema?: T): DocFileContentMdValue<T>;
+    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T): DocFileMdContentValue<T>;
     /**
-     * 完全なMarkdownテキストを生成
+     * Generate complete Markdown text
      */
     toMarkdownText(): string;
     /**
-     * FrontMatterとbodyを結合した完全なテキストを生成
+     * Generate complete text combining FrontMatter and body
      */
     toText(): string;
     /**
-     * 空のコンテンツを生成
+     * Generate empty content
      */
-    static empty<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(title: string, zodSchema: T): DocFileContentMdValue<T>;
+    static empty<T extends DocCustomSchema = DocCustomSchema>(title: string, customSchema: T): DocFileMdContentValue<T>;
     /**
-     * JSON形式で出力
+     * Output in JSON format
      */
-    toJson(): DocFileContentMd;
+    toJson(): DocFileMdContent<T>;
 }
 
 /**
- * ドキュメントのファイル
+ * Markdown file entity
  */
-declare class DocFileMdEntity {
-    readonly value: DocFileMd;
-    constructor(value: DocFileMd);
+declare class DocFileMdEntity<T extends DocCustomSchema> {
+    readonly value: DocFileMd<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMd<T>, customSchema: T);
     /**
-     * コンテンツ
+     * Content
      */
-    get content(): DocFileContentMdValue;
+    get content(): DocFileMdContentValue<T>;
     /**
-     * パス情報
+     * Path information
      */
     get path(): DocFilePath;
     /**
-     * コンテンツを更新
+     * Update content
      */
-    withContent(content: DocFileContentMdValue): DocFileMdEntity;
+    withContent(content: DocFileMdContentValue<T>): DocFileMdEntity<T>;
     /**
-     * パスを更新
+     * Update path
      */
-    withPath(path: DocFilePath): DocFileMdEntity;
+    withPath(path: DocFilePath): DocFileMdEntity<T>;
+    withMeta(meta: DocFileMdMetaValue<T>): DocFileMdEntity<T>;
+    withTitle(title: string): DocFileMdEntity<T>;
+    withDescription(description: string, defaultTitle?: string): DocFileMdEntity<T>;
     /**
-     * JSON形式に変換
+     * Convert to JSON format
      */
-    toJson(): DocFileMd;
+    toJson(): DocFileMd<T>;
 }
 
-type Props$6 = {
+type Props$6<T extends DocCustomSchema> = {
     path: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
+    customSchema: T;
+    config: DocClientConfig;
 };
 /**
- * ファイルの参照
+ * File reference
  */
-declare class DocFileMdReference {
+declare class DocFileMdReference<T extends DocCustomSchema> {
     private readonly props;
     private readonly pathSystem;
-    constructor(props: Props$6);
+    private readonly customSchema;
+    constructor(props: Props$6<T>);
     get fileSystem(): DocFileSystem;
     get basePath(): string;
     get path(): string;
@@ -1263,106 +1216,96 @@ declare class DocFileMdReference {
     get archivedPath(): string;
     get name(): string;
     get nameWithExtension(): string;
-    directory(): DocDirectoryReference;
-    read(): Promise<Error | DocFileMdEntity>;
-    /**
-     * ファイルの内容を読み込む
-     */
-    readContent(): Promise<Error | string>;
+    exists(): Promise<boolean>;
+    read(): Promise<DocFileMdEntity<T> | Error>;
     /**
-     * ファイルに内容を書き込む
+     * Read file content
      */
-    writeContent(content: string): Promise<void>;
+    readText(): Promise<Error | string>;
     /**
-     * Entityを書き込む
+     * Write entity
      */
-    write(entity: DocFileMdEntity): Promise<void>;
+    write(entity: DocFileMdEntity<T>): Promise<null>;
+    writeText(text: string): Promise<void>;
     /**
-     * 新しいファイルをデフォルトコンテンツで作成
+     * Create new file with default content
      */
     writeDefault(): Promise<void>;
     /**
-     * ファイルを削除
+     * Delete file
      */
     delete(): Promise<Error | null>;
     /**
-     * ファイルが存在するか確認（アーカイブも含む）
-     */
-    exists(): Promise<boolean>;
-    /**
-     * ファイルをコピー
+     * Copy file
      */
     copyTo(destinationPath: string): Promise<void>;
     /**
-     * ファイルを移動
+     * Move file
      */
     moveTo(destinationPath: string): Promise<void>;
     /**
-     * ファイルのサイズを取得（バイト単位）
+     * Move file to archive and return new reference
      */
-    size(): Promise<number>;
-    /**
-     * ファイルの最終更新日時を取得
-     */
-    lastModified(): Promise<Date>;
+    archive(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
     /**
-     * ファイルの作成日時を取得
+     * Restore file from archive and return new reference
      */
-    createdAt(): Promise<Date>;
+    restore(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
     /**
-     * ファイルをアーカイブに移動し、新しい参照を返す
+     * Get file size in bytes
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileMdReference>;
+    size(): Promise<number>;
     /**
-     * ファイルをアーカイブから復元し、新しい参照を返す
+     * Get file last modified time
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileMdReference>;
+    lastModified(): Promise<Date>;
     /**
-     * スキーマに基づいてリレーションを取得する
+     * Get file creation time
      */
-    relation(key: string): Promise<DocFileMdReference | Error | null>;
+    createdAt(): Promise<Date>;
+    directory(): DocDirectoryReference<T>;
     /**
-     * 同じディレクトリのindex.mdを取得する
+     * Get relation based on schema
      */
-    getDirectoryIndex(): Promise<DocFileIndexReference | null>;
+    relation<U extends DocCustomSchema = DocCustomSchema>(key: RelationKeys<T>, targetSchema?: U): Promise<DocFileMdReference<U> | Error | null>;
     /**
-     * 複数のリレーションを取得する
+     * Get index.md in the same directory
      */
-    relations(key: string): Promise<DocFileMdReference[]>;
+    directoryIndex(): Promise<DocFileIndexReference<T> | null>;
     /**
-     * スキーマに基づいて複数のリレーションを取得する
+     * Get multiple relations based on schema
      */
-    multiRelation(key: string): Promise<DocFileMdReference[]>;
+    relations<U extends DocCustomSchema = DocCustomSchema>(key: MultiRelationKeys<T>, customSchema?: U): Promise<DocFileMdReference<U>[]>;
     /**
-     * FrontMatterを型安全に読み込む
+     * File: Markdown > FrontMatter
      */
-    readFrontMatter<T extends z.ZodTypeAny = z.ZodTypeAny>(zodSchema?: T): Promise<DocFrontMatterMdValue<T> | Error>;
+    readFrontMatter(): Promise<DocFileMdMetaValue<T> | Error>;
     /**
-     * FrontMatterを型安全に更新
+     * File: Markdown > FrontMatter
      */
-    updateFrontMatter<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(key: string, value: unknown, zodSchema?: T): Promise<undefined | Error>;
+    updateFrontMatter<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): Promise<this | Error>;
 }
 
 /**
- * ドキュメントのファイル
+ * Unknown file entity
  */
 declare class DocFileUnknownEntity {
     readonly value: DocFileUnknown;
     constructor(value: DocFileUnknown);
     /**
-     * コンテンツ
+     * Content
      */
     get content(): string;
     /**
-     * パス情報
+     * Path information
      */
     get path(): DocFilePath;
     /**
-     * コンテンツを更新
+     * Update content
      */
     withContent(content: string): DocFileUnknownEntity;
     /**
-     * パスを更新
+     * Update path
      */
     withPath(path: DocFilePath): DocFileUnknownEntity;
     toJson(): DocFileUnknown;
@@ -1372,9 +1315,10 @@ type Props$5 = {
     path: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
+    config: DocClientConfig;
 };
 /**
- * ファイルの参照
+ * File reference
  */
 declare class DocFileUnknownReference {
     private readonly props;
@@ -1386,78 +1330,83 @@ declare class DocFileUnknownReference {
     get directoryPath(): string;
     get fileFullPath(): string;
     get durectoryPath(): string;
-    directory(): DocDirectoryReference;
-    read(): Promise<Error | DocFileMdEntity | DocFileUnknownEntity>;
+    directory<T extends DocCustomSchema>(customSchema: T): DocDirectoryReference<T>;
+    directory(): DocDirectoryReference<DocCustomSchema>;
+    read(): Promise<Error | DocFileUnknownEntity>;
     /**
-     * ファイルの内容を読み込む
+     * Read file content
      */
     readContent(): Promise<Error | string>;
     /**
-     * ファイルに内容を書き込む
+     * Write content to file
      */
     writeContent(content: string): Promise<void>;
     /**
-     * Entityを書き込む
+     * Write entity
      */
     write(entity: DocFileUnknownEntity): Promise<void>;
     /**
-     * 生のコンテンツを書き込む
+     * Write raw content
      */
     writeRaw(content: string): Promise<void>;
     /**
-     * ファイルを削除
+     * Delete file
      */
     delete(): Promise<Error | null>;
     /**
-     * ファイルが存在するか確認
+     * Check if file exists
      */
     exists(): Promise<boolean>;
     /**
-     * ファイルをコピー
+     * Copy file
      */
     copyTo(destinationPath: string): Promise<void>;
     /**
-     * ファイルを移動
+     * Move file
      */
     moveTo(destinationPath: string): Promise<void>;
     /**
-     * ファイルのサイズを取得（バイト単位）
+     * Get file size in bytes
      */
     size(): Promise<number>;
     /**
-     * ファイルの最終更新日時を取得
+     * Get file last modified time
      */
     lastModified(): Promise<Date>;
     /**
-     * ファイルの作成日時を取得
+     * Get file creation time
      */
     createdAt(): Promise<Date>;
     /**
-     * ファイルをアーカイブに移動し、新しい参照を返す
+     * Move file to archive and return new reference
      */
     archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
     /**
-     * ファイルをアーカイブから復元し、新しい参照を返す
+     * Restore file from archive and return new reference
      */
     restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
 }
 
-type Props$4 = {
+type Props$4<T extends DocCustomSchema> = {
+    customSchema: T;
     path: string;
     indexFileName: string;
     archiveDirectoryName: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
+    config: DocClientConfig;
 };
 /**
- * ディレクトリの参照
+ * Directory reference
  */
-declare class DocDirectoryReference {
+declare class DocDirectoryReference<T extends DocCustomSchema> {
     private readonly props;
     private readonly pathSystem;
-    constructor(props: Props$4);
+    private readonly customSchema;
+    constructor(props: Props$4<T>);
     get fileSystem(): DocFileSystem;
     get basePath(): string;
+    get config(): DocClientConfig;
     get relativePath(): string;
     get absolutePath(): string;
     get indexFileName(): string;
@@ -1465,57 +1414,39 @@ declare class DocDirectoryReference {
     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[]>;
-    /**
-     * Markdownファイルの参照とFrontMatterを型安全に取得
-     */
-    mdFilesWithFrontMatter<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(zodSchema: T): Promise<{
-        reference: DocFileMdReference;
-        frontMatter: DocFrontMatterMdValue<T> | Error;
-    }[]>;
-    file(fileName: string): DocFileMdReference | DocFileUnknownReference;
-    mdFile(fileName: string): DocFileMdReference;
-    readFiles(): Promise<(DocFileMdEntity | DocFileUnknownEntity)[]>;
-    readMdFiles(): Promise<DocFileMdEntity[]>;
-    /**
-     * Zodスキーマを使って型安全にMarkdownファイルのFrontMatterを読み込む
-     */
-    readMdFilesWithSchema<T extends FrontMatterSchema = typeof zDocFileMdFrontMatter>(zodSchema: T): Promise<{
-        entity: DocFileMdEntity;
-        frontMatter: DocFrontMatterMdValue<T>;
-    }[]>;
+    filesGenerator(): AsyncGenerator<DocFileMdReference<T> | DocFileUnknownReference, void, unknown>;
+    mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T>, void, unknown>;
+    files(): Promise<(DocFileMdReference<T> | DocFileUnknownReference)[]>;
+    mdFiles(): Promise<DocFileMdReference<T>[]>;
+    file(fileName: string): Promise<DocFileMdReference<T> | DocFileUnknownReference>;
+    mdFile(fileName: string): Promise<DocFileMdReference<T>>;
+    readFiles(): Promise<(DocFileMdEntity<T> | DocFileUnknownEntity)[]>;
+    readMdFiles(): Promise<DocFileMdEntity<T>[]>;
     readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
     /**
-     * サブディレクトリ名の一覧を取得
+     * Get list of subdirectory names
      */
     directoryNames(): Promise<string[]>;
     /**
-     * サブディレクトリの参照を取得
+     * Get subdirectory references
      */
-    directories(): Promise<DocDirectoryReference[]>;
+    directories(): Promise<DocDirectoryReference<never>[]>;
     /**
-     * 単一のサブディレクトリ参照を取得
+     * Get single subdirectory reference
      */
-    directory(directoryName: string): DocDirectoryReference;
-    indexFile(): DocFileIndexReference;
-    readIndexFile(): Promise<DocFileIndexEntity>;
-    writeFile(entity: DocFileIndexEntity | DocFileUnknownEntity | DocFileMdEntity): Promise<Error | null>;
+    directory(directoryName: string): DocDirectoryReference<T>;
+    indexFile(): DocFileIndexReference<T>;
+    readIndexFile(): Promise<DocFileIndexEntity<T>>;
+    writeFile(entity: DocFileIndexEntity<T> | DocFileMdEntity<T> | DocFileUnknownEntity): Promise<Error | null>;
     exists(): Promise<boolean>;
     /**
-     * 一意なファイル名を生成する
+     * Generate unique filename
      */
-    private generateUniqueFileName;
+    private uniqueFileName;
     /**
-     * 指定されたファイル名のファイルが存在するかチェック
+     * Create new Markdown file
      */
-    private fileExists;
-    /**
-     * 新しいMarkdownファイルを作成する
-     */
-    createMdFile(fileName?: string): Promise<DocFileMdReference>;
+    createMdFile(fileName?: string): Promise<DocFileMdReference<T>>;
 }
 
 type Props$3 = {
@@ -1525,7 +1456,7 @@ type Props$3 = {
     title: string;
 };
 /**
- * ツリーファイルノード値オブジェクト
+ * Tree file node value object
  */
 declare class DocTreeFileNodeValue {
     private readonly props;
@@ -1536,28 +1467,30 @@ declare class DocTreeFileNodeValue {
     get title(): string;
     get type(): "file";
     /**
-     * プレーンオブジェクトに変換
+     * Convert to plain object
      */
     toJson(): DocTreeFileNode;
     /**
-     * プロパティから作成
+     * Create from properties
      */
     static from(props: Props$3): DocTreeFileNodeValue;
     /**
-     * JSONオブジェクトから作成
+     * Create from JSON object
      */
     static fromJson(json: unknown): DocTreeFileNodeValue;
 }
 
+type DocTreeNodeValue = DocTreeFileNodeValue | DocTreeDirectoryNodeValue;
+
 type Props$2 = {
     name: string;
     path: string;
     icon: string;
     title: string;
-    children: (DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[];
+    children: DocTreeNodeValue[];
 };
 /**
- * ツリーディレクトリノード値オブジェクト
+ * Tree directory node value object
  */
 declare class DocTreeDirectoryNodeValue {
     private readonly props;
@@ -1566,18 +1499,18 @@ declare class DocTreeDirectoryNodeValue {
     get path(): string;
     get icon(): string;
     get title(): string;
-    get children(): (DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[];
+    get children(): DocTreeNodeValue[];
     get type(): "directory";
     /**
-     * プレーンオブジェクトに変換
+     * Convert to plain object
      */
     toJson(): DocTreeDirectoryNode;
     /**
-     * プロパティから作成
+     * Create from properties
      */
     static from(props: Props$2): DocTreeDirectoryNodeValue;
     /**
-     * JSONオブジェクトから作成
+     * Create from JSON object
      */
     static fromJson(json: unknown): DocTreeDirectoryNodeValue;
 }
@@ -1587,83 +1520,85 @@ type Props$1 = {
     pathSystem: DocPathSystem;
     indexFileName: string;
     archiveDirectoryName: string;
+    config: DocClientConfig;
 };
 /**
- * ファイルツリー構築システム
+ * File tree building system
  */
 declare class DocFileTreeSystem {
     private readonly props;
+    private readonly config;
     constructor(props: Props$1);
     /**
-     * ファイルツリーを再帰的に構築
+     * Build file tree recursively
      */
-    buildFileTree(directoryPath?: string): Promise<(DocTreeFileNodeValue | DocTreeDirectoryNodeValue)[]>;
+    buildFileTree(directoryPath?: string): Promise<DocTreeNodeValue[]>;
     /**
-     * ファイルノードを作成
+     * Create file node
      */
     private createFileNode;
     /**
-     * ディレクトリノードを作成
+     * Create directory node
      */
     private createDirectoryNode;
     /**
-     * インデックスファイル参照を作成
+     * Create index file reference
      */
     private createIndexFileReference;
     /**
-     * MDファイル参照を作成
+     * Create MD file reference
      */
     private createMdFileReference;
     /**
-     * ディレクトリツリーを再帰的に構築（ディレクトリのみ）
+     * Build directory tree recursively (directories only)
      */
     buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[]>;
     /**
-     * ディレクトリツリー用のディレクトリノードを作成
+     * Create directory node for directory tree
      */
     private createDirectoryNodeForTree;
 }
 
 /**
- * Markdownの解析と処理システム
+ * Markdown parsing and processing system
  */
 declare class DocMarkdownSystem {
     private readonly frontMatterSeparator;
     constructor();
     /**
-     * FrontMatterの区切り線を検出
+     * Detect FrontMatter separator line
      */
     private detectFrontMatterSeparator;
     /**
-     * FrontMatterを抽出
+     * Extract FrontMatter
      */
     extractFrontMatter(text: string): string | null;
     /**
-     * FrontMatterを除去したbody（titleとdescriptionを含む）
+     * Extract body without FrontMatter (includes title and description)
      */
     extractBody(text: string): string;
     /**
-     * タイトル
+     * Extract title
      */
     extractTitle(text: string): string | null;
     /**
-     * 説明（タイトルの後の最初の段落）
+     * Extract description (first paragraph after title)
      */
     extractDescription(text: string): string | null;
     /**
-     * body内のタイトルを更新
+     * Update title in body
      */
     updateTitle(text: string, newTitle: string): string;
     /**
-     * body内の説明を更新
+     * Update description in body
      */
     updateDescription(text: string, newDescription: string, defaultTitle: string): string;
     /**
-     * 空行をスキップ
+     * Skip empty lines
      */
     private skipEmptyLines;
     /**
-     * Markdownテキストを生成（タイトル + 説明 + body）
+     * Generate Markdown text (title + description + body)
      */
     static from(title: string, description: string, body: string): string;
 }
@@ -1674,327 +1609,109 @@ type Props = {
     markdownSystem?: DocMarkdownSystem;
     fileTreeSystem?: DocFileTreeSystem;
     /**
-     * default: "index.md"
-     */
-    indexFileName?: string;
-    /**
-     * default: "_"
+     * Configuration
      */
-    archiveDirectoryName?: string;
+    config?: DocClientConfig;
 };
 declare class DocClient {
     readonly fileSystem: DocFileSystem;
     readonly pathSystem: DocPathSystem;
     readonly markdownSystem: DocMarkdownSystem;
     readonly fileTreeSystem: DocFileTreeSystem;
-    readonly indexFileName: string;
-    readonly archiveDirectoryName: string;
+    readonly config: DocClientConfig;
     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)[]>;
-    /**
-     * ディレクトリツリーを取得（ディレクトリのみ）
-     */
+    file(relativePath: string): DocFileMdReference<DocCustomSchema> | DocFileUnknownReference;
+    file<T extends DocCustomSchema>(relativePath: string, customSchema: T): DocFileMdReference<T> | DocFileUnknownReference;
+    mdFile(relativePath: string): DocFileMdReference<DocCustomSchema>;
+    mdFile<T extends DocCustomSchema>(relativePath: string, customSchema: T): DocFileMdReference<T>;
+    indexFile(relativePath: string): DocFileIndexReference<DocCustomSchema>;
+    indexFile<T extends DocCustomSchema>(relativePath: string, customSchema: T): DocFileIndexReference<T>;
+    directory(relativePath: string): DocDirectoryReference<DocCustomSchema>;
+    directory<T extends DocCustomSchema>(relativePath: string, customSchema: T): DocDirectoryReference<T>;
+    fileTree(directoryPath?: string): Promise<DocTreeNode[]>;
     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;
+ * In-memory file system for testing
+ */
+declare class DocFileSystemDebug extends DocFileSystem {
+    private files;
+    private readonly _pathSystem;
+    constructor(props: {
+        basePath: string;
+        pathSystem: DocPathSystem;
+    });
+    /**
+     * PathSystem accessor (for testing)
+     */
+    getPathSystem(): DocPathSystem;
+    /**
+     * Factory method for testing
+     */
+    static createWithFiles(props: {
+        basePath?: string;
+        fileContents?: Record<string, string>;
+    }): DocFileSystemDebug;
+    readFile(filePath: string): Promise<string | null>;
+    writeFile(filePath: string, content: string): Promise<void>;
+    deleteFile(filePath: string): Promise<Error | null>;
+    exists(filePath: string): Promise<boolean>;
+    copyFile(source: string, destination: string): Promise<void>;
+    moveFile(source: string, destination: string): Promise<void>;
+    readDirectory(directoryPath: string): Promise<string[]>;
+    readDirectoryRecursive(directoryPath: string): Promise<string[]>;
+    readDirectoryFilePaths(directoryPath: string): Promise<string[]>;
+    createDirectory(_directoryPath: string): Promise<void>;
+    deleteDirectory(directoryPath: string): Promise<void>;
+    getFileSize(filePath: string): Promise<number>;
+    getFileModifiedTime(filePath: string): Promise<Date>;
+    getFileCreatedTime(filePath: string): Promise<Date>;
+    isDirectory(relativePath: string): Promise<boolean>;
+    isFile(relativePath: string): Promise<boolean>;
     /**
-     * 隠しディレクトリかどうか
+     * Get list of entries in directory
      */
-    get isHidden(): boolean;
+    readDirectoryFileNames(directoryPath?: string): Promise<string[]>;
     /**
-     * ルートディレクトリかどうか
+     * Check if directory exists
      */
-    get isRoot(): boolean;
+    directoryExists(relativePath: string): Promise<boolean>;
     /**
-     * 絶対パス
+     * Check if file exists
      */
-    get fullPath(): string;
+    fileExists(relativePath: string): Promise<boolean>;
     /**
-     * インデックスファイルのパスを取得
+     * Create directory if it doesn't exist
      */
-    get indexFile(): DocFilePathValue;
+    ensureDirectoryExists(_relativePath: string): Promise<void>;
     /**
-     * ファイルパスを作成
+     * Clear all files
      */
-    file(fileName: string): DocFilePathValue;
+    clear(): void;
     /**
-     * サブディレクトリのパスを作成
+     * Check file existence (for testing)
      */
-    subdirectory(dirName: string): DocDirectoryPathValue;
+    hasFile(filePath: string): boolean;
     /**
-     * 相対パスからインスタンスを生成（DI対応）
+     * Get file content (sync version, for testing)
      */
-    static fromPathWithSystem(dirPath: string, basePath: string, pathSystem: DocPathSystem): DocDirectoryPathValue;
+    getFileContent(filePath: string): string | undefined;
     /**
-     * JSON形式で出力
+     * Get all file paths (for testing)
      */
-    toJson(): DocDirectoryPath;
+    getAllFilePaths(): string[];
     /**
-     * パスが等しいかどうか
+     * Get file count (for testing)
      */
-    equals(other: DocDirectoryPathValue): boolean;
+    getFileCount(): number;
     /**
-     * 指定されたディレクトリがこのディレクトリの子孫かどうか
+     * Setup test data
      */
-    contains(other: DocDirectoryPathValue): boolean;
+    setupTestFiles(files: Record<string, string>): void;
 }
 
-/**
- * スキーマフィールドファクトリ
- */
-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;
-}
+type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
 
-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 DocSchemaFieldMinimal, 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 DocSchemaMinimal, type DocSchemaRecord, DocSchemaValue, type DocTreeDirectoryNode, DocTreeDirectoryNodeValue, type DocTreeFileNode, DocTreeFileNodeValue, type DocTreeNode, type FieldType, DocFileTreeSystem as FileTreeSystem, type FrontMatterSchema, type RelationFieldTypes, zDocFile, zDocFileContentIndex, zDocFileContentMd, zDocFileIndex, zDocFileIndexFrontMatter, zDocFileMd, zDocFileMdFrontMatter, zDocFilePath, zDocFileUnknown, zDocRelation, zDocRelationField, zDocRelationFile, zDocSchema, zDocSchemaField, zDocSchemaFieldBoolean, zDocSchemaFieldMinimal, zDocSchemaFieldMultiBoolean, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldRelation, zDocSchemaFieldSelectNumber, zDocSchemaFieldSelectText, zDocSchemaFieldText, zDocSchemaFieldType, zDocSchemaMinimal };
+export { type BaseFieldValueType, DocClient, type DocClientConfig, type DocCustomSchema, type DocCustomSchemaField, type DocCustomSchemaFieldBoolean, type DocCustomSchemaFieldMultiNumber, type DocCustomSchemaFieldMultiRelation, type DocCustomSchemaFieldMultiSelectNumber, type DocCustomSchemaFieldMultiSelectText, type DocCustomSchemaFieldMultiText, type DocCustomSchemaFieldNumber, type DocCustomSchemaFieldRelation, type DocCustomSchemaFieldSelectNumber, type DocCustomSchemaFieldSelectText, type DocCustomSchemaFieldText, type DocDirectory, DocDirectoryReference, type DocFile, type DocFileEntity, type DocFileIndex, type DocFileIndexContent, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, type DocFileMd, type DocFileMdContent, DocFileMdEntity, type DocFileMdMeta, DocFileMdReference, type DocFilePath, DocFileRelationReference, DocFileSystem, DocFileSystemDebug, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, type DocMetaField, type DocMetaFieldBoolean, type DocMetaFieldMultiBoolean, type DocMetaFieldMultiNumber, type DocMetaFieldMultiRelation, type DocMetaFieldMultiSelectNumber, type DocMetaFieldMultiSelectText, type DocMetaFieldMultiText, type DocMetaFieldNumber, type DocMetaFieldRelation, type DocMetaFieldSelectNumber, type DocMetaFieldSelectText, type DocMetaFieldText, type DocMetaFieldType, type DocMetaFieldTypeBoolean, type DocMetaFieldTypeNumber, type DocMetaFieldTypeRelation, type DocMetaFieldTypeSelectNumber, type DocMetaFieldTypeSelectText, type DocMetaFieldTypeText, DocPathSystem, type DocRelation, type DocRelationField, type DocRelationFile, type DocSchemaFieldBoolean, type DocSchemaFieldMultiNumber, type DocSchemaFieldMultiRelation, type DocSchemaFieldMultiSelectNumber, type DocSchemaFieldMultiSelectText, type DocSchemaFieldMultiText, type DocSchemaFieldNumber, type DocSchemaFieldRelation, type DocSchemaFieldSelectNumber, type DocSchemaFieldSelectText, type DocSchemaFieldText, type DocSchemaRelationFieldUnion, type DocTreeDirectoryNode, type DocTreeFileNode, type DocTreeNode, type Equals, type ExtractFieldType, type ExtractIndexFieldType, type ExtractRequired, type FieldValueType, DocFileTreeSystem as FileTreeSystem, type GetIndexFieldType, type GetIndexFieldValueType, type GetValueType, type MultiRelationKeys, type OptionalKeys, type RecordKey, type RelationKeys, type RequiredKeys, type SchemaToValueType, zDocClientConfig, zDocCustomSchemaField, zDocCustomSchemaFieldBoolean, zDocCustomSchemaFieldMultiNumber, zDocCustomSchemaFieldMultiRelation, zDocCustomSchemaFieldMultiSelectNumber, zDocCustomSchemaFieldMultiSelectText, zDocCustomSchemaFieldMultiText, zDocCustomSchemaFieldNumber, zDocCustomSchemaFieldRelation, zDocCustomSchemaFieldSelectNumber, zDocCustomSchemaFieldSelectText, zDocCustomSchemaFieldText, zDocFileIndexSchemaField, zDocFilePath, zDocFileUnknown, zDocMetaField, zDocMetaFieldBoolean, zDocMetaFieldMultiBoolean, zDocMetaFieldMultiNumber, zDocMetaFieldMultiRelation, zDocMetaFieldMultiSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiText, zDocMetaFieldNumber, zDocMetaFieldRelation, zDocMetaFieldSelectNumber, zDocMetaFieldSelectText, zDocMetaFieldText, zDocMetaFieldType, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeNumber, zDocMetaFieldTypeRelation, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeText, zDocRelation, zDocRelationField, zDocRelationFile, zDocSchemaFieldBoolean, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldRelation, zDocSchemaFieldSelectNumber, zDocSchemaFieldSelectText, zDocSchemaFieldText };