@interactive-inc/docs-client 0.0.11 → 0.0.13

package/build/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 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, zDocFileIndexSchema, zDocFileMd, zDocFileMdContent, zDocFileMdMeta, zDocMetaFieldTypeMultiNumber, zDocMetaFieldTypeMultiRelation, zDocMetaFieldTypeMultiSelectNumber, zDocMetaFieldTypeMultiSelectText, zDocMetaFieldTypeMultiText, zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } 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
@@ -142,7 +142,7 @@ declare class DocFileSystem {
 /**
  * Single boolean type schema field
  */
-declare class DocSchemaFieldBooleanSingleValue<T extends RecordKey> {
+declare class DocSchemaFieldBooleanValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldBoolean;
     constructor(key: T, value: DocSchemaFieldBoolean);
@@ -159,8 +159,8 @@ declare class DocSchemaFieldBooleanSingleValue<T extends RecordKey> {
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldBooleanSingleValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanSingleValue<RecordKey>;
+    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
 }
 
 /**
@@ -168,8 +168,8 @@ declare class DocSchemaFieldBooleanSingleValue<T extends RecordKey> {
  */
 declare class DocSchemaFieldMultiNumberValue<T extends RecordKey> {
     readonly key: T;
-    readonly value: DocFieldMultiNumber;
-    constructor(key: T, value: DocFieldMultiNumber);
+    readonly value: DocSchemaFieldMultiNumber;
+    constructor(key: T, value: DocSchemaFieldMultiNumber);
     get type(): "multi-number";
     get required(): boolean;
     get title(): string;
@@ -192,8 +192,8 @@ declare class DocSchemaFieldMultiNumberValue<T extends RecordKey> {
  */
 declare class DocSchemaFieldMultiRelationValue<T extends RecordKey> {
     readonly key: T;
-    readonly value: DocFieldMultiRelation;
-    constructor(key: T, value: DocFieldMultiRelation);
+    readonly value: DocSchemaFieldMultiRelation;
+    constructor(key: T, value: DocSchemaFieldMultiRelation);
     get type(): "multi-relation";
     get required(): boolean;
     get title(): string;
@@ -269,8 +269,8 @@ declare class DocSchemaFieldMultiSelectTextValue<T extends RecordKey> {
  */
 declare class DocSchemaFieldMultiTextValue<T extends RecordKey> {
     readonly key: T;
-    readonly value: DocFieldMultiText;
-    constructor(key: T, value: DocFieldMultiText);
+    readonly value: DocSchemaFieldMultiText;
+    constructor(key: T, value: DocSchemaFieldMultiText);
     get type(): "multi-text";
     get required(): boolean;
     get title(): string;
@@ -291,7 +291,7 @@ declare class DocSchemaFieldMultiTextValue<T extends RecordKey> {
 /**
  * Single number type schema field
  */
-declare class DocSchemaFieldNumberSingleValue<T extends RecordKey> {
+declare class DocSchemaFieldNumberValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldNumber;
     constructor(key: T, value: DocSchemaFieldNumber);
@@ -308,14 +308,14 @@ declare class DocSchemaFieldNumberSingleValue<T extends RecordKey> {
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldNumberSingleValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberSingleValue<RecordKey>;
+    static empty(key: RecordKey): DocSchemaFieldNumberValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberValue<RecordKey>;
 }
 
 /**
  * Single relation type schema field
  */
-declare class DocSchemaFieldRelationSingleValue<T extends RecordKey> {
+declare class DocSchemaFieldRelationValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldRelation;
     constructor(key: T, value: DocSchemaFieldRelation);
@@ -333,14 +333,14 @@ declare class DocSchemaFieldRelationSingleValue<T extends RecordKey> {
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldRelationSingleValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldRelationSingleValue<RecordKey>;
+    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<T extends RecordKey> {
+declare class DocSchemaFieldSelectNumberValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldSelectNumber;
     constructor(key: T, value: DocSchemaFieldSelectNumber);
@@ -359,14 +359,14 @@ declare class DocSchemaFieldSelectNumberSingleValue<T extends RecordKey> {
      */
     validate(value: unknown): boolean;
     toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberSingleValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberSingleValue<RecordKey>;
+    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 DocSchemaFieldSelectTextSingleValue<T extends RecordKey> {
+declare class DocSchemaFieldSelectTextValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldSelectText;
     constructor(key: T, value: DocSchemaFieldSelectText);
@@ -385,14 +385,14 @@ declare class DocSchemaFieldSelectTextSingleValue<T extends RecordKey> {
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextSingleValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextSingleValue<RecordKey>;
+    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 DocSchemaFieldTextSingleValue<T extends RecordKey> {
+declare class DocSchemaFieldTextValue<T extends RecordKey> {
     readonly key: T;
     readonly value: DocSchemaFieldText;
     constructor(key: T, value: DocSchemaFieldText);
@@ -409,8 +409,8 @@ declare class DocSchemaFieldTextSingleValue<T extends RecordKey> {
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldTextSingleValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldTextSingleValue<RecordKey>;
+    static empty(key: RecordKey): DocSchemaFieldTextValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldTextValue<RecordKey>;
 }
 
 /**
@@ -428,11 +428,11 @@ type DocSchemaFieldBoolean = z.infer<typeof zDocSchemaFieldBoolean>;
 /**
  * Multi-text field type
  */
-type DocFieldMultiText = z.infer<typeof zDocSchemaFieldMultiText>;
+type DocSchemaFieldMultiText = z.infer<typeof zDocSchemaFieldMultiText>;
 /**
  * Multi-number field type
  */
-type DocFieldMultiNumber = z.infer<typeof zDocSchemaFieldMultiNumber>;
+type DocSchemaFieldMultiNumber = z.infer<typeof zDocSchemaFieldMultiNumber>;
 /**
  * Relation field type
  */
@@ -440,7 +440,7 @@ type DocSchemaFieldRelation = z.infer<typeof zDocSchemaFieldRelation>;
 /**
  * Multi-relation field type
  */
-type DocFieldMultiRelation = z.infer<typeof zDocSchemaFieldMultiRelation>;
+type DocSchemaFieldMultiRelation = z.infer<typeof zDocSchemaFieldMultiRelation>;
 /**
  * Select text field type
  */
@@ -512,7 +512,7 @@ type DocCustomSchema<T extends RecordKey = RecordKey> = Record<T, DocCustomSchem
 /**
  * Union type for relation fields
  */
-type DocSchemaRelationFieldUnion = DocSchemaFieldRelation | DocFieldMultiRelation;
+type DocSchemaRelationFieldUnion = DocSchemaFieldRelation | DocSchemaFieldMultiRelation;
 /**
  * File node type (for files only)
  */
@@ -538,10 +538,6 @@ type DocTreeDirectoryNode = {
  * Unified tree node type
  */
 type DocTreeNode = DocTreeFileNode | DocTreeDirectoryNode;
-/**
- * Alias for backward compatibility
- */
-type DocFileNode = DocTreeNode;
 /**
  * Index file type
  */
@@ -551,9 +547,6 @@ type DocFileIndex<T extends DocCustomSchema> = {
     isArchived: boolean;
     content: DocFileIndexContent<T>;
 };
-/**
- * Test helper types
- */
 /**
  * Type to check if two types are equal
  */
@@ -611,17 +604,6 @@ type DocRelationField = z.infer<typeof zDocRelationField>;
  * File path information type
  */
 type DocFilePath = z.infer<typeof zDocFilePath>;
-type DocSchemaFieldTypeText = z.infer<typeof zDocSchemaFieldText>;
-type DocSchemaFieldTypeNumber = z.infer<typeof zDocSchemaFieldNumber>;
-type DocSchemaFieldTypeBoolean = z.infer<typeof zDocSchemaFieldBoolean>;
-type DocSchemaFieldTypeMultiText = z.infer<typeof zDocSchemaFieldMultiText>;
-type DocSchemaFieldTypeMultiNumber = z.infer<typeof zDocSchemaFieldMultiNumber>;
-type DocSchemaFieldTypeRelation = z.infer<typeof zDocSchemaFieldRelation>;
-type DocSchemaFieldTypeMultiRelation = z.infer<typeof zDocSchemaFieldMultiRelation>;
-type DocSchemaFieldTypeSelectText = z.infer<typeof zDocSchemaFieldSelectText>;
-type DocSchemaFieldTypeSelectNumber = z.infer<typeof zDocSchemaFieldSelectNumber>;
-type DocSchemaFieldTypeMultiSelectText = z.infer<typeof zDocSchemaFieldMultiSelectText>;
-type DocSchemaFieldTypeMultiSelectNumber = z.infer<typeof zDocSchemaFieldMultiSelectNumber>;
 /**
  * Markdown content information type
  */
@@ -656,10 +638,6 @@ type RecordKey = string | number | symbol;
  * DocClient configuration
  */
 type DocClientConfig = z.infer<typeof zDocClientConfig>;
-/**
- * DocClient configuration input (all properties optional)
- */
-type DocClientConfigInput = z.input<typeof zDocClientConfig>;
 /**
  * Type definitions for DocFileMdMetaValue
  */
@@ -708,7 +686,7 @@ type ExtractIndexFieldType<T> = T extends {
 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" ? DocSchemaFieldTextSingleValue<K> : Type extends "number" ? DocSchemaFieldNumberSingleValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanSingleValue<K> : Type extends "relation" ? DocSchemaFieldRelationSingleValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextSingleValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberSingleValue<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;
+} ? 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 file
@@ -839,15 +817,15 @@ declare class DocFileIndexSchemaValue<T extends DocCustomSchema> {
      * Get field with specified field name
      * Returns type-safe specific field Value object
      */
-    field<K extends keyof T>(key: K): T[K]["type"] extends infer Type ? Type extends "text" ? DocSchemaFieldTextSingleValue<K> : Type extends "number" ? DocSchemaFieldNumberSingleValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanSingleValue<K> : Type extends "relation" ? DocSchemaFieldRelationSingleValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextSingleValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberSingleValue<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): DocSchemaFieldRelationSingleValue<K>;
+    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>;
     /**
      * Get all fields
      * Note: For type safety, it's recommended to use field() method individually
      */
     get fields(): DocFileIndexSchema<keyof T>[keyof T][];
-    get relationFields(): (DocSchemaFieldRelationSingleValue<string> | DocSchemaFieldMultiRelationValue<string>)[];
+    get relationFields(): (DocSchemaFieldRelationValue<string> | DocSchemaFieldMultiRelationValue<string>)[];
     toJson(): DocFileIndexSchema<keyof T>;
     /**
      * Create empty schema entity
@@ -1656,144 +1634,84 @@ declare class DocClient {
 }
 
 /**
- * Value object for file path information
- */
-declare class DocFilePathValue {
-    readonly value: DocFilePath;
-    private readonly pathSystem;
-    constructor(value: DocFilePath, pathSystem: DocPathSystem);
-    /**
-     * File name without extension
-     */
-    get name(): string;
-    /**
-     * File path (relative path)
-     */
-    get path(): string;
-    /**
-     * File name with extension
-     */
-    get nameWithExtension(): string;
-    /**
-     * Full path (absolute path)
-     */
-    get fullPath(): string;
-    /**
-     * Directory path
-     */
-    get directoryPath(): string;
-    /**
-     * Extension
-     */
-    get extension(): string;
-    /**
-     * Whether the file is archived
-     */
-    get isArchived(): boolean;
-    /**
-     * Create instance from relative path (DI support)
-     */
-    static fromPathWithSystem(filePath: string, pathSystem: DocPathSystem, basePath?: string): DocFilePathValue;
-    /**
-     * Export as JSON format
-     */
-    toJson(): DocFilePath;
-}
-
-type Value = {
-    path: string;
-    name: string;
-    fullPath: string;
-};
-/**
- * Value object representing a directory path
- */
-declare class DocDirectoryPathValue {
-    private readonly value;
-    private readonly pathSystem;
-    constructor(value: Value, pathSystem: DocPathSystem);
-    /**
-     * Relative directory path
-     */
-    get path(): string;
-    /**
-     * Directory name
-     */
-    get name(): string;
-    /**
-     * Get parent directory path
-     */
-    get parent(): DocDirectoryPathValue | null;
-    /**
-     * Parent directory path
-     */
-    get parentPath(): string;
-    /**
-     * Depth (number of directory levels)
-     */
-    get depth(): number;
-    /**
-     * Path segments (array of directories)
-     */
-    get segments(): string[];
-    /**
-     * Relative path from root (without leading slash)
-     */
-    get normalizedPath(): string;
-    /**
-     * Whether this is an archive directory (directory name is "_")
-     */
-    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>;
     /**
-     * Whether this is a hidden directory
+     * Get list of entries in directory
      */
-    get isHidden(): boolean;
+    readDirectoryFileNames(directoryPath?: string): Promise<string[]>;
     /**
-     * Whether this is the root directory
+     * Check if directory exists
      */
-    get isRoot(): boolean;
+    directoryExists(relativePath: string): Promise<boolean>;
     /**
-     * Absolute path
+     * Check if file exists
      */
-    get fullPath(): string;
+    fileExists(relativePath: string): Promise<boolean>;
     /**
-     * Get index file path
+     * Create directory if it doesn't exist
      */
-    get indexFile(): DocFilePathValue;
+    ensureDirectoryExists(_relativePath: string): Promise<void>;
     /**
-     * Create file path
+     * Clear all files
      */
-    file(fileName: string): DocFilePathValue;
+    clear(): void;
     /**
-     * Create subdirectory path
+     * Check file existence (for testing)
      */
-    subdirectory(dirName: string): DocDirectoryPathValue;
+    hasFile(filePath: string): boolean;
     /**
-     * Create instance from relative path (DI support)
+     * Get file content (sync version, for testing)
      */
-    static fromPathWithSystem(dirPath: string, basePath: string, pathSystem: DocPathSystem): DocDirectoryPathValue;
+    getFileContent(filePath: string): string | undefined;
     /**
-     * Export as JSON format
+     * Get all file paths (for testing)
      */
-    toJson(): Value;
+    getAllFilePaths(): string[];
     /**
-     * Check if paths are equal
+     * Get file count (for testing)
      */
-    equals(other: DocDirectoryPathValue): boolean;
+    getFileCount(): number;
     /**
-     * Check if specified directory is a descendant of this directory
+     * Setup test data
      */
-    contains(other: DocDirectoryPathValue): boolean;
+    setupTestFiles(files: Record<string, string>): void;
 }
 
-/**
- * Multiple value type fields (multi-* types)
- */
-type DocSchemaFieldMultipleTypes<T extends RecordKey> = DocSchemaFieldMultiTextValue<T> | DocSchemaFieldMultiNumberValue<T> | DocSchemaFieldMultiSelectTextValue<T> | DocSchemaFieldMultiSelectNumberValue<T> | DocSchemaFieldMultiRelationValue<T>;
-/**
- * Single value type fields
- */
-type DocSchemaFieldSingleTypes<T extends RecordKey> = DocSchemaFieldTextSingleValue<T> | DocSchemaFieldNumberSingleValue<T> | DocSchemaFieldBooleanSingleValue<T> | DocSchemaFieldSelectTextSingleValue<T> | DocSchemaFieldSelectNumberSingleValue<T> | DocSchemaFieldRelationSingleValue<T>;
-type DocSchemaFieldValue<T extends RecordKey> = DocSchemaFieldSingleTypes<T> | DocSchemaFieldMultipleTypes<T>;
+type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
 
-export { type BaseFieldValueType, DocClient, type DocClientConfig, type DocClientConfigInput, 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, DocDirectoryPathValue, DocDirectoryReference, type DocFieldMultiNumber, type DocFieldMultiRelation, type DocFieldMultiText, type DocFile, type DocFileIndex, type DocFileIndexContent, DocFileIndexContentValue, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexMetaValue, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, DocFileIndexSchemaValue, type DocFileMd, type DocFileMdContent, DocFileMdContentValue, DocFileMdEntity, type DocFileMdMeta, DocFileMdMetaValue, DocFileMdReference, type DocFileNode, type DocFilePath, DocFilePathValue, DocFileRelationReference, DocFileSystem, 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, DocRelationFileValue, DocRelationValue, type DocSchemaFieldBoolean, DocSchemaFieldBooleanSingleValue, type DocSchemaFieldMultiSelectNumber, type DocSchemaFieldMultiSelectText, type DocSchemaFieldNumber, DocSchemaFieldMultiNumberValue as DocSchemaFieldNumberMultipleValue, DocSchemaFieldNumberSingleValue, type DocSchemaFieldRelation, DocSchemaFieldMultiRelationValue as DocSchemaFieldRelationMultipleValue, DocSchemaFieldRelationSingleValue, type DocSchemaFieldSelectNumber, DocSchemaFieldMultiSelectNumberValue as DocSchemaFieldSelectNumberMultipleValue, DocSchemaFieldSelectNumberSingleValue, type DocSchemaFieldSelectText, DocSchemaFieldMultiSelectTextValue as DocSchemaFieldSelectTextMultipleValue, DocSchemaFieldSelectTextSingleValue, type DocSchemaFieldText, DocSchemaFieldMultiTextValue as DocSchemaFieldTextMultipleValue, DocSchemaFieldTextSingleValue, type DocSchemaFieldTypeBoolean, type DocSchemaFieldTypeMultiNumber, type DocSchemaFieldTypeMultiRelation, type DocSchemaFieldTypeMultiSelectNumber, type DocSchemaFieldTypeMultiSelectText, type DocSchemaFieldTypeMultiText, type DocSchemaFieldTypeNumber, type DocSchemaFieldTypeRelation, type DocSchemaFieldTypeSelectNumber, type DocSchemaFieldTypeSelectText, type DocSchemaFieldTypeText, type DocSchemaFieldValue, type DocSchemaRelationFieldUnion, type DocTreeDirectoryNode, DocTreeDirectoryNodeValue, type DocTreeFileNode, DocTreeFileNodeValue, 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 };
+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 };