@interactive-inc/docs-client 0.0.16 → 0.0.18

package/build/index.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { zDocClientConfig, zDocFilePath, zDocMetaFieldRelation, zDocMetaFieldMultiRelation, zDocMetaFieldText, zDocMetaFieldNumber, zDocMetaFieldBoolean, zDocMetaFieldMultiText, zDocMetaFieldMultiNumber, zDocMetaFieldMultiBoolean, zDocFileUnknown, zDocFileIndexSchemaField, zDocSchemaFieldText, zDocSchemaFieldNumber, zDocSchemaFieldBoolean, zDocSchemaFieldRelation, zDocSchemaFieldSelectText, zDocSchemaFieldSelectNumber, zDocSchemaFieldMultiText, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiSelectNumber, zDocRelation, zDocRelationFile, zDocMetaField, zDocMetaFieldSelectText, zDocMetaFieldSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiSelectNumber, zDocMetaFieldTypeText, zDocMetaFieldTypeNumber, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeRelation, zDocMetaFieldType, zDocRelationField } from './models.js';
+import { zDocClientConfig, zDocFilePath, zDocFileIndexSchemaField, zDocSchemaFieldText, zDocSchemaFieldNumber, zDocSchemaFieldBoolean, zDocSchemaFieldRelation, zDocSchemaFieldSelectText, zDocSchemaFieldSelectNumber, zDocSchemaFieldMultiText, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiSelectNumber, zDocRelation, zDocRelationFile, zDocMetaFieldRelation, zDocMetaFieldMultiRelation, zDocMetaFieldText, zDocMetaFieldNumber, zDocMetaFieldBoolean, zDocMetaFieldMultiText, zDocMetaFieldMultiNumber, zDocMetaFieldMultiBoolean, zDocFileUnknown, zDocMetaField, zDocMetaFieldSelectText, zDocMetaFieldSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiSelectNumber, zDocMetaFieldTypeText, zDocMetaFieldTypeNumber, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeRelation, zDocMetaFieldType, zDocRelationField } from './models.js';
 export { zDocCustomSchema, zDocCustomSchemaField, zDocCustomSchemaFieldBoolean, zDocCustomSchemaFieldMultiNumber, zDocCustomSchemaFieldMultiRelation, zDocCustomSchemaFieldMultiSelectNumber, zDocCustomSchemaFieldMultiSelectText, zDocCustomSchemaFieldMultiText, zDocCustomSchemaFieldNumber, zDocCustomSchemaFieldRelation, zDocCustomSchemaFieldSelectNumber, zDocCustomSchemaFieldSelectText, zDocCustomSchemaFieldText, zDocFile, zDocFileIndex, zDocFileIndexContent, zDocFileIndexMeta, zDocFileIndexMetaInput, zDocFileIndexSchema, zDocFileIndexSchemaInput, zDocFileMd, zDocFileMdContent, zDocFileMdContentInput, zDocFileMdInput, zDocFileMdMeta, zDocFileMdMetaInput, zDocMetaFieldTypeMultiNumber, zDocMetaFieldTypeMultiRelation, zDocMetaFieldTypeMultiSelectNumber, zDocMetaFieldTypeMultiSelectText, zDocMetaFieldTypeMultiText, zDocTreeDirectoryNode, zDocTreeFileNode, zDocTreeNode } from './models.js';
 
 /**
@@ -140,262 +140,592 @@ declare class DocFileSystem {
 }
 
 /**
- * Single boolean type schema field
+ * Meta
  */
-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;
+declare class DocFileMdMetaValue<T extends DocCustomSchema> {
+    readonly value: SchemaToValueType<T>;
+    readonly customSchema: T;
+    constructor(value: SchemaToValueType<T>, customSchema: T);
+    private validateValue;
+    private getValueField;
+    get keys(): Array<keyof T>;
     /**
-     * Validate value type
+     * Return a new instance with a single property updated
      */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
-}
-
-/**
- * Multiple number type schema field
- */
-declare class 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;
+    withProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdMetaValue<T>;
     /**
-     * Validate value
+     * Return a new instance with an unknown schema
+     * Allows accepting Record<string, unknown> schemas from external sources
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiNumberValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiNumberValue<RecordKey>;
-}
-
-/**
- * Multiple relation type schema field
- */
-declare class 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;
+    withUnknownSchema(draft: Record<string, unknown>): DocFileMdMetaValue<DocCustomSchema>;
+    schemaField<K extends keyof T>(key: K): T[K];
+    field<K extends keyof T>(key: K): FieldValueType<ExtractFieldType<T[K]>, ExtractRequired<T[K]>>;
+    relation(key: keyof T): DocMetaFieldRelation;
+    multiRelation(key: keyof T): DocMetaFieldMultiRelation;
+    text(key: keyof T): DocMetaFieldText;
+    number(key: keyof T): DocMetaFieldNumber;
+    boolean(key: keyof T): DocMetaFieldBoolean;
+    multiText(key: keyof T): DocMetaFieldMultiText;
+    multiNumber(key: keyof T): DocMetaFieldMultiNumber;
+    multiBoolean(key: keyof T): DocMetaFieldMultiBoolean;
+    hasKey(key: keyof T): boolean;
     /**
-     * Validate value
+     * Generate from Markdown text
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiRelationValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiRelationValue<RecordKey>;
+    static fromYamlText<T extends DocCustomSchema>(yamlText: string, customSchema: T): DocFileMdMetaValue<T>;
+    static empty<T extends DocCustomSchema>(customSchema: T): DocFileMdMetaValue<T>;
+    toJson(): SchemaToValueType<T>;
+    toYaml(): string;
 }
 
 /**
- * Multiple select number type schema field
+ * File: Markdown > Content
  */
-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;
+declare class DocFileMdContentValue<T extends DocCustomSchema> {
+    readonly value: DocFileMdContent<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMdContent<T>, customSchema: T);
     /**
-     * Validate value
+     * Content body (does not include frontMatter)
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectNumberValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectNumberValue<RecordKey>;
-}
-
-/**
- * Multiple select text type schema field
- */
-declare class 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;
+    get body(): string;
     /**
-     * Validate value
+     * Title
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiSelectTextValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiSelectTextValue<RecordKey>;
-}
-
-/**
- * Multiple text type schema field
- */
-declare class 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
+     * Description
      */
-    validate(value: unknown): boolean;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiTextValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiTextValue<RecordKey>;
-}
-
-/**
- * Single number type schema field
- */
-declare class 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
+     * FrontMatter (uses constructor's Zod schema or argument schema)
      */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldNumberValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldNumberValue<RecordKey>;
-}
-
-/**
- * Single relation type schema field
- */
-declare class 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;
+    meta(): DocFileMdMetaValue<T>;
     /**
-     * Validate value type
+     * Update title
      */
