@interactive-inc/docs-client 1.0.20 → 1.1.1

package/build/index.d.ts

@@ -1,334 +1,614 @@
+import { D as DocFileSystemInterface, a as DocPathSystem } from './doc-file-system.interface-C5vpYrOL.js';
 import { z } from 'zod';
 import { zDocFileMd, zDocFileUnknown, zDocClientConfig, zDocFilePath, zDocFileIndexSchemaField, zDocSchemaFieldText, zDocSchemaFieldNumber, zDocSchemaFieldBoolean, zDocSchemaFieldRelation, zDocSchemaFieldSelectText, zDocSchemaFieldSelectNumber, zDocSchemaFieldMultiText, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiSelectNumber, zDocFileIndex, zDocRelation, zDocRelationFile, zDocMetaFieldRelation, zDocMetaFieldMultiRelation, zDocMetaFieldText, zDocMetaFieldNumber, zDocMetaFieldBoolean, zDocMetaFieldMultiText, zDocMetaFieldMultiNumber, zDocRelationField, zDocMetaField, zDocMetaFieldSelectText, zDocMetaFieldSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiSelectNumber, zDocMetaFieldTypeText, zDocMetaFieldTypeNumber, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeRelation, zDocMetaFieldType } from './models.js';
-export { zDocCustomSchema, zDocCustomSchemaField, zDocCustomSchemaFieldBoolean, zDocCustomSchemaFieldMultiNumber, zDocCustomSchemaFieldMultiRelation, zDocCustomSchemaFieldMultiSelectNumber, zDocCustomSchemaFieldMultiSelectText, zDocCustomSchemaFieldMultiText, zDocCustomSchemaFieldNumber, zDocCustomSchemaFieldRelation, zDocCustomSchemaFieldSelectNumber, zDocCustomSchemaFieldSelectText, zDocCustomSchemaFieldText, zDocFile, zDocFileDirectory, zDocFileIndexContent, zDocFileIndexMeta, zDocFileIndexMetaInput, zDocFileIndexSchema, zDocFileIndexSchemaInput, zDocFileMdContent, zDocFileMdContentInput, zDocFileMdInput, zDocFileMdMeta, zDocFileMdMetaInput, zDocMetaFieldTypeMultiNumber, zDocMetaFieldTypeMultiRelation, zDocMetaFieldTypeMultiSelectNumber, zDocMetaFieldTypeMultiSelectText, zDocMetaFieldTypeMultiText, zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } from './models.js';
-import { Octokit } from '@octokit/rest';
 
 /**
- * Path operations system
+ * Single boolean type schema field
  */
-declare class DocPathSystem {
-    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;
+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;
     /**
-     * Check if path is absolute
+     * Validate value type
      */
-    isAbsolute(path: string): boolean;
+    validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
 }
 
 /**
- * Meta
+ * Multiple relation type schema field
  */
-declare class DocFileMdMetaValue<T extends DocCustomSchema> {
-    readonly value: SchemaToValueType<T>;
-    readonly customSchema: T;
-    constructor(value: SchemaToValueType<T>, customSchema: T);
-    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;
-    hasKey(key: keyof T): boolean;
-    toJson(): SchemaToValueType<T>;
-    toYaml(): string;
-    private validateValue;
-    private getValueField;
+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 path(): string;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isRelation = true;
     /**
-     * Generate from Markdown text
+     * Validate value
      */
-    static fromYamlText<T extends DocCustomSchema>(yamlText: string, customSchema: T): DocFileMdMetaValue<T>;
-    static empty<T extends DocCustomSchema>(customSchema: T): DocFileMdMetaValue<T>;
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiRelationValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiRelationValue<RecordKey>;
 }
 
 /**
- * File: Markdown > Content
+ * Multiple select number type schema field
  */
-declare class DocFileMdContentValue<T extends DocCustomSchema> {
-    readonly value: DocFileMdContent<T>;
-    private readonly customSchema;
-    constructor(value: DocFileMdContent<T>, customSchema: T);
-    /**
-     * Content body (does not include frontMatter)
-     */
-    get body(): string;
-    /**
-     * Title
-     */
+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;
-    /**
-     * Description
-     */
     get description(): string;
+    get default(): number[] | null;
+    get options(): number[];
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isSelect = true;
+    readonly isNumberSelect = true;
     /**
-     * FrontMatter (uses constructor's Zod schema or argument schema)
-     */
-    meta(): DocFileMdMetaValue<T>;
-    /**
-     * Update title
-     */
-    withTitle(title: string): DocFileMdContentValue<T>;
-    /**
-     * Update description
-     */
-    withDescription(description: string, defaultTitle?: string): DocFileMdContentValue<T>;
-    /**
-     * Update body
-     */
-    withBody(body: string): DocFileMdContentValue<T>;
-    /**
-     * @deprecated Use `withBody` instead
-     */
-    withContent(content: string): DocFileMdContentValue<T>;
-    /**
-     * Update FrontMatter
-     */
-    withMeta<U extends DocCustomSchema>(meta: DocFileMdMetaValue<U>): DocFileMdContentValue<U>;
-    withMeta(updater: UpdateFunction<DocFileMdMetaValue<T>>): DocFileMdContentValue<T>;
-    /**
-     * Update specific property of FrontMatter
-     */
-    withMetaProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdContentValue<T>;
-    /**
-     * Generate from Markdown text
-     */
-    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T): DocFileMdContentValue<T>;
-    /**
-     * Generate complete text combining FrontMatter and body
-     */
-    toText(): string;
-    /**
-     * Generate empty content
-     */
-    static empty<T extends DocCustomSchema = DocCustomSchema>(title: string, customSchema: T): DocFileMdContentValue<T>;
-    /**
-     * Output in JSON format
+     * Validate value
      */
-    toJson(): DocFileMdContent<T>;
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectNumberValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectNumberValue<RecordKey>;
 }
 
 /**
- * Markdown file entity
+ * Multiple select text type schema field
  */
-declare class DocFileMdEntity<T extends DocCustomSchema> {
-    readonly value: DocFileMd<T>;
-    private readonly customSchema;
-    constructor(value: DocFileMd<T>, customSchema: T);
-    /**
-     * Content
-     */
-    get content(): DocFileMdContentValue<T>;
-    /**
-     * Path information
-     */
-    get path(): DocFilePath;
+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(): string[] | null;
+    get options(): string[];
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isSelect = true;
+    readonly isTextSelect = true;
     /**
-     * Update content
+     * Validate value
      */
-    withContent(content: DocFileMdContentValue<T>): DocFileMdEntity<T>;
-    withContent(updater: UpdateFunction<DocFileMdContentValue<T>>): DocFileMdEntity<T>;
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectTextValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectTextValue<RecordKey>;
+}
+
+/**
+ * Multiple text type schema field
+ */
+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(): string[] | null;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isText = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * Update path
+     * Validate value type
      */
-    withPath(path: DocFilePath): DocFileMdEntity<T>;
-    withPath(updater: UpdateFunction<DocFilePath>): DocFileMdEntity<T>;
-    withMeta(meta: DocFileMdMetaValue<T>): DocFileMdEntity<T>;
-    withMeta(updater: UpdateFunction<DocFileMdMetaValue<T>>): DocFileMdEntity<T>;
-    withTitle(title: string): DocFileMdEntity<T>;
-    withDescription(description: string, defaultTitle?: string): DocFileMdEntity<T>;
+    validate(value: unknown): boolean;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiTextValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiTextValue<RecordKey>;
+}
+
+/**
+ * Single number type schema field
+ */
+declare class DocSchemaFieldNumberValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldNumber;
+    constructor(key: T, value: DocSchemaFieldNumber);
+    get type(): "number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number | null;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isNumber = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * z.infer<typeof zDocFileMd>
+     * Validate value type
      */
-    toJson(): z.infer<typeof zDocFileMd>;
+    validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldNumberValue<RecordKey>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberValue<RecordKey>;
 }
 
-type Props$f<T extends DocCustomSchema> = {
-    path: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-    customSchema: T;
-    config: DocClientConfig;
-};
 /**
- * File reference
+ * Single relation type schema field
  */
-declare class DocFileMdReference<T extends DocCustomSchema> {
-    private readonly props;
-    private readonly pathSystem;
-    private readonly customSchema;
-    constructor(props: Props$f<T>);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
+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(): string | null;
     get path(): string;
-    get fullPath(): string;
-    get directoryPath(): string;
-    get archivedPath(): string;
-    get name(): string;
-    get nameWithExtension(): string;
-    exists(): Promise<boolean>;
-    read(): Promise<DocFileMdEntity<T> | Error>;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isRelation = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * Read file content
+     * Validate value type
      */
-    readText(): Promise<Error | string>;
+    validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldRelationValue<RecordKey>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldRelationValue<RecordKey>;
+}
+
+/**
+ * Single select number type schema field
+ */
+declare class DocSchemaFieldSelectNumberValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldSelectNumber;
+    constructor(key: T, value: DocSchemaFieldSelectNumber);
+    get type(): "select-number";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): number | null;
+    get options(): number[];
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isSelect = true;
+    readonly isNumberSelect = true;
     /**
-     * Create empty DocFileMdEntity
+     * Validate value
      */
-    empty(): DocFileMdEntity<T>;
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberValue<RecordKey>;
+}
+
+/**
+ * Single select text type schema field
+ */
+declare class DocSchemaFieldSelectTextValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldSelectText;
+    constructor(key: T, value: DocSchemaFieldSelectText);
+    get type(): "select-text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string | null;
+    get options(): string[];
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isSelect = true;
+    readonly isTextSelect = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * Write entity
+     * Validate value type
      */
-    write(entity: DocFileMdEntity<T>): Promise<Error | null>;
-    writeText(text: string): Promise<Error | null>;
+    validate(value: unknown): boolean;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextValue<RecordKey>;
+}
+
+/**
+ * Single text type schema field
+ */
+declare class DocSchemaFieldTextValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldText;
+    constructor(key: T, value: DocSchemaFieldText);
+    get type(): "text";
+    get required(): boolean;
+    get title(): string;
+    get description(): string;
+    get default(): string | null;
+    readonly isArray = false;
+    readonly isSingle = true;
+    readonly isText = true;
+    toJson(): DocFileIndexSchemaField;
     /**
-     * Create new file with default content
+     * Validate value type
      */
-    writeDefault(): Promise<Error | null>;
+    validate(value: unknown): boolean;
+    static empty(key: RecordKey): DocSchemaFieldTextValue<RecordKey>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldTextValue<RecordKey>;
+}
+
+/**
+ * Multiple number type schema field
+ */
+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(): number[] | null;
+    readonly isArray = true;
+    readonly isSingle = false;
+    readonly isNumber = true;
     /**
-     * Delete file
+     * Validate value
      */
-    delete(): Promise<Error | null>;
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiNumberValue<T>;
+    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiNumberValue<RecordKey>;
+}
+
+/**
+ * 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);
     /**
-     * Copy file
+     * Get list of field names
+     * Automatically type-safe when using Zod schema
      */
-    copyTo(destinationPath: string): Promise<Error | null>;
+    get fieldNames(): Array<keyof T>;
     /**
-     * Move file
+     * Get field with specified field name
+     * Returns type-safe specific field Value object
      */
-    moveTo(destinationPath: string): Promise<Error | null>;
+    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>;
+    toJson(): DocFileIndexSchema<keyof T>;
     /**
-     * Move file to archive and return new reference
+     * Create empty schema entity
+     * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
+    static empty(): DocFileIndexSchemaValue<{}>;
+}
+
+/**
+ * File: index.md > content > FrontMatter
+ */
+declare class DocFileIndexMetaValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexMeta<T>;
+    readonly customSchema: T;
+    private readonly config;
+    private readonly additionalProperties;
+    constructor(value: DocFileIndexMeta<T>, customSchema: T, config: DocClientConfig, additionalProperties?: Record<string, unknown>);
     /**
-     * Restore file from archive and return new reference
+     * Get icon
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
+    get icon(): string | null;
     /**
-     * Get file size in bytes
+     * Get schema
      */