-    validate(value: unknown): boolean;
-    static empty(key: RecordKey): DocSchemaFieldRelationValue<RecordKey>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldRelationValue<RecordKey>;
+    withTitle(title: string): DocFileMdContentValue<T>;
+    /**
+     * Update description
+     */
+    withDescription(description: string, defaultTitle?: string): DocFileMdContentValue<T>;
+    /**
+     * Update content
+     */
+    withContent(content: string): DocFileMdContentValue<T>;
+    /**
+     * Update FrontMatter
+     */
+    withMeta<U extends DocCustomSchema>(meta: DocFileMdMetaValue<U>): DocFileMdContentValue<U>;
+    /**
+     * 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 Markdown text
+     */
+    toMarkdownText(): string;
+    /**
+     * 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
+     */
+    toJson(): DocFileMdContent<T>;
 }
 
 /**
- * Single select number type schema field
+ * Markdown file entity
  */
-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 DocFileMdEntity<T extends DocCustomSchema> {
+    readonly value: DocFileMd<T>;
+    private readonly customSchema;
+    constructor(value: DocFileMd<T>, customSchema: T);
     /**
-     * Validate value
+     * Content
      */
-    validate(value: unknown): boolean;
-    toJson(): DocFileIndexSchemaField;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberValue<RecordKey>;
+    get content(): DocFileMdContentValue<T>;
+    /**
+     * Path information
+     */
+    get path(): DocFilePath;
+    /**
+     * Update content
+     */
+    withContent(content: DocFileMdContentValue<T>): DocFileMdEntity<T>;
+    /**
+     * Update path
+     */
+    withPath(path: DocFilePath): DocFileMdEntity<T>;
+    withMeta(meta: DocFileMdMetaValue<T>): DocFileMdEntity<T>;
+    withTitle(title: string): DocFileMdEntity<T>;
+    withDescription(description: string, defaultTitle?: string): DocFileMdEntity<T>;
+    /**
+     * Convert to JSON format
+     */
+    toJson(): DocFileMd<T>;
 }
 
+type Props$8<T extends DocCustomSchema> = {
+    path: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+    customSchema: T;
+    config: DocClientConfig;
+};
 /**
- * Single select text type schema field
+ * File reference
  */
-declare class DocSchemaFieldSelectTextValue<T extends RecordKey> {
+declare class DocFileMdReference<T extends DocCustomSchema> {
+    private readonly props;
+    private readonly pathSystem;
+    private readonly customSchema;
+    constructor(props: Props$8<T>);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
+    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
+     */
+    readText(): Promise<Error | string>;
+    /**
+     * Write entity
+     */
+    write(entity: DocFileMdEntity<T>): Promise<null>;
+    writeText(text: string): Promise<void>;
+    /**
+     * Create new file with default content
+     */
+    writeDefault(): Promise<void>;
+    /**
+     * Delete file
+     */
+    delete(): Promise<Error | null>;
+    /**
+     * Copy file
+     */
+    copyTo(destinationPath: string): Promise<void>;
+    /**
+     * Move file
+     */
+    moveTo(destinationPath: string): Promise<void>;
+    /**
+     * 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>;
+    /**
+     * Get file last modified time
+     */
+    lastModified(): Promise<Date>;
+    /**
+     * Get file creation time
+     */
+    createdAt(): Promise<Date>;
+    directory(): DocDirectoryReference<T>;
+    /**
+     * Get relation based on schema
+     */
+    relation<U extends DocCustomSchema = DocCustomSchema>(key: RelationKeys<T>, targetSchema?: U): Promise<DocFileMdReference<U> | Error | null>;
+    /**
+     * Get index.md in the same directory
+     */
+    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>;
+}
+
+/**
+ * Unknown file entity
+ */
+declare class DocFileUnknownEntity {
+    readonly value: DocFileUnknown;
+    constructor(value: DocFileUnknown);
+    /**
+     * Content
+     */
+    get content(): string;
+    /**
+     * Path information
+     */
+    get path(): DocFilePath;
+    /**
+     * Update content
+     */
+    withContent(content: string): DocFileUnknownEntity;
+    /**
+     * Update path
+     */
+    withPath(path: DocFilePath): DocFileUnknownEntity;
+    toJson(): DocFileUnknown;
+}
+
+type Props$7 = {
+    path: string;
+    fileSystem: DocFileSystem;
+    pathSystem: DocPathSystem;
+    config: DocClientConfig;
+};
+/**
+ * File reference
+ */
+declare class DocFileUnknownReference {
+    private readonly props;
+    private readonly pathSystem;
+    constructor(props: Props$7);
+    get fileSystem(): DocFileSystem;
+    get basePath(): string;
+    get path(): string;
+    get directoryPath(): string;
+    get fileFullPath(): string;
+    get durectoryPath(): string;
+    directory<T extends DocCustomSchema>(customSchema: T): DocDirectoryReference<T>;
+    directory(): DocDirectoryReference<DocCustomSchema>;
+    read(): Promise<Error | DocFileUnknownEntity>;
+    /**
+     * Read file content
+     */
+    readContent(): Promise<Error | string>;
+    /**
+     * Write content to file
+     */
+    writeContent(content: string): Promise<void>;
+    /**
+     * Write entity
+     */
+    write(entity: DocFileUnknownEntity): Promise<void>;
+    /**
+     * Write raw content
+     */
+    writeRaw(content: string): Promise<void>;
+    /**
+     * Delete file
+     */
+    delete(): Promise<Error | null>;
+    /**
+     * Check if file exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Copy file
+     */
+    copyTo(destinationPath: string): Promise<void>;
+    /**
+     * Move file
+     */
+    moveTo(destinationPath: string): Promise<void>;
+    /**
+     * Get file size in bytes
+     */
+    size(): Promise<number>;
+    /**
+     * Get file last modified time
+     */
+    lastModified(): Promise<Date>;
+    /**
+     * Get file creation time
+     */
+    createdAt(): Promise<Date>;
+    /**
+     * Move file to archive and return new reference
+     */
+    archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+    /**
+     * Restore file from archive and return new reference
+     */
+    restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+}
+
+/**
+ * Single boolean type schema field
+ */
+declare class DocSchemaFieldBooleanValue<T extends RecordKey> {
     readonly key: T;
-    readonly value: DocSchemaFieldSelectText;
-    constructor(key: T, value: DocSchemaFieldSelectText);
-    get type(): "select-text";
+    readonly value: DocSchemaFieldBoolean;
+    constructor(key: T, value: DocSchemaFieldBoolean);
+    get type(): "boolean";
     get required(): boolean;
     get title(): string;
     get description(): string;
-    get default(): string | null;
-    get options(): string[];
+    get default(): boolean | null;
     readonly isArray = false;
     readonly isSingle = true;
-    readonly isSelect = true;
-    readonly isTextSelect = true;
+    readonly isBoolean = true;
     toJson(): DocFileIndexSchemaField;
     /**
      * Validate value type
      */
     validate(value: unknown): boolean;
-    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextValue<T>;
-    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextValue<RecordKey>;
+    static empty(key: RecordKey): DocSchemaFieldBooleanValue<RecordKey>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldBooleanValue<RecordKey>;
 }
 
 /**
- * Single text type schema field
+ * Multiple number type schema field
  */
-declare class DocSchemaFieldTextValue<T extends RecordKey> {
+declare class DocSchemaFieldMultiNumberValue<T extends RecordKey> {
     readonly key: T;
-    readonly value: DocSchemaFieldText;
-    constructor(key: T, value: DocSchemaFieldText);
+    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;
+    /**
+     * Validate value
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldMultiNumberValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldMultiNumberValue<RecordKey>;
+}
+
+/**
+ * Multiple relation type schema field
+ */
+declare class 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 normalize(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 normalize(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 normalize(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 normalize(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 normalize(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 normalize(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;
+    /**
+     * Validate value
+     */
+    validate(value: unknown): boolean;
+    toJson(): DocFileIndexSchemaField;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectNumberValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectNumberValue<RecordKey>;
+}
+
+/**
+ * Single select text type schema field
+ */
+declare class 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;
+    /**
+     * Validate value type
+     */
+    validate(value: unknown): boolean;
+    static empty<T extends RecordKey>(key: T): DocSchemaFieldSelectTextValue<T>;
+    static normalize(key: RecordKey, record: Record<RecordKey, unknown>): DocSchemaFieldSelectTextValue<RecordKey>;
+}
+
+/**
+ * Single text type schema field
+ */
+declare class DocSchemaFieldTextValue<T extends RecordKey> {
+    readonly key: T;
+    readonly value: DocSchemaFieldText;
+    constructor(key: T, value: DocSchemaFieldText);
     get type(): "text";
     get required(): boolean;
     get title(): string;
@@ -637,6 +967,33 @@ 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;
+/**
+ * Infer reference type from path
+ */
+type InferReference<Path extends string, Schema extends DocCustomSchema> = FileTypeToReference<DetectFileType<Path>, Schema>;
 /**
  * File path information type
  */
@@ -678,675 +1035,349 @@ 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 definitions for DocFileIndexSchema
- */
-type ExtractIndexFieldType<T> = T extends {
-    type: infer Type;
-} ? Type : never;
-type GetIndexFieldType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends DocFileIndexSchemaField ? Schema[K] : never;
-type GetIndexFieldValueType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends {
-    type: infer Type;
-} ? Type extends "text" ? DocSchemaFieldTextValue<K> : Type extends "number" ? DocSchemaFieldNumberValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanValue<K> : Type extends "relation" ? DocSchemaFieldRelationValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberValue<K> : Type extends "multi-text" ? DocSchemaFieldMultiTextValue<K> : Type extends "multi-number" ? DocSchemaFieldMultiNumberValue<K> : Type extends "multi-relation" ? DocSchemaFieldMultiRelationValue<K> : Type extends "multi-select-text" ? DocSchemaFieldMultiSelectTextValue<K> : Type extends "multi-select-number" ? DocSchemaFieldMultiSelectNumberValue<K> : never : never;
-/**
- * Infers DocFileMd type from the result of defineSchema
- */
-type InferDocFileMd<T> = T extends DocCustomSchema ? DocFileMd<T> : never;
-
-/**
- * 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;
-    /**
-     * Create from file path and title
-     */
-    static from(filePath: string, title: string | null): DocRelationFileValue;
-    /**
-     * Extract file name from file path (without extension)
-     */
-    private static extractFileName;
-    /**
-     * Convert to JSON format
-     */
-    toJson(): DocRelationFile;
-}
-
-/**
- * Manages relation information
- */
-declare class DocRelationValue {
-    readonly value: DocRelation;
-    constructor(value: DocRelation);
-    /**
-     * Relation path
-     */
-    get path(): string;
-    /**
-     * List of related files (value objects)
-     */
-    get files(): DocRelationFileValue[];
-    /**
-     * Get file count
-     */
-    get fileCount(): number;
-    /**
-     * Whether it's empty
-     */
-    get isEmpty(): boolean;
-    /**
-     * Create empty relation entity
-     */
-    static empty(path: string): DocRelationValue;
-    /**
-     * Export as JSON format
-     */
-    toJson(): DocRelation;
-}
-
-type Props$8 = {
-    filePath: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-};
-/**
- * Relation file reference
- */
-declare class DocFileRelationReference {
-    private readonly props;
-    private readonly pathSystem;
-    constructor(props: Props$8);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    /**
-     * Relation path
-     */
-    get path(): string;
-    /**
-     * Full path
-     */
-    get fullPath(): string;
-    read(): Promise<DocRelationValue | null>;
-    /**
-     * Read list of relation files
-     */
-    readFiles(): Promise<DocRelationFileValue[]>;
-    /**
-     * Read single relation file
-     */
-    readFile(filePath: string): Promise<DocRelationFileValue | null>;
-    /**
-     * Check if file exists
-     */
-    exists(slug: string): Promise<boolean>;
-    /**
-     * Get list of file names (without extension)
-     */
-    readSlugs(): Promise<string[]>;
-    /**
-     * Get file count
-     */
-    count(): Promise<number>;
-    /**
-     * Check if empty
-     */
-    isEmpty(): Promise<boolean>;
-}
-
-/**
- * Type-safe schema value object
- */
-declare class DocFileIndexSchemaValue<T extends DocCustomSchema> {
-    readonly value: DocFileIndexSchema<keyof T>;
-    readonly customSchema: T;
-    constructor(value: DocFileIndexSchema<keyof T>, customSchema: T);
-    /**
-     * Get list of field names
-     * Automatically type-safe when using Zod schema
-     */
-    get fieldNames(): Array<keyof T>;
-    /**
-     * Get field with specified field name
-     * Returns type-safe specific field Value object
-     */
-    field<K extends keyof T>(key: K): T[K]["type"] extends infer Type ? Type extends "text" ? DocSchemaFieldTextValue<K> : Type extends "number" ? DocSchemaFieldNumberValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanValue<K> : Type extends "relation" ? DocSchemaFieldRelationValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberValue<K> : Type extends "multi-text" ? DocSchemaFieldMultiTextValue<K> : Type extends "multi-number" ? DocSchemaFieldMultiNumberValue<K> : Type extends "multi-relation" ? DocSchemaFieldMultiRelationValue<K> : Type extends "multi-select-text" ? DocSchemaFieldMultiSelectTextValue<K> : Type extends "multi-select-number" ? DocSchemaFieldMultiSelectNumberValue<K> : never : never;
-    relation<K extends keyof T>(key: K): DocSchemaFieldRelationValue<K>;
-    multiRelation<K extends keyof T>(key: K): DocSchemaFieldMultiRelationValue<K>;
-    /**
-     * Get all fields
-     * Note: For type safety, it's recommended to use field() method individually
-     */
-    get fields(): DocFileIndexSchema<keyof T>[keyof T][];
-    get relationFields(): (DocSchemaFieldRelationValue<string> | DocSchemaFieldMultiRelationValue<string>)[];
-    toJson(): DocFileIndexSchema<keyof T>;
-    /**
-     * Create empty schema entity
-     * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
-     */
-    static empty(): DocFileIndexSchemaValue<{}>;
-}
-
-/**
- * File: index.md > content > FrontMatter
- */
-declare class DocFileIndexMetaValue<T extends DocCustomSchema> {
-    readonly value: DocFileIndexMeta<T>;
-    readonly customSchema: T;
-    private readonly config;
-    /**
-     * Additional properties to include in the meta data
-     */
-    private readonly additionalProperties;
-    constructor(value: DocFileIndexMeta<T>, customSchema: T, config: DocClientConfig, additionalProperties?: Record<string, unknown>);
-    /**
-     * Get icon
-     */
-    get icon(): string | null;
-    /**
-     * Get schema
-     */
-    schema(): DocFileIndexSchemaValue<T>;
-    /**
-     * Check if schema is defined
-     */
-    get hasSchema(): boolean;
-    /**
-     * Update icon field
-     */
-    withIcon(value: string | null): DocFileIndexMetaValue<T>;
-    /**
-     * Update schema field
-     */
-    withSchema(value: DocFileIndexSchema<keyof T>): DocFileIndexMetaValue<T>;
-    /**
-     * Return a new instance with an unknown schema
-     * Allows accepting Record<string, unknown> schemas from external sources
-     */
-    withUnknownSchema(draft: Record<string, unknown>): DocFileIndexMetaValue<DocCustomSchema>;
-    /**
-     * Output in JSON format
-     */
-    toJson(): DocFileIndexMeta<T>;
-    /**
-     * Output in YAML format
-     */
-    toYaml(): string;
-    /**
-     * Generate from Markdown text (can process incomplete data)
-     */
-    static from<T extends DocCustomSchema>(markdownText: string, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
-    /**
-     * Generate directly from data (can process incomplete data)
-     */
-    static fromRecord<T extends DocCustomSchema>(record: Record<string, unknown>, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
-    /**
-     * Generate empty FrontMatter
-     */
-    static empty<T extends DocCustomSchema>(customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
-    /**
-     * Extract icon
-     */
-    private static extractIcon;
-    /**
-     * Extract schema part
-     */
-    private static extractSchema;
-    /**
-     * Normalize entire schema
-     */
-    private static normalizeSchema;
-    static emptySchema<T extends DocCustomSchema>(customSchema: T): DocFileIndexSchema<keyof T>;
-}
+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 definitions for DocFileIndexSchema
+ */
+type ExtractIndexFieldType<T> = T extends {
+    type: infer Type;
+} ? Type : never;
+type GetIndexFieldType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends DocFileIndexSchemaField ? Schema[K] : never;
+type GetIndexFieldValueType<Schema extends DocFileIndexSchema<RecordKey>, K extends keyof Schema> = Schema[K] extends {
+    type: infer Type;
+} ? Type extends "text" ? DocSchemaFieldTextValue<K> : Type extends "number" ? DocSchemaFieldNumberValue<K> : Type extends "boolean" ? DocSchemaFieldBooleanValue<K> : Type extends "relation" ? DocSchemaFieldRelationValue<K> : Type extends "select-text" ? DocSchemaFieldSelectTextValue<K> : Type extends "select-number" ? DocSchemaFieldSelectNumberValue<K> : Type extends "multi-text" ? DocSchemaFieldMultiTextValue<K> : Type extends "multi-number" ? DocSchemaFieldMultiNumberValue<K> : Type extends "multi-relation" ? DocSchemaFieldMultiRelationValue<K> : Type extends "multi-select-text" ? DocSchemaFieldMultiSelectTextValue<K> : Type extends "multi-select-number" ? DocSchemaFieldMultiSelectNumberValue<K> : never : never;
+/**
+ * Infers DocFileMd type from the result of defineSchema
+ */
+type InferDocFileMd<T> = T extends DocCustomSchema ? DocFileMd<T> : never;
 
 /**
- * File: index.md > content
+ * Relation file
  */
-declare class DocFileIndexContentValue<T extends DocCustomSchema> {
-    readonly value: DocFileIndexContent<T>;
-    private readonly customSchema;
-    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>;
+declare class DocRelationFileValue {
+    private readonly value;
+    constructor(value: DocRelationFile);
     /**
-     * Generate complete Markdown text
+     * File path
      */
-    toMarkdownText(): string;
+    get id(): string;
     /**
-     * Update content
+     * Slug
      */
-    withContent(content: string): DocFileIndexContentValue<T>;
+    get slug(): string;
     /**
-     * Update FrontMatter
+     * Display label
      */
-    withMeta(meta: DocFileIndexMeta<T>): DocFileIndexContentValue<T>;
+    get label(): string;
     /**
-     * Generate default index.md content
+     * Create from file path and title
      */
-    static empty<T extends DocCustomSchema = DocCustomSchema>(directoryName: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
+    static from(filePath: string, title: string | null): DocRelationFileValue;
     /**
-     * Generate complete text combining FrontMatter and body
+     * Extract file name from file path (without extension)
      */
-    toText(): string;
+    private static extractFileName;
     /**
-     * Output in JSON format
+     * Convert to JSON format
      */
-    toJson(): DocFileIndexContent<T>;
+    toJson(): DocRelationFile;
 }
 
 /**
- * Document directory entity
+ * Manages relation information
  */
-declare class DocFileIndexEntity<T extends DocCustomSchema> {
-    readonly value: DocFileIndex<T>;
-    private readonly customSchema;
-    private readonly config;
-    constructor(value: DocFileIndex<T>, customSchema: T, config?: DocClientConfig);
+declare class DocRelationValue {
+    readonly value: DocRelation;
+    constructor(value: DocRelation);
     /**
-     * Content
+     * Relation path
      */
-    get content(): DocFileIndexContentValue<T>;
+    get path(): string;
     /**
-     * Path information
+     * List of related files (value objects)
      */
-    get path(): DocFilePath;
+    get files(): DocRelationFileValue[];
     /**
-     * Update content
+     * Get file count
      */
-    withContent(content: DocFileIndexContentValue<T>): DocFileIndexEntity<T>;
+    get fileCount(): number;
     /**
-     * Update path
+     * Whether it's empty
      */
-    withPath(path: DocFilePath): DocFileIndexEntity<T>;
+    get isEmpty(): boolean;
     /**
-     * Convert to index file schema format
+     * Create empty relation entity
      */
-    toJson(): DocFileIndex<T>;
+    static empty(path: string): DocRelationValue;
+    /**
+     * Export as JSON format
+     */
+    toJson(): DocRelation;
 }
 
-type Props$7<T extends DocCustomSchema> = {
-    customSchema: T;
-    path: string;
+type Props$6 = {
+    filePath: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
-    config: DocClientConfig;
 };
 /**
- * File reference class
+ * Relation file reference
  */
-declare class DocFileIndexReference<T extends DocCustomSchema> {
+declare class DocFileRelationReference {
     private readonly props;
     private readonly pathSystem;
-    private readonly customSchema;
-    constructor(props: Props$7<T>);
+    constructor(props: Props$6);
     get fileSystem(): DocFileSystem;
     get basePath(): string;
-    get filePath(): string;
-    get fileFullPath(): string;
-    get durectoryPath(): string;
-    read(): Promise<DocFileIndexEntity<T>>;
-    /**
-     * Read file content
-     */
-    readContent(): Promise<Error | string>;
     /**
-     * Write content to file
+     * Relation path
      */
-    writeContent(content: string): Promise<void>;
+    get path(): string;
     /**
-     * Write entity
+     * Full path
      */
-    write(entity: DocFileIndexEntity<T>): Promise<void>;
+    get fullPath(): string;
+    read(): Promise<DocRelationValue | null>;
     /**
-     * Create new file with default content
+     * Read list of relation files
      */
-    writeDefault(): Promise<null>;
+    readFiles(): Promise<DocRelationFileValue[]>;
     /**
-     * Delete file
+     * Read single relation file
      */
-    delete(): Promise<Error | null>;
+    readFile(filePath: string): Promise<DocRelationFileValue | null>;
     /**
      * Check if file exists
      */
-    exists(): Promise<boolean>;
-    relations(): Promise<DocFileRelationReference[]>;
-    readRelations(): Promise<DocRelationValue[]>;
-    /**
-     * Get file size in bytes
-     */
-    size(): Promise<number>;
-    /**
-     * Get last modified date
-     */
-    lastModified(): Promise<Date>;
+    exists(slug: string): Promise<boolean>;
     /**
-     * Get file creation date
+     * Get list of file names (without extension)
      */
-    createdAt(): Promise<Date>;
+    readSlugs(): Promise<string[]>;
     /**
-     * Move file to archive and return new reference
+     * Get file count
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
+    count(): Promise<number>;
     /**
-     * Restore file from archive and return new reference
+     * Check if empty
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
+    isEmpty(): Promise<boolean>;
 }
 
 /**
- * Meta
+ * Type-safe schema value object
  */
-declare class DocFileMdMetaValue<T extends DocCustomSchema> {
-    readonly value: SchemaToValueType<T>;
+declare class DocFileIndexSchemaValue<T extends DocCustomSchema> {
+    readonly value: DocFileIndexSchema<keyof T>;
     readonly customSchema: T;
-    constructor(value: SchemaToValueType<T>, customSchema: T);
-    private validateValue;
-    private getValueField;
-    get keys(): Array<keyof T>;
-    /**
-     * Return a new instance with a single property updated
-     */
-    withProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdMetaValue<T>;
-    /**
-     * Return a new instance with an unknown schema
-     * Allows accepting Record<string, unknown> schemas from external sources
-     */
-    withUnknownSchema(draft: Record<string, unknown>): DocFileMdMetaValue<DocCustomSchema>;
-    schemaField<K extends keyof T>(key: K): T[K];
-    field<K extends keyof T>(key: K): FieldValueType<ExtractFieldType<T[K]>, ExtractRequired<T[K]>>;
-    relation(key: keyof T): DocMetaFieldRelation;
-    multiRelation(key: keyof T): DocMetaFieldMultiRelation;
-    text(key: keyof T): DocMetaFieldText;
-    number(key: keyof T): DocMetaFieldNumber;
-    boolean(key: keyof T): DocMetaFieldBoolean;
-    multiText(key: keyof T): DocMetaFieldMultiText;
-    multiNumber(key: keyof T): DocMetaFieldMultiNumber;
-    multiBoolean(key: keyof T): DocMetaFieldMultiBoolean;
-    hasKey(key: keyof T): boolean;
-    /**
-     * Generate from Markdown text
-     */
-    static fromYamlText<T extends DocCustomSchema>(yamlText: string, customSchema: T): DocFileMdMetaValue<T>;
-    static empty<T extends DocCustomSchema>(customSchema: T): DocFileMdMetaValue<T>;
-    toJson(): SchemaToValueType<T>;
-    toYaml(): string;
-}
-
-/**
- * File: Markdown > Content
- */
-declare class DocFileMdContentValue<T extends DocCustomSchema> {
-    readonly value: DocFileMdContent<T>;
-    private readonly customSchema;
-    constructor(value: DocFileMdContent<T>, customSchema: T);
+    constructor(value: DocFileIndexSchema<keyof T>, customSchema: T);
     /**
-     * Content body (does not include frontMatter)
+     * Get list of field names
+     * Automatically type-safe when using Zod schema
      */
-    get body(): string;
+    get fieldNames(): Array<keyof T>;
     /**
-     * Title
+     * Get field with specified field name
+     * Returns type-safe specific field Value object
      */
-    get title(): string;
+    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>;
     /**
-     * Description
+     * Get all fields
+     * Note: For type safety, it's recommended to use field() method individually
      */
-    get description(): string;
+    get fields(): DocFileIndexSchema<keyof T>[keyof T][];
+    get relationFields(): (DocSchemaFieldRelationValue<string> | DocSchemaFieldMultiRelationValue<string>)[];
+    toJson(): DocFileIndexSchema<keyof T>;
     /**
-     * FrontMatter (uses constructor's Zod schema or argument schema)
+     * Create empty schema entity
+     * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
      */
-    meta(): DocFileMdMetaValue<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;
     /**
-     * Update title
+     * Additional properties to include in the meta data
      */
-    withTitle(title: string): DocFileMdContentValue<T>;
+    private readonly additionalProperties;
+    constructor(value: DocFileIndexMeta<T>, customSchema: T, config: DocClientConfig, additionalProperties?: Record<string, unknown>);
     /**
-     * Update description
+     * Get icon
      */
-    withDescription(description: string, defaultTitle?: string): DocFileMdContentValue<T>;
+    get icon(): string | null;
     /**
-     * Update content
+     * Get schema
      */
-    withContent(content: string): DocFileMdContentValue<T>;
+    schema(): DocFileIndexSchemaValue<T>;
     /**
-     * Update FrontMatter
+     * Check if schema is defined
      */
-    withMeta<U extends DocCustomSchema>(meta: DocFileMdMetaValue<U>): DocFileMdContentValue<U>;
+    get hasSchema(): boolean;
     /**
-     * Update specific property of FrontMatter
+     * Update icon field
      */
-    withMetaProperty<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): DocFileMdContentValue<T>;
+    withIcon(value: string | null): DocFileIndexMetaValue<T>;
     /**
-     * Generate from Markdown text
+     * Update schema field
      */
-    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T): DocFileMdContentValue<T>;
+    withSchema(value: DocFileIndexSchema<keyof T>): DocFileIndexMetaValue<T>;
     /**
-     * Generate complete Markdown text
+     * Return a new instance with an unknown schema
+     * Allows accepting Record<string, unknown> schemas from external sources
      */
-    toMarkdownText(): string;
+    withUnknownSchema(draft: Record<string, unknown>): DocFileIndexMetaValue<DocCustomSchema>;
     /**
-     * Generate complete text combining FrontMatter and body
+     * Output in JSON format
      */
-    toText(): string;
+    toJson(): DocFileIndexMeta<T>;
     /**
-     * Generate empty content
+     * Output in YAML format
      */
-    static empty<T extends DocCustomSchema = DocCustomSchema>(title: string, customSchema: T): DocFileMdContentValue<T>;
+    toYaml(): string;
     /**
-     * Output in JSON format
+     * Generate from Markdown text (can process incomplete data)
      */
-    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);
+    static from<T extends DocCustomSchema>(markdownText: string, customSchema: T, config: DocClientConfig): DocFileIndexMetaValue<T>;
     /**
-     * Content
+     * Generate directly from data (can process incomplete data)
      */
-    get content(): DocFileMdContentValue<T>;
+    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: DocFileMdContentValue<T>): DocFileMdEntity<T>;
+    private static extractIcon;
     /**
-     * Update path
+     * Extract schema part
      */
-    withPath(path: DocFilePath): DocFileMdEntity<T>;
-    withMeta(meta: DocFileMdMetaValue<T>): DocFileMdEntity<T>;
-    withTitle(title: string): DocFileMdEntity<T>;
-    withDescription(description: string, defaultTitle?: string): DocFileMdEntity<T>;
+    private static extractSchema;
     /**
-     * Convert to JSON format
+     * Normalize entire schema
      */
-    toJson(): DocFileMd<T>;
+    private static normalizeSchema;
+    static emptySchema<T extends DocCustomSchema>(customSchema: T): DocFileIndexSchema<keyof T>;
 }
 
-type Props$6<T extends DocCustomSchema> = {
-    path: string;
-    fileSystem: DocFileSystem;
-    pathSystem: DocPathSystem;
-    customSchema: T;
-    config: DocClientConfig;
-};
 /**
- * File reference
+ * File: index.md > content
  */
-declare class DocFileMdReference<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$6<T>);
-    get fileSystem(): DocFileSystem;
-    get basePath(): string;
-    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
-     */
-    readText(): Promise<Error | string>;
-    /**
-     * Write entity
-     */
-    write(entity: DocFileMdEntity<T>): Promise<null>;
-    writeText(text: string): Promise<void>;
-    /**
-     * Create new file with default content
-     */
-    writeDefault(): Promise<void>;
+    private readonly config;
+    constructor(value: DocFileIndexContent<T>, customSchema: T, config: DocClientConfig);
     /**
-     * Delete file
+     * Content body (does not include frontMatter)
      */
-    delete(): Promise<Error | null>;
+    get body(): string;
     /**
-     * Copy file
+     * Title
      */
-    copyTo(destinationPath: string): Promise<void>;
+    get title(): string;
     /**
-     * Move file
+     * Description
      */
-    moveTo(destinationPath: string): Promise<void>;
+    get description(): string;
     /**
-     * Move file to archive and return new reference
+     * FrontMatter
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
+    meta(): DocFileIndexMetaValue<T>;
     /**
-     * Restore file from archive and return new reference
+     * Update title
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileMdReference<T>>;
+    withTitle(title: string): DocFileIndexContentValue<T>;
     /**
-     * Get file size in bytes
+     * Update description
      */
-    size(): Promise<number>;
+    withDescription(description: string, defaultTitle?: string): DocFileIndexContentValue<T>;
     /**
-     * Get file last modified time
+     * Generate from Markdown text
      */
-    lastModified(): Promise<Date>;
+    static fromMarkdown<T extends DocCustomSchema>(markdown: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
     /**
-     * Get file creation time
+     * Generate complete Markdown text
      */
-    createdAt(): Promise<Date>;
-    directory(): DocDirectoryReference<T>;
+    toMarkdownText(): string;
     /**
-     * Get relation based on schema
+     * Update content
      */
-    relation<U extends DocCustomSchema = DocCustomSchema>(key: RelationKeys<T>, targetSchema?: U): Promise<DocFileMdReference<U> | Error | null>;
+    withContent(content: string): DocFileIndexContentValue<T>;
     /**
-     * Get index.md in the same directory
+     * Update FrontMatter
      */
-    directoryIndex(): Promise<DocFileIndexReference<T> | null>;
+    withMeta(meta: DocFileIndexMeta<T>): DocFileIndexContentValue<T>;
     /**
-     * Get multiple relations based on schema
+     * Generate default index.md content
      */
-    relations<U extends DocCustomSchema = DocCustomSchema>(key: MultiRelationKeys<T>, customSchema?: U): Promise<DocFileMdReference<U>[]>;
+    static empty<T extends DocCustomSchema = DocCustomSchema>(directoryName: string, customSchema: T, config: DocClientConfig): DocFileIndexContentValue<T>;
     /**
-     * File: Markdown > FrontMatter
+     * Generate complete text combining FrontMatter and body
      */
-    readFrontMatter(): Promise<DocFileMdMetaValue<T> | Error>;
+    toText(): string;
     /**
-     * File: Markdown > FrontMatter
+     * Output in JSON format
      */
-    updateFrontMatter<K extends keyof T>(key: K, value: BaseFieldValueType<ExtractFieldType<T[K]>>): Promise<this | Error>;
+    toJson(): DocFileIndexContent<T>;
 }
 
 /**
- * Unknown file entity
+ * Document directory entity
  */
-declare class DocFileUnknownEntity {
-    readonly value: DocFileUnknown;
-    constructor(value: DocFileUnknown);
+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(): string;
+    get content(): DocFileIndexContentValue<T>;
     /**
      * Path information
      */
@@ -1354,36 +1385,38 @@ declare class DocFileUnknownEntity {
     /**
      * Update content
      */
-    withContent(content: string): DocFileUnknownEntity;
+    withContent(content: DocFileIndexContentValue<T>): DocFileIndexEntity<T>;
     /**
      * Update path
      */
-    withPath(path: DocFilePath): DocFileUnknownEntity;
-    toJson(): DocFileUnknown;
+    withPath(path: DocFilePath): DocFileIndexEntity<T>;
+    /**
+     * Convert to index file schema format
+     */
+    toJson(): DocFileIndex<T>;
 }
 
-type Props$5 = {
+type Props$5<T extends DocCustomSchema> = {
+    customSchema: T;
     path: string;
     fileSystem: DocFileSystem;
     pathSystem: DocPathSystem;
     config: DocClientConfig;
 };
 /**
- * File reference
+ * File reference class
  */
-declare class DocFileUnknownReference {
+declare class DocFileIndexReference<T extends DocCustomSchema> {
     private readonly props;
     private readonly pathSystem;
-    constructor(props: Props$5);
+    private readonly customSchema;
+    constructor(props: Props$5<T>);
     get fileSystem(): DocFileSystem;
     get basePath(): string;
-    get path(): string;
-    get directoryPath(): string;
+    get filePath(): string;
     get fileFullPath(): string;
     get durectoryPath(): string;
-    directory<T extends DocCustomSchema>(customSchema: T): DocDirectoryReference<T>;
-    directory(): DocDirectoryReference<DocCustomSchema>;
-    read(): Promise<Error | DocFileUnknownEntity>;
+    read(): Promise<DocFileIndexEntity<T>>;
     /**
      * Read file content
      */
@@ -1395,11 +1428,11 @@ declare class DocFileUnknownReference {
     /**
      * Write entity
      */
-    write(entity: DocFileUnknownEntity): Promise<void>;
+    write(entity: DocFileIndexEntity<T>): Promise<void>;
     /**
-     * Write raw content
+     * Create new file with default content
      */
-    writeRaw(content: string): Promise<void>;
+    writeDefault(): Promise<null>;
     /**
      * Delete file
      */
@@ -1408,34 +1441,28 @@ declare class DocFileUnknownReference {
      * Check if file exists
      */
     exists(): Promise<boolean>;
-    /**
-     * Copy file
-     */
-    copyTo(destinationPath: string): Promise<void>;
-    /**
-     * Move file
-     */
-    moveTo(destinationPath: string): Promise<void>;
+    relations(): Promise<DocFileRelationReference[]>;
+    readRelations(): Promise<DocRelationValue[]>;
     /**
      * Get file size in bytes
      */
     size(): Promise<number>;
     /**
-     * Get file last modified time
+     * Get last modified date
      */
     lastModified(): Promise<Date>;
     /**
-     * Get file creation time
+     * Get file creation date
      */
     createdAt(): Promise<Date>;
     /**
      * Move file to archive and return new reference
      */
-    archive(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+    archive(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
     /**
      * Restore file from archive and return new reference
      */
-    restore(archiveDirectoryName?: string): Promise<DocFileUnknownReference>;
+    restore(archiveDirectoryName?: string): Promise<DocFileIndexReference<T>>;
 }
 
 type Props$4<T extends DocCustomSchema> = {
@@ -1469,8 +1496,8 @@ declare class DocDirectoryReference<T extends DocCustomSchema> {
     mdFilesGenerator(): AsyncGenerator<DocFileMdReference<T>, void, unknown>;
     files(): Promise<(DocFileMdReference<T> | DocFileUnknownReference)[]>;
     mdFiles(): Promise<DocFileMdReference<T>[]>;
-    file(fileName: string): Promise<DocFileMdReference<T> | DocFileUnknownReference>;
-    mdFile(fileName: string): Promise<DocFileMdReference<T>>;
+    file<FileName extends string>(fileName: FileName): InferReference<FileName, T>;
+    mdFile(fileName: string): DocFileMdReference<T>;
     readFiles(): Promise<(DocFileMdEntity<T> | DocFileUnknownEntity)[]>;
     readMdFiles(): Promise<DocFileMdEntity<T>[]>;
     readUnknownFiles(): Promise<DocFileUnknownEntity[]>;
@@ -1481,13 +1508,14 @@ declare class DocDirectoryReference<T extends DocCustomSchema> {
     /**
      * Get subdirectory references
      */
-    directories(): Promise<DocDirectoryReference<never>[]>;
+    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>>;
+    readIndexFile(): Promise<DocFileIndexEntity<T> | Error>;
     writeFile(entity: DocFileIndexEntity<T> | DocFileMdEntity<T> | DocFileUnknownEntity): Promise<Error | null>;
     exists(): Promise<boolean>;
     /**
@@ -1672,8 +1700,8 @@ declare class DocClient {
     readonly config: DocClientConfig;
     constructor(props: Props);
     basePath(): string;
-    file(relativePath: string): DocFileMdReference<DocCustomSchema> | DocFileUnknownReference;
-    file<T extends DocCustomSchema>(relativePath: string, customSchema: T): DocFileMdReference<T> | DocFileUnknownReference;
+    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>;
@@ -1763,8 +1791,6 @@ declare class DocFileSystemDebug extends DocFileSystem {
     setupTestFiles(files: Record<string, string>): void;
 }
 
-type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
-
 /**
  * Schema builder
  * Build schemas in a chain style
@@ -1776,56 +1802,58 @@ type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileInde
  *   .selectText("priority", false)
  *   .build()
  */
-declare class SchemaBuilder<T extends DocCustomSchema> {
+declare class DocSchemaBuilder<T extends DocCustomSchema> {
     private schema;
     constructor(schema?: T);
-    text<K extends string>(key: K, required: boolean): SchemaBuilder<T & Record<K, {
+    text<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
         type: "text";
         required: boolean;
     }>>;
-    number<K extends string>(key: K, required: boolean): SchemaBuilder<T & Record<K, {
+    number<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
         type: "number";
         required: boolean;
     }>>;
-    boolean<K extends string>(key: K, required: boolean): SchemaBuilder<T & Record<K, {
+    boolean<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
         type: "boolean";
         required: boolean;
     }>>;
-    relation<K extends string>(key: K, required: boolean): SchemaBuilder<T & Record<K, {
+    relation<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
         type: "relation";
         required: boolean;
     }>>;
-    multiRelation<K extends string>(key: K, required: boolean): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    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): SchemaBuilder<T & Record<K, {
+    multiSelectNumber<K extends string>(key: K, required: boolean): DocSchemaBuilder<T & Record<K, {
         type: "multi-select-number";
         required: boolean;
     }>>;
     build(): T;
 }
 
+type DocFileEntity<T extends DocCustomSchema> = DocFileMdEntity<T> | DocFileIndexEntity<T> | DocFileUnknownEntity;
+
 /**
  * Function that only performs type checking (does nothing at runtime)
  */
@@ -1911,4 +1939,4 @@ declare const docCustomSchemaField: {
     };
 };
 
-export { type BaseFieldValueType, DocClient, type DocClientConfig, type DocCustomSchema, type DocCustomSchemaField, type DocCustomSchemaFieldBoolean, type DocCustomSchemaFieldMultiNumber, type DocCustomSchemaFieldMultiRelation, type DocCustomSchemaFieldMultiSelectNumber, type DocCustomSchemaFieldMultiSelectText, type DocCustomSchemaFieldMultiText, type DocCustomSchemaFieldNumber, type DocCustomSchemaFieldRelation, type DocCustomSchemaFieldSelectNumber, type DocCustomSchemaFieldSelectText, type DocCustomSchemaFieldText, type DocDirectory, DocDirectoryReference, type DocFieldTypeLiteral, type DocFile, type DocFileEntity, type DocFileIndex, type DocFileIndexContent, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, type DocFileMd, type DocFileMdContent, DocFileMdEntity, type DocFileMdMeta, DocFileMdReference, type DocFilePath, DocFileRelationReference, DocFileSystem, DocFileSystemDebug, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, type DocMetaField, type DocMetaFieldBoolean, type DocMetaFieldMultiBoolean, type DocMetaFieldMultiNumber, type DocMetaFieldMultiRelation, type DocMetaFieldMultiSelectNumber, type DocMetaFieldMultiSelectText, type DocMetaFieldMultiText, type DocMetaFieldNumber, type DocMetaFieldRelation, type DocMetaFieldSelectNumber, type DocMetaFieldSelectText, type DocMetaFieldText, type DocMetaFieldType, type DocMetaFieldTypeBoolean, type DocMetaFieldTypeNumber, type DocMetaFieldTypeRelation, type DocMetaFieldTypeSelectNumber, type DocMetaFieldTypeSelectText, type DocMetaFieldTypeText, DocPathSystem, type DocRelation, type DocRelationField, type DocRelationFile, type DocSchemaFieldBoolean, type DocSchemaFieldMultiNumber, type DocSchemaFieldMultiRelation, type DocSchemaFieldMultiSelectNumber, type DocSchemaFieldMultiSelectText, type DocSchemaFieldMultiText, type DocSchemaFieldNumber, type DocSchemaFieldRelation, type DocSchemaFieldSelectNumber, type DocSchemaFieldSelectText, type DocSchemaFieldText, type DocSchemaRelationFieldUnion, type DocTreeDirectoryNode, type DocTreeFileNode, type DocTreeNode, type Equals, type ExtractFieldType, type ExtractIndexFieldType, type ExtractRequired, type FieldValueType, DocFileTreeSystem as FileTreeSystem, type GetIndexFieldType, type GetIndexFieldValueType, type GetValueType, type InferDocFileMd, type MultiRelationKeys, type OptionalKeys, type RecordKey, type RelationKeys, type RequiredKeys, SchemaBuilder, type SchemaToValueType, assertType, defaultTestConfig, defineSchema, docCustomSchemaField, expectType, zDocClientConfig, zDocFileIndexSchemaField, zDocFilePath, zDocFileUnknown, zDocMetaField, zDocMetaFieldBoolean, zDocMetaFieldMultiBoolean, zDocMetaFieldMultiNumber, zDocMetaFieldMultiRelation, zDocMetaFieldMultiSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiText, zDocMetaFieldNumber, zDocMetaFieldRelation, zDocMetaFieldSelectNumber, zDocMetaFieldSelectText, zDocMetaFieldText, zDocMetaFieldType, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeNumber, zDocMetaFieldTypeRelation, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeText, zDocRelation, zDocRelationField, zDocRelationFile, zDocSchemaFieldBoolean, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldRelation, zDocSchemaFieldSelectNumber, zDocSchemaFieldSelectText, zDocSchemaFieldText };
+export { type BaseFieldValueType, 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, type DocDirectory, DocDirectoryReference, type DocFieldTypeLiteral, type DocFile, type DocFileEntity, type DocFileIndex, type DocFileIndexContent, DocFileIndexEntity, type DocFileIndexMeta, DocFileIndexReference, type DocFileIndexSchema, type DocFileIndexSchemaField, type DocFileMd, type DocFileMdContent, DocFileMdEntity, type DocFileMdMeta, DocFileMdReference, type DocFilePath, DocFileRelationReference, DocFileSystem, DocFileSystemDebug, DocFileTreeSystem, type DocFileUnknown, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, type DocMetaField, type DocMetaFieldBoolean, type DocMetaFieldMultiBoolean, type DocMetaFieldMultiNumber, type DocMetaFieldMultiRelation, type DocMetaFieldMultiSelectNumber, type DocMetaFieldMultiSelectText, type DocMetaFieldMultiText, type DocMetaFieldNumber, type DocMetaFieldRelation, type DocMetaFieldSelectNumber, type DocMetaFieldSelectText, type DocMetaFieldText, type DocMetaFieldType, type DocMetaFieldTypeBoolean, type DocMetaFieldTypeNumber, type DocMetaFieldTypeRelation, type DocMetaFieldTypeSelectNumber, type DocMetaFieldTypeSelectText, type DocMetaFieldTypeText, DocPathSystem, type DocRelation, type DocRelationField, type DocRelationFile, 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, type DocTreeFileNode, type DocTreeNode, type Equals, type ExtractFieldType, type ExtractIndexFieldType, type ExtractRequired, type FieldValueType, type GetIndexFieldType, type GetIndexFieldValueType, type GetValueType, type InferDocFileMd, type InferReference, type MultiRelationKeys, type OptionalKeys, type RecordKey, type RelationKeys, type RequiredKeys, type SchemaToValueType, assertType, defaultTestConfig, defineSchema, docCustomSchemaField, expectType, zDocClientConfig, zDocFileIndexSchemaField, zDocFilePath, zDocFileUnknown, zDocMetaField, zDocMetaFieldBoolean, zDocMetaFieldMultiBoolean, zDocMetaFieldMultiNumber, zDocMetaFieldMultiRelation, zDocMetaFieldMultiSelectNumber, zDocMetaFieldMultiSelectText, zDocMetaFieldMultiText, zDocMetaFieldNumber, zDocMetaFieldRelation, zDocMetaFieldSelectNumber, zDocMetaFieldSelectText, zDocMetaFieldText, zDocMetaFieldType, zDocMetaFieldTypeBoolean, zDocMetaFieldTypeNumber, zDocMetaFieldTypeRelation, zDocMetaFieldTypeSelectNumber, zDocMetaFieldTypeSelectText, zDocMetaFieldTypeText, zDocRelation, zDocRelationField, zDocRelationFile, zDocSchemaFieldBoolean, zDocSchemaFieldMultiNumber, zDocSchemaFieldMultiRelation, zDocSchemaFieldMultiSelectNumber, zDocSchemaFieldMultiSelectText, zDocSchemaFieldMultiText, zDocSchemaFieldNumber, zDocSchemaFieldRelation, zDocSchemaFieldSelectNumber, zDocSchemaFieldSelectText, zDocSchemaFieldText };