-    size(): Promise<number | Error>;
+    schema(): DocFileIndexSchemaValue<T>;
     /**
-     * Get file last modified time
+     * Check if schema is defined
      */
-    lastModified(): Promise<Date | Error>;
+    get hasSchema(): boolean;
     /**
-     * Get file creation time
+     * Update icon field
      */
-    createdAt(): Promise<Date | Error>;
-    directory(): DocDirectoryReference<T>;
+    withIcon(value: string | null): DocFileIndexMetaValue<T>;
     /**
-     * Get relation based on schema
+     * Update schema field
      */
-    relation<U extends DocCustomSchema = DocCustomSchema>(key: RelationKeys<T>, targetSchema?: U): Promise<DocFileMdReference<U> | Error | null>;
+    withSchema(value: DocFileIndexSchema<keyof T>): DocFileIndexMetaValue<T>;
     /**
-     * Get index.md in the same directory
+     * Return a new instance with an unknown schema
+     * Allows accepting Record<string, unknown> schemas from external sources
      */
-    directoryIndex(): Promise<DocFileIndexReference<T> | null>;
+    withUnknownSchema(draft: Record<string, unknown>): DocFileIndexMetaValue<DocCustomSchema>;
     /**
-     * Get multiple relations based on schema
+     * Output in JSON format
      */
-    relations<U extends DocCustomSchema = DocCustomSchema>(key: MultiRelationKeys<T>, customSchema?: U): Promise<DocFileMdReference<U>[]>;
+    toJson(): DocFileIndexMeta<T>;
     /**
-     * File: Markdown > FrontMatter
+     * Output in YAML format
      */
-    readFrontMatter(): Promise<DocFileMdMetaValue<T> | Error>;
+    toYaml(): string;
     /**
-     * File: Markdown > FrontMatter
+     * Generate from Markdown text (can process incomplete data)
      */
-    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);
+    static from<T extends DocCustomSchema>(markdownText: string, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * Content
+     * Generate directly from data (can process incomplete data)
      */
-    get content(): string;
+    static fromRecord<T extends DocCustomSchema>(record: Record<string, unknown>, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * Path information
+     * Generate empty FrontMatter
      */
-    get path(): DocFilePath;
+    static empty<T extends DocCustomSchema>(customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * Update content
+     * Extract icon
      */
-    withContent(content: string): DocFileUnknownEntity;
+    private static extractIcon;
     /**
-     * Update path
+     * Extract schema part
      */
-    withPath(path: DocFilePath): DocFileUnknownEntity;
-    withPath(updater: UpdateFunction<DocFilePath>): DocFileUnknownEntity;
-    toJson(): z.infer<typeof zDocFileUnknown>;
+    private static extractSchema;
+    /**
+     * Normalize entire schema
+     */
+    private static normalizeSchema;
+    static emptySchema<T extends DocCustomSchema>(customSchema: T): DocFileIndexSchema<keyof T>;
 }
 
-type Props$e<T extends DocCustomSchema> = {
-    path: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-    customSchema: T;
-    config: DocClientConfig;
-};
 /**
- * File reference
+ * File: index.md > content
  */
-declare class DocFileUnknownReference<T extends DocCustomSchema> {
-    private readonly props;
-    private readonly pathSystem;
+declare class DocFileIndexContentValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexContent<T>;
     private readonly customSchema;
-    constructor(props: Props$e<T>);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    get path(): string;
-    get directoryPath(): string;
-    get fileFullPath(): string;
-    directory(): DocDirectoryReference<T>;
-    read(): Promise<Error | DocFileUnknownEntity>;
+    private readonly config;
+    constructor(value: DocFileIndexContent<T>, customSchema: T, config: DocClientConfig);
+    /**
+     * Content body (does not include frontMatter)
+     */
+    get body(): string;
+    /**
+     * Title
+     */
+    get title(): string;
+    /**
+     * Description
+     */
+    get description(): string;
+    /**
+     * FrontMatter
+     */
+    meta(): DocFileIndexMetaValue<T>;
+    /**
+     * Update title
+     */
+    withTitle(title: string): DocFileIndexContentValue<T>;
+    /**
+     * Update description
+     */
+    withDescription(description: string, defaultTitle?: string): DocFileIndexContentValue<T>;
+    /**
+     * Generate from Markdown text
+     */
+    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
+    /**
+     * Update content
+     */
+    withBody(body: string): DocFileIndexContentValue<T>;
+    /**
+     * @deprecated Use `withBody` instead
+     */
+    withContent(body: string): DocFileIndexContentValue<T>;
+    /**
+     * Update FrontMatter
+     */
+    withMeta(meta: DocFileIndexMeta<T>): DocFileIndexContentValue<T>;
+    /**
+     * Generate default index.md content
+     */
+    static empty<T extends DocCustomSchema = DocCustomSchema>(directoryName: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
+    /**
+     * Generate complete text combining FrontMatter and body
+     */
+    toText(): string;
+    /**
+     * Output in JSON format
+     */
+    toJson(): DocFileIndexContent<T>;
+}
+
+/**
+ * Document directory entity
+ */
+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(): DocFileIndexContentValue<T>;
+    /**
+     * Path information
+     */
+    get path(): DocFilePath;
+    /**
+     * Update content
+     */
+    withContent(content: DocFileIndexContentValue<T>): DocFileIndexEntity<T>;
+    withContent(updater: UpdateFunction<DocFileIndexContentValue<T>>): DocFileIndexEntity<T>;
+    /**
+     * Update path
+     */
+    withPath(path: DocFilePath): DocFileIndexEntity<T>;
+    withPath(updater: UpdateFunction<DocFilePath>): DocFileIndexEntity<T>;
+    /**
+     * z.infer<typeof zDocFileIndex>
+     */
+    toJson(): DocFileIndexAny;
+}
+
+/**
+ * Relation file
+ */
+declare class DocRelationFileValue {
+    private readonly value;
+    constructor(value: DocRelationFile);
+    /**
+     * File path
+     */
+    get id(): string;
+    /**
+     * Slug
+     */
+    get slug(): string;
+    /**
+     * Display label
+     */
+    get label(): string;
+    /**
+     * Convert to JSON format
+     */
+    toJson(): DocRelationFile;
+    /**
+     * Extract file name from file path (without extension)
+     */
+    private static extractFileName;
+    /**
+     * Create from file path and title
+     */
+    static from(filePath: string, title: string | null): DocRelationFileValue;
+}
+
+/**
+ * Manages relation information
+ */
+declare class DocRelationValue {
+    readonly value: DocRelation;
+    constructor(value: DocRelation);
+    /**
+     * Relation path
+     */
+    get path(): string;
+    /**
+     * Get file count
+     */
+    get fileCount(): number;
+    /**
+     * Whether it's empty
+     */
+    get isEmpty(): boolean;
+    /**
+     * List of related files (value objects)
+     */
+    files(): DocRelationFileValue[];
+    /**
+     * Export as JSON format
+     */
+    toJson(): DocRelation;
+    /**
+     * Create empty relation entity
+     */
+    static empty(path: string): DocRelationValue;
+}
+
+type Props$8 = {
+    filePath: string;
+    fileSystem: DocFileSystemInterface;
+    pathSystem: DocPathSystem;
+};
+/**
+ * Relation file reference
+ */
+declare class DocFileRelationReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$8);
+    get fileSystem(): DocFileSystemInterface;
+    get basePath(): string;
+    /**
+     * Relation path
+     */
+    get path(): string;
+    /**
+     * Full path
+     */
+    get fullPath(): string;
+    read(): Promise<DocRelationValue | Error | null>;
+    /**
+     * Read list of relation files
+     */
+    readFiles(): Promise<DocRelationFileValue[] | Error>;
+    /**
+     * Read single relation file
+     */
+    readFile(filePath: string): Promise<DocRelationFileValue | Error | null>;
+    /**
+     * Check if file exists
+     */
+    exists(slug: string): Promise<boolean>;
+    /**
+     * Get list of file names (without extension)
+     */
+    readSlugs(): Promise<string[] | Error>;
+    /**
+     * Get file count
+     */
+    count(): Promise<number | Error>;
+    /**
+     * Check if empty
+     */
+    isEmpty(): Promise<boolean | Error>;
+}
+
+type Props$7<T extends DocCustomSchema> = {
+    customSchema: T;
+    path: string;
+    fileSystem: DocFileSystemInterface;
+    pathSystem: DocPathSystem;
+    config: DocClientConfig;
+};
+/**
+ * File reference class
+ */
+declare class DocFileIndexReference<T extends DocCustomSchema> {
+    private readonly props;
+    private readonly pathSystem;
+    private readonly customSchema;
+    constructor(props: Props$7<T>);
+    get fileSystem(): DocFileSystemInterface;
+    get basePath(): string;
+    get filePath(): string;
+    get fileFullPath(): string;
+    get durectoryPath(): string;
+    read(): Promise<DocFileIndexEntity<T> | Error>;
+    readSchemaValue(): Promise<DocFileIndexSchema<RecordKey>>;
     /**
      * Read file content
      */
     readContent(): Promise<Error | string>;
     /**
-     * Create empty DocFileUnknownEntity
+     * Create empty DocFileIndexEntity
      */
-    empty(): DocFileUnknownEntity;
+    empty(): DocFileIndexEntity<T>;
     /**
      * Write content to file
      */
@@ -336,11 +616,11 @@ declare class DocFileUnknownReference<T extends DocCustomSchema> {
     /**
      * Write entity
      */
-    write(entity: DocFileUnknownEntity): Promise<Error | null>;
+    write(entity: DocFileIndexEntity<T>): Promise<Error | null>;
     /**
-     * Write raw content
+     * Create new file with default content
      */
-    writeRaw(content: string): Promise<Error | null>;
+    writeDefault(): Promise<Error | null>;
     /**
      * Delete file
      */
@@ -349,1196 +629,385 @@ declare class DocFileUnknownReference<T extends DocCustomSchema> {
      * Check if file exists
      */
     exists(): Promise<boolean>;
-    /**
-     * Copy file
-     */
-    copyTo(destinationPath: string): Promise<Error | null>;
-    /**
-     * Move file
-     */
-    moveTo(destinationPath: string): Promise<Error | null>;
+    relations(): Promise<DocFileRelationReference[] | Error>;
+    readRelations(): Promise<DocRelationValue[] | Error>;
     /**
      * Get file size in bytes
      */
     size(): Promise<number | Error>;
     /**
-     * Get file last modified time
+     * Get last modified date
      */
     lastModified(): Promise<Date | Error>;
     /**
-     * Get file creation time
+     * Get file creation date
      */
     createdAt(): Promise<Date | Error>;
     /**
      * Move file to archive and return new reference
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference<T>>;
+    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
     /**
      * Restore file from archive and return new reference
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference<T>>;
+    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
 }
 
 /**
- * Generic updater function type that takes a value and returns the same type
- */
-type UpdateFunction<T> = (current: T) => T;
-/**
- * Text field type
+ * Meta
  */
-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 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 DocFileMdMetaAny = DocFileMdMeta<RecordKey>;
-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 = {
-    type: "text";
-    required: boolean;
-};
-type DocCustomSchemaFieldNumber = {
-    type: "number";
-    required: boolean;
-};
-type DocCustomSchemaFieldBoolean = {
-    type: "boolean";
-    required: boolean;
-};
-type DocCustomSchemaFieldRelation = {
-    type: "relation";
-    required: boolean;
-};
-type DocCustomSchemaFieldSelectText = {
-    type: "select-text";
-    required: boolean;
-};
-type DocCustomSchemaFieldSelectNumber = {
-    type: "select-number";
-    required: boolean;
-};
-type DocCustomSchemaFieldMultiText = {
-    type: "multi-text";
-    required: boolean;
-};
-type DocCustomSchemaFieldMultiNumber = {
-    type: "multi-number";
-    required: boolean;
-};
-type DocCustomSchemaFieldMultiRelation = {
-    type: "multi-relation";
-    required: boolean;
-};
-type DocCustomSchemaFieldMultiSelectText = {
-    type: "multi-select-text";
-    required: boolean;
-};
-type DocCustomSchemaFieldMultiSelectNumber = {
-    type: "multi-select-number";
-    required: boolean;
-};
-/**
- * Schema field type
- */
-type DocFileIndexSchemaField = z.infer<typeof zDocFileIndexSchemaField>;
-/**
- * Schema definition type
- */
-type DocFileIndexSchema<T extends RecordKey = string> = Record<T, DocFileIndexSchemaField>;
-/**
- * Schema field to override
- * ex: { xxx: { type: "text", required: true } }
- */
-type DocCustomSchemaField = DocCustomSchemaFieldText | DocCustomSchemaFieldNumber | DocCustomSchemaFieldBoolean | DocCustomSchemaFieldRelation | DocCustomSchemaFieldSelectText | DocCustomSchemaFieldSelectNumber | DocCustomSchemaFieldMultiText | DocCustomSchemaFieldMultiNumber | DocCustomSchemaFieldMultiRelation | DocCustomSchemaFieldMultiSelectText | DocCustomSchemaFieldMultiSelectNumber;
-/**
- * Type literal for field types
- */
-type DocFieldTypeLiteral = "text" | "number" | "boolean" | "relation" | "multi-text" | "multi-number" | "multi-relation" | "select-text" | "select-number" | "multi-select-text" | "multi-select-number";
-/**
- * Minimal schema definition type
- */
-type DocCustomSchema<T extends RecordKey = string> = 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 = 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 = DocCustomSchema> = DocFileIndex<T> | DocFileMd<T> | DocFileUnknown;
-type DocDirectoryFile<T extends DocCustomSchema = DocCustomSchema> = DocFileMd<T> | DocFileUnknown;
-type DocFileIndexAny = z.infer<typeof zDocFileIndex>;
-type DocFileMdAny = z.infer<typeof zDocFileMd>;
-/**
- * DocFile<DocCustomSchema<RecordKey>>
- */
-type DocFileAny = DocFileIndexAny | DocFileMdAny | DocFileUnknown;
-/**
- * Directory FrontMatter type
- */
-type DocFileIndexMeta<T extends DocCustomSchema = 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>;
-/**
- * String literal type utilities for file path detection
- */
-/**
- * Check if path ends with specific extension
- */
-type EndsWith<T extends string, U extends string> = T extends `${string}${U}` ? true : false;
-/**
- * Extract filename from path
- */
-type Basename<T extends string> = T extends `${string}/${infer U}` ? Basename<U> : T;
-/**
- * Check if filename is index.md
- */
-type IsIndexMd<T extends string> = Basename<T> extends "index.md" ? true : false;
-/**
- * Detect file type from path
- */
-type DetectFileType<T extends string> = IsIndexMd<T> extends true ? "index" : EndsWith<T, ".md"> extends true ? "markdown" : "unknown";
-/**
- * Map file type to reference class
- */
-type FileTypeToReference<FileType extends string, Schema extends DocCustomSchema> = FileType extends "index" ? DocFileIndexReference<Schema> : FileType extends "markdown" ? DocFileMdReference<Schema> : DocFileUnknownReference<Schema>;
-/**
- * Infer reference type from path
- */
-type InferReference<Path extends string, Schema extends DocCustomSchema> = FileTypeToReference<DetectFileType<Path>, Schema>;
-/**
- * File path information type
- */
-type DocFilePath = z.infer<typeof zDocFilePath>;
-/**
- * Markdown content information type
- */
-type DocFileMdContent<T extends DocCustomSchema = DocCustomSchema> = {
-    type: "markdown-content";
-    body: string;
-    title: string;
-    description: string;
-    meta: SchemaToValueType<T>;
-};
-/**
- * Index file content information type
- */
-type DocFileIndexContent<T extends DocCustomSchema = 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 = PropertyKey;
-/**
- * DocClient configuration
- */
-type DocClientConfig = z.infer<typeof zDocClientConfig>;
-/**
- * Type definitions for DocFileMdMetaValue
- */
-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 RequiredKeys<T extends DocCustomSchema> = {
-    [K in keyof T]: T[K] extends {
-        required: true;
-    } ? K : never;
-}[keyof T];
-/**
- * Extract optional field keys
- */
-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 SchemaToValueType<T extends DocCustomSchema> = {
-    [K in RequiredKeys<T>]: BaseFieldValueType<ExtractFieldType<T[K]>>;
-} & {
-    [K in OptionalKeys<T>]: BaseFieldValueType<ExtractFieldType<T[K]>> | null;
-};
-/**
- * Helper type for type-safe property access
- */
-type GetValueType<T extends DocCustomSchema, K extends keyof T> = K extends RequiredKeys<T> ? BaseFieldValueType<ExtractFieldType<T[K]>> : BaseFieldValueType<ExtractFieldType<T[K]>> | undefined | null;
-type GetIndexFieldType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends DocFileIndexSchemaField ? Schema[K] : never;
-/**
- * Infers DocFileMd type from the result of defineSchema
- */
-type InferDocFileMd<T> = T extends DocCustomSchema ? DocFileMd<T> : never;
-/**
- * Read-only file system interface for document operations
- */
-type DocFileSystemReadType = {
-    /**
-     * Read file content at the specified path
-     */
-    readFile(relativePath: string): Promise<string | null | Error>;
-    /**
-     * 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[] | Error>;
-    /**
-     * Get list of file paths in directory
-     */
-    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
-    /**
-     * 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;
-    /**
-     * Get file size in bytes
-     */
-    getFileSize(relativePath: string): Promise<number | Error>;
-    /**
-     * Get file last modified time
-     */
-    getFileModifiedTime(relativePath: string): Promise<Date | Error>;
-    /**
-     * Get file creation time
-     */
-    getFileCreatedTime(relativePath: string): Promise<Date | Error>;
-};
-/**
- * Write-only file system interface for document operations
- */
-type DocFileSystemWriteType = {
-    /**
-     * Write content to file at the specified path (creates directory if needed)
-     */
-    writeFile(relativePath: string, content: string): Promise<Error | null>;
-    /**
-     * Delete file at the specified path
-     */
-    deleteFile(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory
-     */
-    createDirectory(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory if it doesn't exist
-     */
-    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
-    /**
-     * Copy file
-     */
-    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-    /**
-     * Move file
-     */
-    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-};
-
-type Props$d = {
-    basePath: string;
-    pathSystem?: DocPathSystem;
-    reader?: DocFileSystemReadType;
-    writer?: DocFileSystemWriteType;
-};
-/**
- * File system wrapper with optional dependency injection for read/write operations
- */
-declare class DocFileSystem {
-    protected readonly reader: DocFileSystemReadType;
-    protected readonly writer: DocFileSystemWriteType;
-    protected readonly basePath: string;
-    protected readonly pathSystem: DocPathSystem;
-    constructor(props: Props$d);
-    /**
-     * Read file content at the specified path
-     */
-    readFile(relativePath: string): Promise<string | null | Error>;
-    /**
-     * Write content to file at the specified path (creates directory if needed)
-     */
-    writeFile(relativePath: string, content: string): Promise<Error | null>;
-    /**
-     * 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[] | Error>;
-    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
-    /**
-     * 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<Error | null>;
-    /**
-     * Get file size in bytes
-     */
-    getFileSize(relativePath: string): Promise<number | Error>;
-    /**
-     * Create directory if it doesn't exist
-     */
-    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
-    /**
-     * Copy file
-     */
-    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-    /**
-     * Move file
-     */
-    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-    /**
-     * Get file last modified time
-     */
-    getFileModifiedTime(relativePath: string): Promise<Date | Error>;
-    /**
-     * Get file creation time
-     */
-    getFileCreatedTime(relativePath: string): Promise<Date | Error>;
-}
-
-/**
- * Relation file
- */
-declare class DocRelationFileValue {
-    private readonly value;
-    constructor(value: DocRelationFile);
-    /**
-     * File path
-     */
-    get id(): string;
-    /**
-     * Slug
-     */
-    get slug(): string;
-    /**
-     * Display label
-     */
-    get label(): string;
-    /**
-     * Convert to JSON format
-     */
-    toJson(): DocRelationFile;
-    /**
-     * Extract file name from file path (without extension)
-     */
-    private static extractFileName;
-    /**
-     * Create from file path and title
-     */
-    static from(filePath: string, title: string | null): DocRelationFileValue;
-}
-
-/**
- * Manages relation information
- */
-declare class DocRelationValue {
-    readonly value: DocRelation;
-    constructor(value: DocRelation);
-    /**
-     * Relation path
-     */
-    get path(): string;
-    /**
-     * Get file count
-     */
-    get fileCount(): number;
-    /**
-     * Whether it's empty
-     */
-    get isEmpty(): boolean;
-    /**
-     * List of related files (value objects)
-     */
-    files(): DocRelationFileValue[];
-    /**
-     * Export as JSON format
-     */
-    toJson(): DocRelation;
-    /**
-     * Create empty relation entity
-     */
-    static empty(path: string): DocRelationValue;
-}
-
-type Props$c = {
-    filePath: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-};
-/**
- * Relation file reference
- */
-declare class DocFileRelationReference {
-    private readonly props;
-    private readonly pathSystem;
-    constructor(props: Props$c);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    /**
-     * Relation path
-     */
-    get path(): string;
-    /**
-     * Full path
-     */
-    get fullPath(): string;
-    read(): Promise<DocRelationValue | Error | null>;
-    /**
-     * Read list of relation files
-     */
-    readFiles(): Promise<DocRelationFileValue[] | Error>;
-    /**
-     * Read single relation file
-     */
-    readFile(filePath: string): Promise<DocRelationFileValue | Error | null>;
-    /**
-     * Check if file exists
-     */
-    exists(slug: string): Promise<boolean>;
-    /**
-     * Get list of file names (without extension)
-     */
-    readSlugs(): Promise<string[] | Error>;
-    /**
-     * Get file count
-     */
-    count(): Promise<number | Error>;
-    /**
-     * Check if empty
-     */
-    isEmpty(): Promise<boolean | Error>;
-}
-
-/**
- * Single boolean type schema field
- */
-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;
-    /**
-     * Validate value type
-     */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
-}
-
-/**
- * Multiple relation type schema field
- */
-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 path(): string;
-    readonly isArray = true;
-    readonly isSingle = false;
-    readonly isRelation = true;
-    /**
-     * Validate value
-     */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiRelationValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiRelationValue<RecordKey>;
-}
-
-/**
- * Multiple select number type schema field
- */
-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(): number[] | null;
-    get options(): number[];
-    readonly isArray = true;
-    readonly isSingle = false;
-    readonly isSelect = true;
-    readonly isNumberSelect = true;
-    /**
-     * Validate value
-     */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectNumberValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectNumberValue<RecordKey>;
-}
-
-/**
- * Multiple select text type schema field
- */
-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(): 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 from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectTextValue<RecordKey>;
-}
-
-/**
- * Multiple text type schema field
- */
-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(): string[] | null;
-    readonly isArray = true;
-    readonly isSingle = false;
-    readonly isText = true;
-    toJson(): DocFileIndexSchemaField;
-    /**
-     * Validate value type
-     */
-    validate(value: unknown): boolean;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiTextValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiTextValue<RecordKey>;
-}
-
-/**
- * Single number type schema field
- */
-declare class DocSchemaFieldNumberValue<T extends RecordKey> {
-    readonly key: T;
-    readonly value: DocSchemaFieldNumber;
-    constructor(key: T, value: DocSchemaFieldNumber);
-    get type(): "number";
-    get required(): boolean;
-    get title(): string;
-    get description(): string;
-    get default(): number | null;
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isNumber = true;
-    toJson(): DocFileIndexSchemaField;
-    /**
-     * Validate value type
-     */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldNumberValue<RecordKey>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberValue<RecordKey>;
-}
-
-/**
- * Single relation type schema field
- */
-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(): string | null;
-    get path(): string;
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isRelation = true;
-    toJson(): DocFileIndexSchemaField;
-    /**
-     * Validate value type
-     */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldRelationValue<RecordKey>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldRelationValue<RecordKey>;
-}
-
-/**
- * Single select number type schema field
- */
-declare class DocSchemaFieldSelectNumberValue<T extends RecordKey> {
-    readonly key: T;
-    readonly value: DocSchemaFieldSelectNumber;
-    constructor(key: T, value: DocSchemaFieldSelectNumber);
-    get type(): "select-number";
-    get required(): boolean;
-    get title(): string;
-    get description(): string;
-    get default(): number | null;
-    get options(): number[];
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isSelect = true;
-    readonly isNumberSelect = true;
+declare class DocFileMdMetaValue<T extends DocCustomSchema> {
+    readonly value: SchemaToValueType<T>;
+    readonly customSchema: T;
+    constructor(value: SchemaToValueType<T>, customSchema: T);
+    get keys(): Array<keyof T>;
     /**
-     * Validate value
+     * Return a new instance with a single property updated
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberValue<RecordKey>;
-}
-
-/**
- * Single select text type schema field
- */
-declare class DocSchemaFieldSelectTextValue<T extends RecordKey> {
-    readonly key: T;
-    readonly value: DocSchemaFieldSelectText;
-    constructor(key: T, value: DocSchemaFieldSelectText);
-    get type(): "select-text";
-    get required(): boolean;
-    get title(): string;
-    get description(): string;
-    get default(): string | null;
-    get options(): string[];
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isSelect = true;
-    readonly isTextSelect = true;
-    toJson(): DocFileIndexSchemaField;
+    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;
+    hasKey(key: keyof T): boolean;
+    toJson(): SchemaToValueType<T>;
+    toYaml(): string;
+    private validateValue;
+    private getValueField;
     /**
-     * Validate value type
+     * Generate from Markdown text
      */
-    validate(value: unknown): boolean;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextValue<RecordKey>;
+    static fromYamlText<T extends DocCustomSchema>(yamlText: string, customSchema: T): DocFileMdMetaValue<T>;
+    static empty<T extends DocCustomSchema>(customSchema: T): DocFileMdMetaValue<T>;
 }
 
 /**
- * Single text type schema field
+ * File: Markdown > Content
  */
-declare class DocSchemaFieldTextValue<T extends RecordKey> {
-    readonly key: T;
-    readonly value: DocSchemaFieldText;
-    constructor(key: T, value: DocSchemaFieldText);
-    get type(): "text";
-    get required(): boolean;
-    get title(): string;
-    get description(): string;
-    get default(): string | null;
-    readonly isArray = false;
-    readonly isSingle = true;
-    readonly isText = true;
-    toJson(): DocFileIndexSchemaField;
+declare class DocFileMdContentValue<T extends DocCustomSchema> {
+    readonly value: DocFileMdContent<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMdContent<T>, customSchema: T);
     /**
-     * Validate value type
+     * Content body (does not include frontMatter)
+     */
+    get body(): string;
+    /**
+     * Title
      */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldTextValue<RecordKey>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldTextValue<RecordKey>;
-}
-
-/**
- * Multiple number type schema field
- */
-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;
+    /**
+     * Description
+     */
     get description(): string;
-    get default(): number[] | null;
-    readonly isArray = true;
-    readonly isSingle = false;
-    readonly isNumber = true;
     /**
-     * Validate value
+     * FrontMatter (uses constructor's Zod schema or argument schema)
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiNumberValue<T>;
-    static from(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiNumberValue<RecordKey>;
-}
-
-/**
- * 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);
+    meta(): DocFileMdMetaValue<T>;
     /**
-     * Get list of field names
-     * Automatically type-safe when using Zod schema
+     * Update title
      */
-    get fieldNames(): Array<keyof T>;
+    withTitle(title: string): DocFileMdContentValue<T>;
     /**
-     * Get field with specified field name
-     * Returns type-safe specific field Value object
+     * Update description
      */
-    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>;
-    toJson(): DocFileIndexSchema<keyof T>;
+    withDescription(description: string, defaultTitle?: string): DocFileMdContentValue<T>;
     /**
-     * Create empty schema entity
-     * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
+     * Update body
      */
-    static empty(): DocFileIndexSchemaValue<{}>;
-}
-
-/**
- * File: index.md > content > FrontMatter
- */
-declare class DocFileIndexMetaValue<T extends DocCustomSchema> {
-    readonly value: DocFileIndexMeta<T>;
-    readonly customSchema: T;
-    private readonly config;
-    private readonly additionalProperties;
-    constructor(value: DocFileIndexMeta<T>, customSchema: T, config: DocClientConfig, additionalProperties?: Record<string, unknown>);
+    withBody(body: string): DocFileMdContentValue<T>;
     /**
-     * Get icon
+     * @deprecated Use `withBody` instead
      */
-    get icon(): string | null;
+    withContent(content: string): DocFileMdContentValue<T>;
     /**
-     * Get schema
+     * Update FrontMatter
      */
-    schema(): DocFileIndexSchemaValue<T>;
+    withMeta<U extends DocCustomSchema>(meta: DocFileMdMetaValue<U>): DocFileMdContentValue<U>;
+    withMeta(updater: UpdateFunction<DocFileMdMetaValue<T>>): DocFileMdContentValue<T>;
     /**
-     * Check if schema is defined
+     * Update specific property of FrontMatter
      */
-    get hasSchema(): boolean;
+    withMetaProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdContentValue<T>;
     /**
-     * Update icon field
+     * Generate from Markdown text
      */
-    withIcon(value: string | null): DocFileIndexMetaValue<T>;
+    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T): DocFileMdContentValue<T>;
     /**
-     * Update schema field
+     * Generate complete text combining FrontMatter and body
      */
-    withSchema(value: DocFileIndexSchema<keyof T>): DocFileIndexMetaValue<T>;
+    toText(): string;
     /**
-     * Return a new instance with an unknown schema
-     * Allows accepting Record<string, unknown> schemas from external sources
+     * Generate empty content
      */
-    withUnknownSchema(draft: Record<string, unknown>): DocFileIndexMetaValue<DocCustomSchema>;
+    static empty<T extends DocCustomSchema = DocCustomSchema>(title: string, customSchema: T): DocFileMdContentValue<T>;
     /**
      * Output in JSON format
      */
-    toJson(): DocFileIndexMeta<T>;
+    toJson(): DocFileMdContent<T>;
+}
+
+/**
+ * Markdown file entity
+ */
+declare class DocFileMdEntity<T extends DocCustomSchema> {
+    readonly value: DocFileMd<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMd<T>, customSchema: T);
     /**
-     * Output in YAML format
+     * Content
      */
-    toYaml(): string;
+    content(): DocFileMdContentValue<T>;
     /**
-     * Generate from Markdown text (can process incomplete data)
+     * Path information
      */
-    static from<T extends DocCustomSchema>(markdownText: string, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
+    get path(): DocFilePath;
     /**
-     * Generate directly from data (can process incomplete data)
+     * Update content
      */
-    static fromRecord<T extends DocCustomSchema>(record: Record<string, unknown>, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
+    withContent(content: DocFileMdContentValue<T>): DocFileMdEntity<T>;
+    withContent(updater: UpdateFunction<DocFileMdContentValue<T>>): DocFileMdEntity<T>;
     /**
-     * Generate empty FrontMatter
+     * Update path
      */
-    static empty<T extends DocCustomSchema>(customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
+    withPath(path: DocFilePath): DocFileMdEntity<T>;
+    withPath(updater: UpdateFunction<DocFilePath>): DocFileMdEntity<T>;
+    withMeta(meta: DocFileMdMetaValue<T>): DocFileMdEntity<T>;
+    withMeta(updater: UpdateFunction<DocFileMdMetaValue<T>>): DocFileMdEntity<T>;
+    withTitle(title: string): DocFileMdEntity<T>;
+    withDescription(description: string, defaultTitle?: string): DocFileMdEntity<T>;
     /**
-     * Extract icon
+     * z.infer<typeof zDocFileMd>
      */
-    private static extractIcon;
+    toJson(): z.infer<typeof zDocFileMd>;
+}
+
+/**
+ * Unknown file entity
+ */
+declare class DocFileUnknownEntity {
+    readonly value: DocFileUnknown;
+    constructor(value: DocFileUnknown);
     /**
-     * Extract schema part
+     * Content
      */
-    private static extractSchema;
+    get content(): string;
     /**
-     * Normalize entire schema
+     * Path information
      */
-    private static normalizeSchema;
-    static emptySchema<T extends DocCustomSchema>(customSchema: T): DocFileIndexSchema<keyof T>;
+    get path(): DocFilePath;
+    /**
+     * Update content
+     */
+    withContent(content: string): DocFileUnknownEntity;
+    /**
+     * Update path
+     */
+    withPath(path: DocFilePath): DocFileUnknownEntity;
+    withPath(updater: UpdateFunction<DocFilePath>): DocFileUnknownEntity;
+    toJson(): z.infer<typeof zDocFileUnknown>;
 }
 
+type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
+type DocFileDirectoryEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileUnknownEntity;
+
+type Props$6<T extends DocCustomSchema> = {
+    path: string;
+    fileSystem: DocFileSystemInterface;
+    pathSystem: DocPathSystem;
+    customSchema: T;
+    config: DocClientConfig;
+};
 /**
- * File: index.md > content
+ * File reference
  */
-declare class DocFileIndexContentValue<T extends DocCustomSchema> {
-    readonly value: DocFileIndexContent<T>;
+declare class DocFileUnknownReference<T extends DocCustomSchema> {
+    private readonly props;
+    private readonly pathSystem;
     private readonly customSchema;
-    private readonly config;
-    constructor(value: DocFileIndexContent<T>, customSchema: T, config: DocClientConfig);
+    constructor(props: Props$6<T>);
+    get fileSystem(): DocFileSystemInterface;
+    get basePath(): string;
+    get path(): string;
+    get directoryPath(): string;
+    get fileFullPath(): string;
+    directory(): DocDirectoryReference<T>;
+    read(): Promise<Error | DocFileUnknownEntity>;
     /**
-     * Content body (does not include frontMatter)
+     * Read file content
      */
-    get body(): string;
+    readContent(): Promise<Error | string>;
     /**
-     * Title
+     * Create empty DocFileUnknownEntity
      */
-    get title(): string;
+    empty(): DocFileUnknownEntity;
     /**
-     * Description
+     * Write content to file
      */
-    get description(): string;
+    writeContent(content: string): Promise<Error | null>;
     /**
-     * FrontMatter
+     * Write entity
      */
-    meta(): DocFileIndexMetaValue<T>;
+    write(entity: DocFileUnknownEntity): Promise<Error | null>;
     /**
-     * Update title
+     * Write raw content
      */
-    withTitle(title: string): DocFileIndexContentValue<T>;
+    writeRaw(content: string): Promise<Error | null>;
     /**
-     * Update description
+     * Delete file
      */
-    withDescription(description: string, defaultTitle?: string): DocFileIndexContentValue<T>;
+    delete(): Promise<Error | null>;
     /**
-     * Generate from Markdown text
+     * Check if file exists
      */
-    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
+    exists(): Promise<boolean>;
     /**
-     * Update content
+     * Copy file
      */
-    withBody(body: string): DocFileIndexContentValue<T>;
+    copyTo(destinationPath: string): Promise<Error | null>;
     /**
-     * @deprecated Use `withBody` instead
+     * Move file
      */
-    withContent(body: string): DocFileIndexContentValue<T>;
+    moveTo(destinationPath: string): Promise<Error | null>;
     /**
-     * Update FrontMatter
+     * Get file size in bytes
      */
-    withMeta(meta: DocFileIndexMeta<T>): DocFileIndexContentValue<T>;
+    size(): Promise<number | Error>;
     /**
-     * Generate default index.md content
+     * Get file last modified time
+     */
+    lastModified(): Promise<Date | Error>;
+    /**
+     * Get file creation time
      */
-    static empty<T extends DocCustomSchema = DocCustomSchema>(directoryName: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
+    createdAt(): Promise<Date | Error>;
     /**
-     * Generate complete text combining FrontMatter and body
+     * Move file to archive and return new reference
      */
-    toText(): string;
+    archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference<T>>;
     /**
-     * Output in JSON format
+     * Restore file from archive and return new reference
      */
-    toJson(): DocFileIndexContent<T>;
+    restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference<T>>;
 }
 
+type DocFileDirectoryReference<T extends DocCustomSchema> = DocFileMdReference<T> | DocFileUnknownReference<T>;
+
+type Props$5<T extends DocCustomSchema> = {
+    customSchema: T;
+    path: string;
+    indexFileName: string;
+    archiveDirectoryName: string;
+    fileSystem: DocFileSystemInterface;
+    pathSystem: DocPathSystem;
+    config: DocClientConfig;
+};
 /**
- * Document directory entity
+ * Directory reference
  */
-declare class DocFileIndexEntity<T extends DocCustomSchema> {
-    readonly value: DocFileIndex<T>;
+declare class DocDirectoryReference<T extends DocCustomSchema> {
+    private readonly props;
+    private readonly pathSystem;
     private readonly customSchema;
-    private readonly config;
-    constructor(value: DocFileIndex<T>, customSchema: T, config?: DocClientConfig);
+    constructor(props: Props$5<T>);
+    get fileSystem(): DocFileSystemInterface;
+    get basePath(): string;
+    get config(): DocClientConfig;
+    get path(): string;
     /**
-     * Content
+     * @deprecated
      */
-    get content(): DocFileIndexContentValue<T>;
+    get relativePath(): string;
+    get fullPath(): string;
     /**
-     * Path information
+     * @deprecated
      */
-    get path(): DocFilePath;
+    get absolutePath(): string;
+    get indexFileName(): string;
+    get indexFilePath(): string;
+    get archiveDirectoryName(): string;
+    get name(): string;
+    fileNames(): Promise<string[] | Error>;
+    archivedFileNames(): Promise<string[] | Error>;
+    filesGenerator(): AsyncGenerator<DocFileDirectoryReference<T>, void, unknown>;
+    mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T> | Error, void, unknown>;
+    files(): Promise<DocFileDirectoryReference<T>[]>;
+    mdFiles(): Promise<DocFileMdReference<T>[]>;
+    file<FileName extends string>(fileName: FileName): InferReference<FileName, T>;
+    mdFile(fileName: string): DocFileMdReference<T>;
+    readFiles(): Promise<DocFileDirectoryEntity<T>[]>;
+    readMdFiles(): Promise<DocFileMdEntity<T>[]>;
+    readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
     /**
-     * Update content
+     * Get list of subdirectory names
      */
-    withContent(content: DocFileIndexContentValue<T>): DocFileIndexEntity<T>;
-    withContent(updater: UpdateFunction<DocFileIndexContentValue<T>>): DocFileIndexEntity<T>;
+    directoryNames(): Promise<string[]>;
     /**
-     * Update path
+     * Get subdirectory references
      */
-    withPath(path: DocFilePath): DocFileIndexEntity<T>;
-    withPath(updater: UpdateFunction<DocFilePath>): DocFileIndexEntity<T>;
+    directories(): Promise<DocDirectoryReference<T>[]>;
     /**
-     * z.infer<typeof zDocFileIndex>
+     * Get single subdirectory reference
      */
-    toJson(): DocFileIndexAny;
+    directory(directoryName: string): DocDirectoryReference<T>;
+    directory<S extends DocCustomSchema>(directoryName: string, customSchema: S): DocDirectoryReference<S>;
+    indexFile(): DocFileIndexReference<T>;
+    readIndexFile(): Promise<DocFileIndexEntity<T> | Error>;
+    writeFile(entity: DocFileIndexEntity<T> | DocFileMdEntity<T> | DocFileUnknownEntity): Promise<Error | null>;
+    exists(): Promise<boolean>;
+    /**
+     * Create new Markdown file
+     */
+    createMdFile(fileName?: string): Promise<DocFileMdReference<T>>;
+    /**
+     * Generate unique filename
+     */
+    private uniqueFileName;
 }
 
-type Props$b<T extends DocCustomSchema> = {
-    customSchema: T;
+type Props$4<T extends DocCustomSchema> = {
     path: string;
-    fileSystem: DocFileSystem;
+    fileSystem: DocFileSystemInterface;
     pathSystem: DocPathSystem;
+    customSchema: T;
     config: DocClientConfig;
 };
 /**
- * File reference class
+ * File reference
  */
-declare class DocFileIndexReference<T extends DocCustomSchema> {
+declare class DocFileMdReference<T extends DocCustomSchema> {
     private readonly props;
     private readonly pathSystem;
     private readonly customSchema;
-    constructor(props: Props$b<T>);
-    get fileSystem(): DocFileSystem;
+    constructor(props: Props$4<T>);
+    get fileSystem(): DocFileSystemInterface;
     get basePath(): string;
-    get filePath(): string;
-    get fileFullPath(): string;
-    get durectoryPath(): string;
-    read(): Promise<DocFileIndexEntity<T> | Error>;
-    readSchemaValue(): Promise<DocFileIndexSchema<RecordKey>>;
+    get path(): string;
+    get fullPath(): string;
+    get directoryPath(): string;
+    get archivedPath(): string;
+    get name(): string;
+    get nameWithExtension(): string;
+    exists(): Promise<boolean>;
+    read(): Promise<DocFileMdEntity<T> | Error>;
     /**
      * Read file content
      */
-    readContent(): Promise<Error | string>;
-    /**
-     * Create empty DocFileIndexEntity
-     */
-    empty(): DocFileIndexEntity<T>;
+    readText(): Promise<Error | string>;
     /**
-     * Write content to file
+     * Create empty DocFileMdEntity
      */
-    writeContent(content: string): Promise<Error | null>;
+    empty(): DocFileMdEntity<T>;
     /**
      * Write entity
      */
-    write(entity: DocFileIndexEntity<T>): Promise<Error | null>;
+    write(entity: DocFileMdEntity<T>): Promise<Error | null>;
+    writeText(text: string): Promise<Error | null>;
     /**
      * Create new file with default content
      */
@@ -1548,884 +1017,585 @@ declare class DocFileIndexReference<T extends DocCustomSchema> {
      */
     delete(): Promise<Error | null>;
     /**
-     * Check if file exists
+     * Copy file
      */
-    exists(): Promise<boolean>;
-    relations(): Promise<DocFileRelationReference[] | Error>;
-    readRelations(): Promise<DocRelationValue[] | Error>;
+    copyTo(destinationPath: string): Promise<Error | null>;
+    /**
+     * Move file
+     */
+    moveTo(destinationPath: string): Promise<Error | null>;
+    /**
+     * Move file to archive and return new reference
+     */
+    archive(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
+    /**
+     * Restore file from archive and return new reference
+     */
+    restore(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
     /**
      * Get file size in bytes
      */
     size(): Promise<number | Error>;
     /**
-     * Get last modified date
+     * Get file last modified time
      */
     lastModified(): Promise<Date | Error>;
     /**
-     * Get file creation date
+     * Get file creation time
      */
     createdAt(): Promise<Date | Error>;
+    directory(): DocDirectoryReference<T>;
     /**
-     * Move file to archive and return new reference
+     * Get relation based on schema
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
+    relation<U extends DocCustomSchema = DocCustomSchema>(key: RelationKeys<T>, targetSchema?: U): Promise<DocFileMdReference<U> | Error | null>;
     /**
-     * Restore file from archive and return new reference
+     * Get index.md in the same directory
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
+    directoryIndex(): Promise<DocFileIndexReference<T> | null>;
+    /**
+     * Get multiple relations based on schema
+     */
+    relations<U extends DocCustomSchema = DocCustomSchema>(key: MultiRelationKeys<T>, customSchema?: U): Promise<DocFileMdReference<U>[]>;
+    /**
+     * File: Markdown > FrontMatter
+     */
+    readFrontMatter(): Promise<DocFileMdMetaValue<T> | Error>;
+    /**
+     * File: Markdown > FrontMatter
+     */
+    updateFrontMatter<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): Promise<this | Error>;
 }
 
-type DocFileDirectoryReference<T extends DocCustomSchema> = DocFileMdReference<T> | DocFileUnknownReference<T>;
-
-type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
-type DocFileDirectoryEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileUnknownEntity;
-
-type Props$a<T extends DocCustomSchema> = {
-    customSchema: T;
-    path: string;
-    indexFileName: string;
-    archiveDirectoryName: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-    config: DocClientConfig;
+/**
+ * Generic updater function type that takes a value and returns the same type
+ */
+type UpdateFunction<T> = (current: T) => T;
+/**
+ * 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 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 DocFileMdMetaAny = DocFileMdMeta<RecordKey>;
+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 = {
+    type: "text";
+    required: boolean;
+};
+type DocCustomSchemaFieldNumber = {
+    type: "number";
+    required: boolean;
+};
+type DocCustomSchemaFieldBoolean = {
+    type: "boolean";
+    required: boolean;
+};
+type DocCustomSchemaFieldRelation = {
+    type: "relation";
+    required: boolean;
+};
+type DocCustomSchemaFieldSelectText = {
+    type: "select-text";
+    required: boolean;
+};
+type DocCustomSchemaFieldSelectNumber = {
+    type: "select-number";
+    required: boolean;
+};
+type DocCustomSchemaFieldMultiText = {
+    type: "multi-text";
+    required: boolean;
+};
+type DocCustomSchemaFieldMultiNumber = {
+    type: "multi-number";
+    required: boolean;
+};
+type DocCustomSchemaFieldMultiRelation = {
+    type: "multi-relation";
+    required: boolean;
+};
+type DocCustomSchemaFieldMultiSelectText = {
+    type: "multi-select-text";
+    required: boolean;
+};
+type DocCustomSchemaFieldMultiSelectNumber = {
+    type: "multi-select-number";
+    required: boolean;
 };
 /**
- * Directory reference
+ * Schema field type
  */
-declare class DocDirectoryReference<T extends DocCustomSchema> {
-    private readonly props;
-    private readonly pathSystem;
-    private readonly customSchema;
-    constructor(props: Props$a<T>);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    get config(): DocClientConfig;
-    get path(): string;
-    /**
-     * @deprecated
-     */
-    get relativePath(): string;
-    get fullPath(): string;
-    /**
-     * @deprecated
-     */
-    get absolutePath(): string;
-    get indexFileName(): string;
-    get indexFilePath(): string;
-    get archiveDirectoryName(): string;
-    get name(): string;
-    fileNames(): Promise<string[] | Error>;
-    archivedFileNames(): Promise<string[] | Error>;
-    filesGenerator(): AsyncGenerator<DocFileDirectoryReference<T>, void, unknown>;
-    mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T> | Error, void, unknown>;
-    files(): Promise<DocFileDirectoryReference<T>[]>;
-    mdFiles(): Promise<DocFileMdReference<T>[]>;
-    file<FileName extends string>(fileName: FileName): InferReference<FileName, T>;
-    mdFile(fileName: string): DocFileMdReference<T>;
-    readFiles(): Promise<DocFileDirectoryEntity<T>[]>;
-    readMdFiles(): Promise<DocFileMdEntity<T>[]>;
-    readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
-    /**
-     * Get list of subdirectory names
-     */
-    directoryNames(): Promise<string[]>;
-    /**
-     * Get subdirectory references
-     */
-    directories(): Promise<DocDirectoryReference<T>[]>;
-    /**
-     * Get single subdirectory reference
-     */
-    directory(directoryName: string): DocDirectoryReference<T>;
-    directory<S extends DocCustomSchema>(directoryName: string, customSchema: S): DocDirectoryReference<S>;
-    indexFile(): DocFileIndexReference<T>;
-    readIndexFile(): Promise<DocFileIndexEntity<T> | Error>;
-    writeFile(entity: DocFileIndexEntity<T> | DocFileMdEntity<T> | DocFileUnknownEntity): Promise<Error | null>;
-    exists(): Promise<boolean>;
-    /**
-     * Create new Markdown file
-     */
-    createMdFile(fileName?: string): Promise<DocFileMdReference<T>>;
-    /**
-     * Generate unique filename
-     */
-    private uniqueFileName;
-}
-
-declare const DOC_NODE_TYPE_DIRECTORY: "directory";
-
-type Props$9 = {
+type DocFileIndexSchemaField = z.infer<typeof zDocFileIndexSchemaField>;
+/**
+ * Schema definition type
+ */
+type DocFileIndexSchema<T extends RecordKey = string> = Record<T, DocFileIndexSchemaField>;
+/**
+ * Schema field to override
+ * ex: { xxx: { type: "text", required: true } }
+ */
+type DocCustomSchemaField = DocCustomSchemaFieldText | DocCustomSchemaFieldNumber | DocCustomSchemaFieldBoolean | DocCustomSchemaFieldRelation | DocCustomSchemaFieldSelectText | DocCustomSchemaFieldSelectNumber | DocCustomSchemaFieldMultiText | DocCustomSchemaFieldMultiNumber | DocCustomSchemaFieldMultiRelation | DocCustomSchemaFieldMultiSelectText | DocCustomSchemaFieldMultiSelectNumber;
+/**
+ * Type literal for field types
+ */
+type DocFieldTypeLiteral = "text" | "number" | "boolean" | "relation" | "multi-text" | "multi-number" | "multi-relation" | "select-text" | "select-number" | "multi-select-text" | "multi-select-number";
+/**
+ * Minimal schema definition type
+ */
+type DocCustomSchema<T extends RecordKey = string> = 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;
 };
 /**
- * Tree file node value object
+ * Directory node type (for directories only)
  */
-declare class DocTreeFileNodeValue {
-    private readonly props;
-    constructor(props: Props$9);
-    get name(): string;
-    get path(): string;
-    get icon(): string;
-    get title(): string;
-    get type(): "file";
-    /**
-     * Convert to plain object
-     */
-    toJson(): DocTreeFileNode;
-    /**
-     * Create from properties
-     */
-    static from(props: Props$9): DocTreeFileNodeValue;
-    /**
-     * Create from JSON object
-     */
-    static fromJson(json: unknown): DocTreeFileNodeValue;
-}
-
-type DocTreeNodeValue = DocTreeFileNodeValue | DocTreeDirectoryNodeValue;
-
-type Props$8 = {
+type DocTreeDirectoryNode = {
+    type: "directory";
     name: string;
     path: string;
     icon: string;
     title: string;
-    children: DocTreeNodeValue[];
+    children: DocTreeNode[];
 };
 /**
- * Tree directory node value object
+ * Unified tree node type
  */
-declare class DocTreeDirectoryNodeValue {
-    private readonly props;
-    constructor(props: Props$8);
-    get name(): string;
-    get path(): string;
-    get icon(): string;
-    get title(): string;
-    get children(): DocTreeNodeValue[];
-    get type(): typeof DOC_NODE_TYPE_DIRECTORY;
-    /**
-     * Convert to plain object
-     */
-    toJson(): DocTreeDirectoryNode;
-    /**
-     * Create from properties
-     */
-    static from(props: Props$8): DocTreeDirectoryNodeValue;
-    /**
-     * Create from JSON object
-     */
-    static fromJson(json: unknown): DocTreeDirectoryNodeValue;
-}
-
-type Props$7 = {
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-    indexFileName: string;
-    archiveDirectoryName: string;
-    config: DocClientConfig;
+type DocTreeNode = DocTreeFileNode | DocTreeDirectoryNode;
+/**
+ * Index file type
+ */
+type DocFileIndex<T extends DocCustomSchema = 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 = DocCustomSchema> = DocFileIndex<T> | DocFileMd<T> | DocFileUnknown;
+type DocDirectoryFile<T extends DocCustomSchema = DocCustomSchema> = DocFileMd<T> | DocFileUnknown;
+type DocFileIndexAny = z.infer<typeof zDocFileIndex>;
+type DocFileMdAny = z.infer<typeof zDocFileMd>;
+/**
+ * DocFile<DocCustomSchema<RecordKey>>
+ */
+type DocFileAny = DocFileIndexAny | DocFileMdAny | DocFileUnknown;
+/**
+ * Directory FrontMatter type
+ */
+type DocFileIndexMeta<T extends DocCustomSchema = DocCustomSchema> = {
+    type: "index-meta";
+    icon: string | null;
+    schema: DocFileIndexSchema<keyof T>;
 };
 /**
- * File tree building system
+ * 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>;
+/**
+ * String literal type utilities for file path detection
+ */
+/**
+ * Check if path ends with specific extension
+ */
+type EndsWith<T extends string, U extends string> = T extends `${string}${U}` ? true : false;
+/**
+ * Extract filename from path
+ */
+type Basename<T extends string> = T extends `${string}/${infer U}` ? Basename<U> : T;
+/**
+ * Check if filename is index.md
+ */
+type IsIndexMd<T extends string> = Basename<T> extends "index.md" ? true : false;
+/**
+ * Detect file type from path
  */
-declare class DocFileTreeSystem {
-    private readonly props;
-    private readonly config;
-    constructor(props: Props$7);
-    /**
-     * Build file tree recursively
-     */
-    buildFileTree(directoryPath?: string): Promise<DocTreeNodeValue[] | Error>;
-    /**
-     * Create file node
-     */
-    private createFileNode;
-    /**
-     * Create directory node
-     */
-    private createDirectoryNode;
-    /**
-     * Create index file reference
-     */
-    private createIndexFileReference;
-    /**
-     * Create MD file reference
-     */
-    private createMdFileReference;
-    /**
-     * Build directory tree recursively (directories only)
-     */
-    buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[] | Error>;
-    /**
-     * Create directory node for directory tree
-     */
-    private createDirectoryNodeForTree;
-}
-
+type DetectFileType<T extends string> = IsIndexMd<T> extends true ? "index" : EndsWith<T, ".md"> extends true ? "markdown" : "unknown";
 /**
- * Markdown parsing and processing system
+ * Map file type to reference class
  */
-declare class DocMarkdownSystem {
-    private readonly frontMatterSeparator;
-    constructor();
-    /**
-     * Detect FrontMatter separator line
-     */
-    private detectFrontMatterSeparator;
-    /**
-     * Extract FrontMatter
-     */
-    extractFrontMatter(text: string): string | null;
-    /**
-     * 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;
-    /**
-     * Update title in body (returns body only, without FrontMatter)
-     */
-    updateTitle(text: string, newTitle: string): string;
-    /**
-     * Update description in body (returns body only, without FrontMatter)
-     */
-    updateDescription(text: string, newDescription: string, defaultTitle: string): string;
-    /**
-     * Skip empty lines
-     */
-    private skipEmptyLines;
-    /**
-     * Generate Markdown text (title + description + body)
-     */
-    static from(title: string, description: string, body: string): string;
-}
-
-type Props$6 = {
-    fileSystem: DocFileSystem;
-    pathSystem?: DocPathSystem;
-    markdownSystem?: DocMarkdownSystem;
-    fileTreeSystem?: DocFileTreeSystem;
-    /**
-     * Configuration
-     */
-    config?: DocClientConfig;
-};
-declare class DocClient {
-    readonly fileSystem: DocFileSystem;
-    readonly pathSystem: DocPathSystem;
-    readonly markdownSystem: DocMarkdownSystem;
-    readonly fileTreeSystem: DocFileTreeSystem;
-    readonly config: DocClientConfig;
-    constructor(props: Props$6);
-    basePath(): string;
-    file<Path extends string>(relativePath: Path): InferReference<Path, DocCustomSchema>;
-    file<Path extends string, T extends DocCustomSchema>(relativePath: Path, customSchema: T): InferReference<Path, T>;
-    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 const zJsonDocumentData$2: z.ZodRecord<z.ZodString, z.ZodString>;
-type JsonDocumentData$2 = z.infer<typeof zJsonDocumentData$2>;
-type JsonProps = {
-    data?: JsonDocumentData$2 | unknown;
-    basePath?: string;
-    pathSystem?: DocPathSystem;
-    onDataChange?: (data: JsonDocumentData$2) => void;
+type FileTypeToReference<FileType extends string, Schema extends DocCustomSchema> = FileType extends "index" ? DocFileIndexReference<Schema> : FileType extends "markdown" ? DocFileMdReference<Schema> : DocFileUnknownReference<Schema>;
+/**
+ * Infer reference type from path
+ */
+type InferReference<Path extends string, Schema extends DocCustomSchema> = FileTypeToReference<DetectFileType<Path>, Schema>;
+/**
+ * File path information type
+ */
+type DocFilePath = z.infer<typeof zDocFilePath>;
+/**
+ * Markdown content information type
+ */
+type DocFileMdContent<T extends DocCustomSchema = DocCustomSchema> = {
+    type: "markdown-content";
+    body: string;
+    title: string;
+    description: string;
+    meta: SchemaToValueType<T>;
 };
 /**
- * JSON-based file system with separate read/write components
+ * Index file content information type
  */
-declare class DocFileSystemJson extends DocFileSystem {
-    private readonly jsonReader;
-    private readonly jsonWriter;
-    constructor(props?: JsonProps);
-    /**
-     * Get the current JSON data
-     */
-    getData(): JsonDocumentData$2;
-    /**
-     * Update the entire JSON data
-     */
-    setData(data: JsonDocumentData$2 | unknown): Error | null;
-    /**
-     * Clear all data
-     */
-    clear(): void;
-    /**
-     * Get all file paths in the JSON data
-     */
-    getAllFilePaths(): string[];
-    /**
-     * Get the raw JSON data (read-only copy)
-     */
-    getRawData(): JsonDocumentData$2;
-    /**
-     * Create from docs-to-json format
-     */
-    static fromDocsToJson(data: Record<string, string> | unknown, options?: Omit<JsonProps, "data">): DocFileSystemJson;
-    /**
-     * Export to docs-to-json format
-     */
-    toDocsToJson(): Record<string, string>;
-}
-
-declare const zJsonDocumentData$1: z.ZodRecord<z.ZodString, z.ZodString>;
-type JsonDocumentData$1 = z.infer<typeof zJsonDocumentData$1>;
-type Props$5 = {
-    data: JsonDocumentData$1 | unknown;
-    basePath?: string;
-    pathSystem?: DocPathSystem;
+type DocFileIndexContent<T extends DocCustomSchema = DocCustomSchema> = {
+    type: "markdown-index";
+    body: string;
+    title: string;
+    description: string;
+    meta: DocFileIndexMeta<T>;
 };
 /**
- * JSON-based read-only file system implementation
+ * Directory response type (re-export from server package)
  */
-declare class DocFileSystemJsonRead implements DocFileSystemReadType {
-    private readonly data;
-    private readonly basePath;
-    private readonly pathSystem;
-    constructor(props: Props$5);
-    /**
-     * Read file content from JSON data
-     */
-    readFile(relativePath: string): Promise<string | null | Error>;
-    /**
-     * 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 file names in directory
-     */
-    readDirectoryFileNames(relativePath?: string): Promise<string[] | Error>;
-    /**
-     * Get list of file paths in directory
-     */
-    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
-    /**
-     * 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;
-    /**
-     * Get file size in bytes
-     */
-    getFileSize(relativePath: string): Promise<number | Error>;
-    /**
-     * Get file last modified time (not available for JSON data)
-     */
-    getFileModifiedTime(_relativePath: string): Promise<Date | Error>;
-    /**
-     * Get file creation time (not available for JSON data)
-     */
-    getFileCreatedTime(_relativePath: string): Promise<Date | Error>;
-    /**
-     * Get all file paths in the JSON data
-     */
-    getAllFilePaths(): string[];
-    /**
-     * Get the raw JSON data
-     */
-    getRawData(): JsonDocumentData$1;
-    /**
-     * Normalize path by removing leading/trailing slashes
-     */
-    private normalizePath;
-    /**
-     * Check if a file path is within a directory
-     */
-    private isFileInDirectory;
-    /**
-     * Get the relative part of a file path from a directory
-     */
-    private getRelativePartFromDirectory;
-}
-
-declare const zJsonDocumentData: z.ZodRecord<z.ZodString, z.ZodString>;
-type JsonDocumentData = z.infer<typeof zJsonDocumentData>;
-type Props$4 = {
-    data?: JsonDocumentData | unknown;
-    basePath?: string;
-    pathSystem?: DocPathSystem;
-    reader?: DocFileSystemReadType;
-    onDataChange?: (data: JsonDocumentData) => void;
+type DocDirectory<T extends DocCustomSchema> = {
+    cwd: string;
+    indexFile: DocFileIndex<T>;
+    files: DocFile<T>[];
+    relations: DocRelation[];
 };
+type RecordKey = PropertyKey;
 /**
- * JSON-based write-only file system implementation
+ * DocClient configuration
  */
-declare class DocFileSystemJsonWrite implements DocFileSystemWriteType {
-    private data;
-    private readonly basePath;
-    private readonly pathSystem;
-    private readonly reader?;
-    private readonly onDataChange?;
-    constructor(props?: Props$4);
-    /**
-     * Write content to JSON data
-     */
-    writeFile(relativePath: string, content: string): Promise<Error | null>;
-    /**
-     * Delete file from JSON data
-     */
-    deleteFile(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory (creates a placeholder entry)
-     */
-    createDirectory(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory if it doesn't exist
-     */
-    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
-    /**
-     * Copy file within JSON data
-     */
-    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-    /**
-     * Move file within JSON data
-     */
-    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
-    /**
-     * Get the current JSON data
-     */
-    getData(): JsonDocumentData;
-    /**
-     * Update the entire JSON data
-     */
-    setData(data: JsonDocumentData | unknown): Error | null;
-    /**
-     * Clear all data
-     */
-    clear(): void;
-    /**
-     * Get all file paths in the JSON data
-     */
-    getAllFilePaths(): string[];
-    /**
-     * Normalize path by removing leading/trailing slashes
-     */
-    private normalizePath;
-    /**
-     * Check if directory exists in data
-     */
-    private directoryExistsInData;
-    /**
-     * Notify data change callback
-     */
-    private notifyDataChange;
-}
-
+type DocClientConfig = z.infer<typeof zDocClientConfig>;
+/**
+ * Type definitions for DocFileMdMetaValue
+ */
+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 RequiredKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K] extends {
+        required: true;
+    } ? K : never;
+}[keyof T];
+/**
+ * Extract optional field keys
+ */
+type OptionalKeys<T extends DocCustomSchema> = {
+    [K in keyof T]: T[K] extends {
+        required: true;
+    } ? never : K;
+}[keyof T];
 /**
- * In-memory file system for testing
+ * Generate expected value type from schema (considering required)
  */
-declare class DocFileSystemMock extends DocFileSystem {
-    private files;
-    private readonly _pathSystem;
-    private readonly _basePath;
-    constructor(props: {
-        basePath: string;
-        pathSystem: DocPathSystem;
-        skipDefaultFiles?: boolean;
-    });
-    /**
-     * PathSystem accessor (for testing)
-     */
-    getPathSystem(): DocPathSystem;
-    /**
-     * Normalize path using basePath
-     */
-    private normalizePath;
-    /**
-     * Create instance (mock data is automatically loaded)
-     */
-    static create(basePath?: string): DocFileSystemMock;
-    /**
-     * Factory method for testing
-     */
-    static createWithFiles(props: {
-        basePath?: string;
-        fileContents?: Record<string, string>;
-    }): DocFileSystemMock;
-    readFile(filePath: string): Promise<string | null | Error>;
-    writeFile(filePath: string, content: string): Promise<Error | null>;
-    deleteFile(filePath: string): Promise<Error | null>;
-    exists(filePath: string): Promise<boolean>;
-    copyFile(source: string, destination: string): Promise<Error | null>;
-    moveFile(source: string, destination: string): Promise<Error | null>;
-    readDirectory(directoryPath: string): Promise<string[]>;
-    readDirectoryRecursive(directoryPath: string): Promise<string[]>;
-    readDirectoryFilePaths(directoryPath: string): Promise<string[] | Error>;
-    createDirectory(_directoryPath: string): Promise<Error | null>;
-    deleteDirectory(directoryPath: string): Promise<void>;
-    getFileSize(filePath: string): Promise<number | Error>;
-    getFileModifiedTime(filePath: string): Promise<Date | Error>;
-    getFileCreatedTime(filePath: string): Promise<Date | Error>;
-    isDirectory(relativePath: string): Promise<boolean>;
-    isFile(relativePath: string): Promise<boolean>;
-    /**
-     * Get list of entries in directory
-     */
-    readDirectoryFileNames(directoryPath?: string): Promise<string[] | Error>;
-    /**
-     * Check if directory exists
-     */
-    directoryExists(relativePath: string): Promise<boolean>;
-    /**
-     * Check if file exists
-     */
-    fileExists(relativePath: string): Promise<boolean>;
-    /**
-     * Create directory if it doesn't exist
-     */
-    ensureDirectoryExists(_relativePath: string): Promise<Error | null>;
-    /**
-     * Clear all files
-     */
-    clear(): void;
-    /**
-     * Check file existence (for testing)
-     */
-    hasFile(filePath: string): boolean;
-    /**
-     * Get file content (sync version, for testing)
-     */
-    getFileContent(filePath: string): string | undefined;
-    /**
-     * Get all file paths (for testing)
-     */
-    getAllFilePaths(): string[];
-    /**
-     * Get file count (for testing)
-     */
-    getFileCount(): number;
-    /**
-     * Setup test data
-     */
-    setupTestFiles(files: Record<string, string>): void;
-}
-
-type GitHubProps = {
-    owner: string;
-    repo: string;
-    basePath: string;
-    branch?: string;
-    token: string;
-    pathSystem?: DocPathSystem;
+type SchemaToValueType<T extends DocCustomSchema> = {
+    [K in RequiredKeys<T>]: BaseFieldValueType<ExtractFieldType<T[K]>>;
+} & {
+    [K in OptionalKeys<T>]: BaseFieldValueType<ExtractFieldType<T[K]>> | null;
 };
 /**
- * GitHub repository file system using Octokit with separate read/write components
+ * Helper type for type-safe property access
  */
-declare class DocFileSystemOctokit extends DocFileSystem {
-    private readonly owner;
-    private readonly repo;
-    private readonly branch;
-    constructor(props: GitHubProps);
-    /**
-     * Get repository information
-     */
-    getRepositoryInfo(): {
-        owner: string;
-        repo: string;
-        branch: string;
-    };
-}
+type GetValueType<T extends DocCustomSchema, K extends keyof T> = K extends RequiredKeys<T> ? BaseFieldValueType<ExtractFieldType<T[K]>> : BaseFieldValueType<ExtractFieldType<T[K]>> | undefined | null;
+type GetIndexFieldType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends DocFileIndexSchemaField ? Schema[K] : never;
+/**
+ * Infers DocFileMd type from the result of defineSchema
+ */
+type InferDocFileMd<T> = T extends DocCustomSchema ? DocFileMd<T> : never;
+
+declare const DOC_NODE_TYPE_DIRECTORY: "directory";
 
 type Props$3 = {
-    owner: string;
-    repo: string;
-    basePath: string;
-    branch?: string;
-    token: string;
-    pathSystem?: DocPathSystem;
-};
-type FileCache = {
-    sha: string;
-    content: string;
-    size: number;
-    modifiedTime?: string;
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
 };
 /**
- * GitHub repository read-only file system using Octokit
+ * Tree file node value object
  */
-declare class DocFileSystemOctokitRead implements DocFileSystemReadType {
-    protected readonly octokit: Octokit;
-    protected readonly owner: string;
-    protected readonly repo: string;
-    protected readonly branch: string;
-    protected readonly pathSystem: DocPathSystem;
-    protected readonly basePath: string;
-    protected fileCache: Map<string, FileCache>;
+declare class DocTreeFileNodeValue {
+    private readonly props;
     constructor(props: Props$3);
+    get name(): string;
+    get path(): string;
+    get icon(): string;
+    get title(): string;
+    get type(): "file";
     /**
-     * Read file content from GitHub repository
-     */
-    readFile(relativePath: string): Promise<string | null | Error>;
-    /**
-     * 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 file names in directory
-     */
-    readDirectoryFileNames(relativePath?: string): Promise<string[] | Error>;
-    /**
-     * Get list of file paths in directory
-     */
-    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
-    /**
-     * 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;
-    /**
-     * Get file size in bytes
-     */
-    getFileSize(relativePath: string): Promise<number | Error>;
-    /**
-     * Get file last modified time
+     * Convert to plain object
      */
-    getFileModifiedTime(relativePath: string): Promise<Date | Error>;
+    toJson(): DocTreeFileNode;
     /**
-     * Get file creation time (first commit)
+     * Create from properties
      */
-    getFileCreatedTime(relativePath: string): Promise<Date | Error>;
+    static from(props: Props$3): DocTreeFileNodeValue;
     /**
-     * Get cached SHA for a file
+     * Create from JSON object
      */
-    getCachedSha(relativePath: string): string | undefined;
+    static fromJson(json: unknown): DocTreeFileNodeValue;
 }
 
+type DocTreeNodeValue = DocTreeFileNodeValue | DocTreeDirectoryNodeValue;
+
 type Props$2 = {
-    owner: string;
-    repo: string;
-    basePath: string;
-    branch?: string;
-    token: string;
-    pathSystem?: DocPathSystem;
-    reader?: DocFileSystemReadType;
+    name: string;
+    path: string;
+    icon: string;
+    title: string;
+    children: DocTreeNodeValue[];
 };
 /**
- * GitHub repository write-only file system using Octokit
+ * Tree directory node value object
  */
-declare class DocFileSystemOctokitWrite implements DocFileSystemWriteType {
-    private readonly octokit;
-    private readonly owner;
-    private readonly repo;
-    private readonly basePath;
-    private readonly branch;
-    private readonly pathSystem;
-    private readonly reader?;
+declare class DocTreeDirectoryNodeValue {
+    private readonly props;
     constructor(props: Props$2);
+    get name(): string;
+    get path(): string;
+    get icon(): string;
+    get title(): string;
+    get children(): DocTreeNodeValue[];
+    get type(): typeof DOC_NODE_TYPE_DIRECTORY;
     /**
-     * Write content to file in GitHub repository
-     */
-    writeFile(relativePath: string, content: string): Promise<Error | null>;
-    /**
-     * Delete file from GitHub repository
-     */
-    deleteFile(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory by creating a .gitkeep file
-     */
-    createDirectory(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory if it doesn't exist
+     * Convert to plain object
      */
-    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
+    toJson(): DocTreeDirectoryNode;
     /**
-     * Copy file to new location
+     * Create from properties
      */
-    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
+    static from(props: Props$2): DocTreeDirectoryNodeValue;
     /**
-     * Move file to new location
+     * Create from JSON object
      */
-    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
+    static fromJson(json: unknown): DocTreeDirectoryNodeValue;
 }
 
 type Props$1 = {
-    basePath: string;
-    pathSystem?: DocPathSystem;
+    fileSystem: DocFileSystemInterface;
+    pathSystem: DocPathSystem;
+    indexFileName: string;
+    archiveDirectoryName: string;
+    config: DocClientConfig;
 };
 /**
- * Read-only file system implementation
+ * File tree building system
  */
-declare class DocFileSystemRead implements DocFileSystemReadType {
-    protected readonly basePath: string;
-    protected readonly pathSystem: DocPathSystem;
+declare class DocFileTreeSystem {
+    private readonly props;
+    private readonly config;
     constructor(props: Props$1);
     /**
-     * Read file content at the specified path
+     * Build file tree recursively
+     */
+    buildFileTree(directoryPath?: string): Promise<DocTreeNodeValue[] | Error>;
+    /**
+     * Create file node
      */
-    readFile(relativePath: string): Promise<string | null | Error>;
+    private createFileNode;
     /**
-     * Get file name from path
+     * Create directory node
      */
-    readFileName(relativePath: string): string;
+    private createDirectoryNode;
     /**
-     * Get file extension from path
+     * Create index file reference
      */
-    readFileExtension(relativePath: string): string;
+    private createIndexFileReference;
     /**
-     * Get directory path where the file exists
+     * Create MD file reference
      */
-    readFileDirectory(relativePath: string): string;
+    private createMdFileReference;
     /**
-     * Get list of entries in directory
+     * Build directory tree recursively (directories only)
      */
-    readDirectoryFileNames(relativePath?: string): Promise<string[] | Error>;
-    readDirectoryFilePaths(relativePath: string): Promise<string[] | Error>;
+    buildDirectoryTree(directoryPath?: string): Promise<DocTreeDirectoryNodeValue[] | Error>;
     /**
-     * Check if path is a directory
+     * Create directory node for directory tree
      */
-    isDirectory(relativePath: string): Promise<boolean>;
+    private createDirectoryNodeForTree;
+}
+
+/**
+ * Markdown parsing and processing system
+ */
+declare class DocMarkdownSystem {
+    private readonly frontMatterSeparator;
+    constructor();
     /**
-     * Check if path is a file
+     * Detect FrontMatter separator line
      */
-    isFile(relativePath: string): Promise<boolean>;
+    private detectFrontMatterSeparator;
     /**
-     * Check if file or directory exists
+     * Extract FrontMatter
      */
-    exists(relativePath: string): Promise<boolean>;
+    extractFrontMatter(text: string): string | null;
     /**
-     * Check if directory exists
+     * Extract body without FrontMatter (includes title and description)
      */
-    directoryExists(relativePath: string): Promise<boolean>;
+    extractBody(text: string): string;
     /**
-     * Check if file exists
+     * Extract title
      */
-    fileExists(relativePath: string): Promise<boolean>;
+    extractTitle(text: string): string | null;
     /**
-     * Get base path
+     * Extract description (first paragraph after title)
      */
-    getBasePath(): string;
+    extractDescription(text: string): string | null;
     /**
-     * Convert relative path to absolute path
+     * Update title in body (returns body only, without FrontMatter)
      */
-    resolve(relativePath: string): string;
+    updateTitle(text: string, newTitle: string): string;
     /**
-     * Get file size in bytes
+     * Update description in body (returns body only, without FrontMatter)
      */
-    getFileSize(relativePath: string): Promise<number | Error>;
+    updateDescription(text: string, newDescription: string, defaultTitle: string): string;
     /**
-     * Get file last modified time
+     * Skip empty lines
      */
-    getFileModifiedTime(relativePath: string): Promise<Date | Error>;
+    private skipEmptyLines;
     /**
-     * Get file creation time
+     * Generate Markdown text (title + description + body)
      */
-    getFileCreatedTime(relativePath: string): Promise<Date | Error>;
+    static from(title: string, description: string, body: string): string;
 }
 
 type Props = {
-    basePath: string;
+    fileSystem: DocFileSystemInterface;
     pathSystem?: DocPathSystem;
-    reader?: DocFileSystemReadType;
-};
-/**
- * Write-only file system implementation
- */
-declare class DocFileSystemWrite implements DocFileSystemWriteType {
-    protected readonly basePath: string;
-    protected readonly pathSystem: DocPathSystem;
-    private readonly reader?;
-    constructor(props: Props);
-    /**
-     * Write content to file at the specified path (creates directory if needed)
-     */
-    writeFile(relativePath: string, content: string): Promise<Error | null>;
-    /**
-     * Delete file at the specified path
-     */
-    deleteFile(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory
-     */
-    createDirectory(relativePath: string): Promise<Error | null>;
-    /**
-     * Create directory if it doesn't exist
-     */
-    ensureDirectoryExists(relativePath: string): Promise<Error | null>;
-    /**
-     * Copy file
-     */
-    copyFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
+    markdownSystem?: DocMarkdownSystem;
+    fileTreeSystem?: DocFileTreeSystem;
     /**
-     * Move file
+     * Configuration
      */
-    moveFile(sourcePath: string, destinationPath: string): Promise<Error | null>;
+    config?: DocClientConfig;
+};
+declare class DocClient {
+    readonly fileSystem: DocFileSystemInterface;
+    readonly pathSystem: DocPathSystem;
+    readonly markdownSystem: DocMarkdownSystem;
+    readonly fileTreeSystem: DocFileTreeSystem;
+    readonly config: DocClientConfig;
+    constructor(props: Props);
+    basePath(): string;
+    file<Path extends string>(relativePath: Path): InferReference<Path, DocCustomSchema>;
+    file<Path extends string, T extends DocCustomSchema>(relativePath: Path, customSchema: T): InferReference<Path, T>;
+    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[]>;
 }
 
 /**
@@ -2449,67 +1619,6 @@ declare class DocPathSystemMock extends DocPathSystem {
     static createWithSeparator(separator: string): DocPathSystemMock;
 }
 
-/**
- * Schema builder
- * Build schemas in a chain style
- *
- * @example
- * const schema = new SchemaBuilder()
- *   .text("title", true)
- *   .multiRelation("features", true)
- *   .selectText("priority", false)
- *   .build()
- */
-declare class DocSchemaBuilder<T extends DocCustomSchema> {
-    private schema;
-    constructor(schema?: T);
-    text<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "text";
-        required: boolean;
-    }>>;
-    number<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "number";
-        required: boolean;
-    }>>;
-    boolean<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "boolean";
-        required: boolean;
-    }>>;
-    relation<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "relation";
-        required: boolean;
-    }>>;
-    multiRelation<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "multi-relation";
-        required: boolean;
-    }>>;
-    selectText<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "select-text";
-        required: boolean;
-    }>>;
-    selectNumber<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "select-number";
-        required: boolean;
-    }>>;
-    multiText<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "multi-text";
-        required: boolean;
-    }>>;
-    multiNumber<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "multi-number";
-        required: boolean;
-    }>>;
-    multiSelectText<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "multi-select-text";
-        required: boolean;
-    }>>;
-    multiSelectNumber<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
-        type: "multi-select-number";
-        required: boolean;
-    }>>;
-    build(): T;
-}
-
 /**
  * Function that only performs type checking (does nothing at runtime)
  */
@@ -2561,13 +1670,19 @@ declare const docCustomSchemaField: {
         type: "boolean";
         required: boolean;
     };
-    readonly relation: (required: boolean) => {
+    readonly relation: (required: boolean, path: string) => {
         type: "relation";
         required: boolean;
+        title: null;
+        description: null;
+        path: string;
     };
-    readonly multiRelation: (required: boolean) => {
+    readonly multiRelation: (required: boolean, path: string) => {
         type: "multi-relation";
         required: boolean;
+        title: null;
+        description: null;
+        path: string;
     };
     readonly selectText: (required: boolean) => {
         type: "select-text";
@@ -2788,4 +1903,4 @@ declare class DocRelationFieldValue {
     }): DocRelationFieldValue;
 }
 
-export { type BaseFieldValueType, type DetectFileType, 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, DocCustomSchemaFieldValue, type DocDirectory, type DocDirectoryFile, DocDirectoryPathValue, DocDirectoryReference, type DocFieldTypeLiteral, type DocFile, type DocFileAny, type DocFileEntity, type DocFileIndex, type DocFileIndexAny, type DocFileIndexContent, DocFileIndexContentValue, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexMetaValue, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, DocFileIndexSchemaValue, type DocFileMd, type DocFileMdAny, type DocFileMdContent, DocFileMdContentValue, DocFileMdEntity, type DocFileMdMeta, type DocFileMdMetaAny, DocFileMdMetaValue, DocFileMdReference, type DocFilePath, DocFilePathValue, DocFileRelationReference, DocFileSystem, DocFileSystemJson, DocFileSystemJsonRead, DocFileSystemJsonWrite, DocFileSystemMock, DocFileSystemOctokit, DocFileSystemOctokitRead, DocFileSystemOctokitWrite, DocFileSystemRead, type DocFileSystemReadType, DocFileSystemWrite, type DocFileSystemWriteType, DocFileTreeSystem, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, type DocMetaField, type DocMetaFieldBoolean, 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, DocPathSystemMock, type DocRelation, type DocRelationField, DocRelationFieldValue, type DocRelationFile, DocRelationFileValue, DocRelationValue, DocSchemaBuilder, 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, DocTreeDirectoryNodeValue, type DocTreeFileNode, DocTreeFileNodeValue, type DocTreeNode, type DocTreeNodeValue, type Equals, type ExtractFieldType, type ExtractRequired, type FieldValueType, type GetIndexFieldType, type GetValueType, type InferDocFileMd, type InferReference, type MultiRelationKeys, type OptionalKeys, type RecordKey, type RelationKeys, type RequiredKeys, type SchemaToValueType, type UpdateFunction, assertType, defaultTestConfig, defineSchema, docCustomSchemaField, expectType, zDocClientConfig, zDocFileIndex, zDocFileIndexSchemaField, zDocFileMd, zDocFilePath, zDocFileUnknown, zDocMetaField, zDocMetaFieldBoolean, 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, type DetectFileType, 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, DocCustomSchemaFieldValue, type DocDirectory, type DocDirectoryFile, DocDirectoryPathValue, DocDirectoryReference, type DocFieldTypeLiteral, type DocFile, type DocFileAny, type DocFileEntity, type DocFileIndex, type DocFileIndexAny, type DocFileIndexContent, DocFileIndexContentValue, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexMetaValue, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, DocFileIndexSchemaValue, type DocFileMd, type DocFileMdAny, type DocFileMdContent, DocFileMdContentValue, DocFileMdEntity, type DocFileMdMeta, type DocFileMdMetaAny, DocFileMdMetaValue, DocFileMdReference, type DocFilePath, DocFilePathValue, DocFileRelationReference, DocFileTreeSystem, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, type DocMetaField, type DocMetaFieldBoolean, 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, DocPathSystemMock, type DocRelation, type DocRelationField, DocRelationFieldValue, type DocRelationFile, DocRelationFileValue, DocRelationValue, 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, DocTreeDirectoryNodeValue, type DocTreeFileNode, DocTreeFileNodeValue, type DocTreeNode, type DocTreeNodeValue, type Equals, type ExtractFieldType, type ExtractRequired, type FieldValueType, type GetIndexFieldType, type GetValueType, type InferDocFileMd, type InferReference, type MultiRelationKeys, type OptionalKeys, type RecordKey, type RelationKeys, type RequiredKeys, type SchemaToValueType, type UpdateFunction, assertType, defaultTestConfig, defineSchema, docCustomSchemaField, expectType };