@interactive-inc/docs-client 1.0.5 → 1.0.8

package/build/index.js

@@ -1233,24 +1233,6 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
     this.validateValue(value, customSchema);
     Object.freeze(this);
   }
-  validateValue(value, schema) {
-    const keys = Object.keys(schema);
-    for (const key of keys) {
-      const schemaField = schema[key];
-      const fieldValue = this.getValueField(value, key);
-      if (schemaField.required && fieldValue === void 0) {
-        throw new Error(`Required field "${key}" is missing`);
-      }
-      if (fieldValue !== void 0) {
-        const factory = new DocMetaFieldFactory();
-        factory.fromType(key, schemaField.type, fieldValue);
-      }
-    }
-  }
-  getValueField(value, key) {
-    const record = value;
-    return record[key];
-  }
   get keys() {
     return Object.keys(this.value);
   }
@@ -1269,24 +1251,6 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
       this.customSchema
     );
   }
-  /**
-   * Return a new instance with an unknown schema
-   * Allows accepting Record<string, unknown> schemas from external sources
-   */
-  withUnknownSchema(draft) {
-    const typedSchema = draft;
-    const newValue = {};
-    for (const key in typedSchema) {
-      if (key in this.value) {
-        const unknownValue = this.value;
-        newValue[key] = unknownValue[key];
-      }
-    }
-    return new _DocFileMdMetaValue(
-      newValue,
-      typedSchema
-    );
-  }
   schemaField(key) {
     const field = this.customSchema[key];
     if (field === void 0) {
@@ -1367,6 +1331,33 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
     }
     return true;
   }
+  toJson() {
+    return this.value;
+  }
+  toYaml() {
+    return stringify(this.value).trim();
+  }
+  validateValue(value, schema) {
+    if (Object.keys(schema).length === 0) {
+      return;
+    }
+    const keys = Object.keys(schema);
+    for (const key of keys) {
+      const schemaField = schema[key];
+      const fieldValue = this.getValueField(value, key);
+      if (schemaField.required && fieldValue === void 0) {
+        throw new Error(`Required field "${key}" is missing`);
+      }
+      if (fieldValue !== void 0) {
+        const factory = new DocMetaFieldFactory();
+        factory.fromType(key, schemaField.type, fieldValue);
+      }
+    }
+  }
+  getValueField(value, key) {
+    const record = value;
+    return record[key];
+  }
   /**
    * Generate from Markdown text
    */
@@ -1381,7 +1372,7 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
     }).parse(yamlRecord);
     const schemaFieldKeys = Object.keys(customSchema);
     const factory = new DocCustomSchemaFieldFactory();
-    const validatedRecord = {};
+    const validatedRecord = { ...record };
     for (const key of schemaFieldKeys) {
       const schemaField = customSchema[key];
       const customSchemaField = factory.fromType(key, schemaField);
@@ -1408,12 +1399,6 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
     }
     return new _DocFileMdMetaValue(record, customSchema);
   }
-  toJson() {
-    return this.value;
-  }
-  toYaml() {
-    return stringify(this.value).trim();
-  }
 };
 
 // lib/values/doc-file-md-content-value.ts
@@ -1714,6 +1699,12 @@ var DocFilePathValue = class _DocFilePathValue {
   get isArchived() {
     return this.path.includes("/.archive/");
   }
+  /**
+   * Export as JSON format
+   */
+  toJson() {
+    return this.value;
+  }
   /**
    * Create instance from relative path (DI support)
    */
@@ -1735,12 +1726,6 @@ var DocFilePathValue = class _DocFilePathValue {
       pathSystem
     );
   }
-  /**
-   * Export as JSON format
-   */
-  toJson() {
-    return this.value;
-  }
 };
 
 // lib/values/doc-relation-file-value.ts
@@ -1770,16 +1755,10 @@ var DocRelationFileValue = class _DocRelationFileValue {
     return this.value.label || this.value.name;
   }
   /**
-   * Create from file path and title
+   * Convert to JSON format
    */
-  static from(filePath, title) {
-    const fileName = _DocRelationFileValue.extractFileName(filePath);
-    return new _DocRelationFileValue({
-      name: fileName,
-      label: title || fileName,
-      value: null,
-      path: null
-    });
+  toJson() {
+    return { ...this.value };
   }
   /**
    * Extract file name from file path (without extension)
@@ -1788,10 +1767,16 @@ var DocRelationFileValue = class _DocRelationFileValue {
     return filePath.split("/").pop()?.replace(".md", "") || filePath;
   }
   /**
-   * Convert to JSON format
+   * Create from file path and title
    */
-  toJson() {
-    return { ...this.value };
+  static from(filePath, title) {
+    const fileName = _DocRelationFileValue.extractFileName(filePath);
+    return new _DocRelationFileValue({
+      name: fileName,
+      label: title || fileName,
+      value: null,
+      path: null
+    });
   }
 };
 
@@ -1809,32 +1794,23 @@ var DocRelationValue = class _DocRelationValue {
   get path() {
     return this.value.path;
   }
-  /**
-   * List of related files (value objects)
-   */
-  get files() {
-    return this.value.files.map((file) => new DocRelationFileValue(file));
-  }
   /**
    * Get file count
    */
   get fileCount() {
-    return this.files.length;
+    return this.files().length;
   }
   /**
    * Whether it's empty
    */
   get isEmpty() {
-    return this.files.length === 0;
+    return this.files().length === 0;
   }
   /**
-   * Create empty relation entity
+   * List of related files (value objects)
    */
-  static empty(path) {
-    return new _DocRelationValue({
-      path,
-      files: []
-    });
+  files() {
+    return this.value.files.map((file) => new DocRelationFileValue(file));
   }
   /**
    * Export as JSON format
@@ -1842,9 +1818,18 @@ var DocRelationValue = class _DocRelationValue {
   toJson() {
     return {
       path: this.path,
-      files: this.files.map((file) => file.toJson())
+      files: this.files().map((file) => file.toJson())
     };
   }
+  /**
+   * Create empty relation entity
+   */
+  static empty(path) {
+    return new _DocRelationValue({
+      path,
+      files: []
+    });
+  }
 };
 
 // lib/doc-file-relation-reference.ts
@@ -1985,6 +1970,10 @@ import { stringify as stringify3 } from "yaml";
 // lib/values/doc-file-index-meta-value.ts
 import { parse as parse2, stringify as stringify2 } from "yaml";
 
+// lib/constants.ts
+var INDEX_META = "index-meta";
+var DOC_NODE_TYPE_DIRECTORY = "directory";
+
 // lib/values/doc-schema-field/doc-schema-field-boolean-value.ts
 var DocSchemaFieldBooleanValue = class _DocSchemaFieldBooleanValue {
   constructor(key, value) {
@@ -2028,11 +2017,11 @@ var DocSchemaFieldBooleanValue = class _DocSchemaFieldBooleanValue {
       default: null
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldBooleanValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null
@@ -2087,11 +2076,11 @@ var DocSchemaFieldMultiNumberValue = class _DocSchemaFieldMultiNumberValue {
       default: null
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldMultiNumberValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null
@@ -2150,11 +2139,11 @@ var DocSchemaFieldMultiRelationValue = class _DocSchemaFieldMultiRelationValue {
       path: ""
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldMultiRelationValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2216,11 +2205,11 @@ var DocSchemaFieldMultiSelectNumberValue = class _DocSchemaFieldMultiSelectNumbe
       options: []
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldMultiSelectNumberValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2282,11 +2271,11 @@ var DocSchemaFieldMultiSelectTextValue = class _DocSchemaFieldMultiSelectTextVal
       options: []
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldMultiSelectTextValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2342,11 +2331,11 @@ var DocSchemaFieldMultiTextValue = class _DocSchemaFieldMultiTextValue {
       default: null
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldMultiTextValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null
@@ -2397,11 +2386,11 @@ var DocSchemaFieldNumberValue = class _DocSchemaFieldNumberValue {
       default: null
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldNumberValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null
@@ -2456,11 +2445,11 @@ var DocSchemaFieldRelationValue = class _DocSchemaFieldRelationValue {
       path: ""
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldRelationValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2519,11 +2508,11 @@ var DocSchemaFieldSelectNumberValue = class _DocSchemaFieldSelectNumberValue {
       options: []
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldSelectNumberValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2584,11 +2573,11 @@ var DocSchemaFieldSelectTextValue = class _DocSchemaFieldSelectTextValue {
       options: []
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldSelectTextValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null,
@@ -2640,11 +2629,11 @@ var DocSchemaFieldTextValue = class _DocSchemaFieldTextValue {
       default: null
     });
   }
-  static normalize(key, record) {
+  static from(key, record) {
     const value = record;
     return new _DocSchemaFieldTextValue(key, {
       type: value.type,
-      required: value.required,
+      required: value.required ?? false,
       title: value.title ?? null,
       description: value.description ?? null,
       default: value.default ?? null
@@ -2690,41 +2679,41 @@ var DocFileIndexSchemaFieldFactory = class {
     }
     throw new Error(`Unknown field type: ${type}`);
   }
-  normalize(key, record) {
+  from(key, record) {
     const value = record;
     const type = value.type;
     if (type === "text") {
-      return DocSchemaFieldTextValue.normalize(key, record);
+      return DocSchemaFieldTextValue.from(key, record);
     }
     if (type === "number") {
-      return DocSchemaFieldNumberValue.normalize(key, record);
+      return DocSchemaFieldNumberValue.from(key, record);
     }
     if (type === "boolean") {
-      return DocSchemaFieldBooleanValue.normalize(key, record);
+      return DocSchemaFieldBooleanValue.from(key, record);
     }
     if (type === "select-text") {
-      return DocSchemaFieldSelectTextValue.normalize(key, record);
+      return DocSchemaFieldSelectTextValue.from(key, record);
     }
     if (type === "select-number") {
-      return DocSchemaFieldSelectNumberValue.normalize(key, record);
+      return DocSchemaFieldSelectNumberValue.from(key, record);
     }
     if (type === "relation") {
-      return DocSchemaFieldRelationValue.normalize(key, record);
+      return DocSchemaFieldRelationValue.from(key, record);
     }
     if (type === "multi-text") {
-      return DocSchemaFieldMultiTextValue.normalize(key, record);
+      return DocSchemaFieldMultiTextValue.from(key, record);
     }
     if (type === "multi-number") {
-      return DocSchemaFieldMultiNumberValue.normalize(key, record);
+      return DocSchemaFieldMultiNumberValue.from(key, record);
     }
     if (type === "multi-select-text") {
-      return DocSchemaFieldMultiSelectTextValue.normalize(key, record);
+      return DocSchemaFieldMultiSelectTextValue.from(key, record);
     }
     if (type === "multi-select-number") {
-      return DocSchemaFieldMultiSelectNumberValue.normalize(key, record);
+      return DocSchemaFieldMultiSelectNumberValue.from(key, record);
     }
     if (type === "multi-relation") {
-      return DocSchemaFieldMultiRelationValue.normalize(key, record);
+      return DocSchemaFieldMultiRelationValue.from(key, record);
     }
     throw new Error(`Unknown field type: ${type}`);
   }
@@ -2755,35 +2744,40 @@ var DocFileIndexSchemaValue = class _DocFileIndexSchemaValue {
     if (!fieldValue) {
       throw new Error(`Field "${key}" not found in schema`);
     }
-    switch (fieldValue.type) {
-      case "text":
-        return new DocSchemaFieldTextValue(key, fieldValue);
-      case "number":
-        return new DocSchemaFieldNumberValue(key, fieldValue);
-      case "boolean":
-        return new DocSchemaFieldBooleanValue(key, fieldValue);
-      case "relation":
-        return new DocSchemaFieldRelationValue(key, fieldValue);
-      case "select-text":
-        return new DocSchemaFieldSelectTextValue(key, fieldValue);
-      case "select-number":
-        return new DocSchemaFieldSelectNumberValue(key, fieldValue);
-      case "multi-text":
-        return new DocSchemaFieldMultiTextValue(key, fieldValue);
-      case "multi-number":
-        return new DocSchemaFieldMultiNumberValue(key, fieldValue);
-      case "multi-relation":
-        return new DocSchemaFieldMultiRelationValue(key, fieldValue);
-      case "multi-select-text":
-        return new DocSchemaFieldMultiSelectTextValue(key, fieldValue);
-      case "multi-select-number":
-        return new DocSchemaFieldMultiSelectNumberValue(
-          key,
-          fieldValue
-        );
-      default:
-        throw new Error("Unknown field type");
+    if (fieldValue.type === "text") {
+      return new DocSchemaFieldTextValue(key, fieldValue);
+    }
+    if (fieldValue.type === "number") {
+      return new DocSchemaFieldNumberValue(key, fieldValue);
     }
+    if (fieldValue.type === "boolean") {
+      return new DocSchemaFieldBooleanValue(key, fieldValue);
+    }
+    if (fieldValue.type === "relation") {
+      return new DocSchemaFieldRelationValue(key, fieldValue);
+    }
+    if (fieldValue.type === "select-text") {
+      return new DocSchemaFieldSelectTextValue(key, fieldValue);
+    }
+    if (fieldValue.type === "select-number") {
+      return new DocSchemaFieldSelectNumberValue(key, fieldValue);
+    }
+    if (fieldValue.type === "multi-text") {
+      return new DocSchemaFieldMultiTextValue(key, fieldValue);
+    }
+    if (fieldValue.type === "multi-number") {
+      return new DocSchemaFieldMultiNumberValue(key, fieldValue);
+    }
+    if (fieldValue.type === "multi-relation") {
+      return new DocSchemaFieldMultiRelationValue(key, fieldValue);
+    }
+    if (fieldValue.type === "multi-select-text") {
+      return new DocSchemaFieldMultiSelectTextValue(key, fieldValue);
+    }
+    if (fieldValue.type === "multi-select-number") {
+      return new DocSchemaFieldMultiSelectNumberValue(key, fieldValue);
+    }
+    throw new Error("Unknown field type");
   }
   relation(key) {
     const fieldValue = this.value[key];
@@ -2805,24 +2799,6 @@ var DocFileIndexSchemaValue = class _DocFileIndexSchemaValue {
     }
     return new DocSchemaFieldMultiRelationValue(key, fieldValue);
   }
-  /**
-   * Get all fields
-   * Note: For type safety, it's recommended to use field() method individually
-   */
-  get fields() {
-    return this.fieldNames.map((name) => {
-      const value = this.value[name];
-      if (value === void 0) {
-        throw new Error(`Field "${name}" does not exist in schema.`);
-      }
-      return this.value[name];
-    });
-  }
-  get relationFields() {
-    return this.fields.filter((t) => {
-      return t instanceof DocSchemaFieldRelationValue || t instanceof DocSchemaFieldMultiRelationValue;
-    });
-  }
   toJson() {
     return this.value;
   }
@@ -2841,14 +2817,10 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
     this.value = value;
     this.customSchema = customSchema;
     this.config = config;
-    zDocFileIndexMeta.parse(value);
     this.additionalProperties = additionalProperties;
+    zDocFileIndexMeta.parse(value);
     Object.freeze(this);
   }
-  /**
-   * Additional properties to include in the meta data
-   */
-  additionalProperties;
   /**
    * Get icon
    */
@@ -2871,9 +2843,8 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
    * Update icon field
    */
   withIcon(value) {
-    const currentData = this.toJson();
     return new _DocFileIndexMetaValue(
-      { ...currentData, icon: value },
+      { ...this.value, icon: value },
       this.customSchema,
       this.config,
       this.additionalProperties
@@ -2884,10 +2855,7 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
    */
   withSchema(value) {
     return new _DocFileIndexMetaValue(
-      {
-        ...this.value,
-        schema: value
-      },
+      { ...this.value, schema: value },
       this.customSchema,
       this.config,
       this.additionalProperties
@@ -2901,7 +2869,7 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
     const typedSchema = draft;
     return new _DocFileIndexMetaValue(
       {
-        type: "index-meta",
+        type: INDEX_META,
         icon: this.value.icon,
         schema: typedSchema
       },
@@ -3013,13 +2981,32 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
    * Normalize entire schema
    */
   static normalizeSchema(schema, customSchema) {
+    const factory = new DocFileIndexSchemaFieldFactory();
+    if (Object.keys(customSchema).length === 0) {
+      const dynamicRecord = {};
+      for (const key of Object.keys(schema)) {
+        const schemaValue = schema[key];
+        if (schemaValue !== void 0 && schemaValue !== null) {
+          const field = factory.from(key, schemaValue);
+          const normalizedValue = {
+            ...field.value,
+            required: field.value.required ?? false
+          };
+          dynamicRecord[key] = normalizedValue;
+        }
+      }
+      return dynamicRecord;
+    }
     const record = {};
     const customSchemaKeys = Object.keys(customSchema);
-    const factory = new DocFileIndexSchemaFieldFactory();
     for (const key of customSchemaKeys) {
       const schemaValue = schema[key];
-      const field = factory.normalize(key, schemaValue);
-      record[key] = field.value;
+      const field = factory.from(key, schemaValue);
+      const normalizedValue = {
+        ...field.value,
+        required: field.value.required ?? false
+      };
+      record[key] = normalizedValue;
     }
     return record;
   }
@@ -3030,7 +3017,11 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
     for (const key of customSchemaKeys) {
       const field = customSchema[key];
       const customSchemaField = factory.empty(key, field.type);
-      record[key] = customSchemaField.value;
+      const normalizedValue = {
+        ...customSchemaField.value,
+        required: customSchemaField.value.required ?? false
+      };
+      record[key] = normalizedValue;
     }
     return record;
   }
@@ -3205,7 +3196,12 @@ ${this.toMarkdownText()}`;
    * Output in JSON format
    */
   toJson() {
-    return this.value;
+    const metaValue = this.meta();
+    const metaJson = metaValue.toJson();
+    return {
+      ...this.value,
+      meta: metaJson
+    };
   }
 };
 
@@ -3340,6 +3336,13 @@ var DocFileIndexReference = class _DocFileIndexReference {
       this.customSchema
     );
   }
+  async readSchemaValue() {
+    const indexFile = await this.read();
+    if (indexFile instanceof Error) {
+      return {};
+    }
+    return indexFile.content.meta().schema().value;
+  }
   /**
    * Read file content
    */
@@ -4408,13 +4411,6 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async exists() {
     return await this.fileSystem.exists(this.relativePath);
   }
-  /**
-   * Generate unique filename
-   */
-  uniqueFileName(prefix = "document") {
-    const [uuid] = crypto.randomUUID().split("-");
-    return `${prefix}-${uuid}.md`;
-  }
   /**
    * Create new Markdown file
    */
@@ -4435,6 +4431,13 @@ var DocDirectoryReference = class _DocDirectoryReference {
     }
     return fileRef;
   }
+  /**
+   * Generate unique filename
+   */
+  uniqueFileName(prefix = "document") {
+    const [uuid] = crypto.randomUUID().split("-");
+    return `${prefix}-${uuid}.md`;
+  }
 };
 
 // lib/values/doc-tree-file-node-value.ts
@@ -4514,7 +4517,7 @@ var DocTreeDirectoryNodeValue = class _DocTreeDirectoryNodeValue {
     return this.props.children;
   }
   get type() {
-    return "directory";
+    return DOC_NODE_TYPE_DIRECTORY;
   }
   /**
    * Convert to plain object
@@ -4523,7 +4526,7 @@ var DocTreeDirectoryNodeValue = class _DocTreeDirectoryNodeValue {
     return {
       name: this.name,
       path: this.path,
-      type: "directory",
+      type: DOC_NODE_TYPE_DIRECTORY,
       icon: this.icon,
       title: this.title,
       children: this.children.map((child) => child.toJson())
@@ -5867,13 +5870,381 @@ var docCustomSchemaField = {
     };
   }
 };
+
+// lib/values/doc-custom-schema-field-value.ts
+var DocCustomSchemaFieldValue = class {
+  constructor(value) {
+    this.value = value;
+    zDocCustomSchemaField.parse(value);
+    Object.freeze(this);
+  }
+  validate(value) {
+    if (this.value.type === "text") {
+      try {
+        return zDocMetaFieldText.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldTextValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "number") {
+      try {
+        return zDocMetaFieldNumber.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldNumberValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "boolean") {
+      try {
+        return zDocMetaFieldBoolean.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldBooleanValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "select-text") {
+      try {
+        return zDocMetaFieldSelectText.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldSelectTextValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "select-number") {
+      try {
+        return zDocMetaFieldSelectNumber.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldSelectNumberValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "relation") {
+      try {
+        return zDocMetaFieldRelation.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldRelationValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "multi-text") {
+      try {
+        return zDocMetaFieldMultiText.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldMultiTextValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "multi-number") {
+      try {
+        return zDocMetaFieldMultiNumber.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldMultiNumberValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "multi-select-text") {
+      try {
+        return zDocMetaFieldMultiSelectText.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldMultiSelectTextValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "multi-select-number") {
+      try {
+        return zDocMetaFieldMultiSelectNumber.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldMultiSelectNumberValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    if (this.value.type === "multi-relation") {
+      try {
+        return zDocMetaFieldMultiRelation.parse(value);
+      } catch {
+        if (this.value.required) {
+          return DocMetaFieldMultiRelationValue.defaultValue();
+        }
+        return null;
+      }
+    }
+    throw new Error("Unknown field type");
+  }
+};
+
+// lib/values/doc-directory-path-value.ts
+var DocDirectoryPathValue = class _DocDirectoryPathValue {
+  constructor(value, pathSystem) {
+    this.value = value;
+    this.pathSystem = pathSystem;
+    Object.freeze(this);
+  }
+  /**
+   * Relative directory path
+   */
+  get path() {
+    return this.value.path;
+  }
+  /**
+   * Directory name
+   */
+  get name() {
+    return this.value.name;
+  }
+  /**
+   * Get parent directory path
+   */
+  get parent() {
+    if (this.path === "." || this.path === "") {
+      return null;
+    }
+    const parentPath = this.pathSystem.dirname(this.path);
+    const parentName = parentPath === "." ? "" : this.pathSystem.basename(parentPath);
+    return new _DocDirectoryPathValue(
+      {
+        path: parentPath,
+        name: parentName,
+        fullPath: this.pathSystem.dirname(this.fullPath)
+      },
+      this.pathSystem
+    );
+  }
+  /**
+   * Parent directory path
+   */
+  get parentPath() {
+    return this.pathSystem.dirname(this.path);
+  }
+  /**
+   * Depth (number of directory levels)
+   */
+  get depth() {
+    if (this.path === "." || this.path === "") {
+      return 0;
+    }
+    return this.path.split(this.pathSystem.separator).filter(Boolean).length;
+  }
+  /**
+   * Path segments (array of directories)
+   */
+  get segments() {
+    return this.path.split(this.pathSystem.separator).filter(Boolean);
+  }
+  /**
+   * Relative path from root (without leading slash)
+   */
+  get normalizedPath() {
+    return this.path.replace(/^\/+/, "");
+  }
+  /**
+   * Whether this is an archive directory (directory name is "_")
+   */
+  get isArchived() {
+    return this.name === "_";
+  }
+  /**
+   * Whether this is a hidden directory
+   */
+  get isHidden() {
+    return this.name.startsWith(".");
+  }
+  /**
+   * Whether this is the root directory
+   */
+  get isRoot() {
+    return this.path === "." || this.path === "";
+  }
+  /**
+   * Absolute path
+   */
+  get fullPath() {
+    return this.value.fullPath;
+  }
+  /**
+   * Get index file path
+   */
+  get indexFile() {
+    return DocFilePathValue.fromPathWithSystem(
+      this.pathSystem.join(this.path, "index.md"),
+      this.pathSystem,
+      this.pathSystem.dirname(this.fullPath)
+    );
+  }
+  /**
+   * Create file path
+   */
+  file(fileName) {
+    return DocFilePathValue.fromPathWithSystem(
+      this.pathSystem.join(this.path, fileName),
+      this.pathSystem,
+      this.pathSystem.dirname(this.fullPath)
+    );
+  }
+  /**
+   * Create subdirectory path
+   */
+  subdirectory(dirName) {
+    const subPath = this.pathSystem.join(this.path, dirName);
+    return new _DocDirectoryPathValue(
+      {
+        path: subPath,
+        name: dirName,
+        fullPath: this.pathSystem.join(this.fullPath, dirName)
+      },
+      this.pathSystem
+    );
+  }
+  /**
+   * Create instance from relative path (DI support)
+   */
+  static fromPathWithSystem(dirPath, basePath, pathSystem) {
+    const name = dirPath === "." ? "" : pathSystem.basename(dirPath);
+    const fullPath = dirPath === "." ? basePath : pathSystem.join(basePath, dirPath);
+    return new _DocDirectoryPathValue(
+      {
+        path: dirPath,
+        name,
+        fullPath
+      },
+      pathSystem
+    );
+  }
+  /**
+   * Export as JSON format
+   */
+  toJson() {
+    return this.value;
+  }
+  /**
+   * Check if paths are equal
+   */
+  equals(other) {
+    return this.path === other.path;
+  }
+  /**
+   * Check if specified directory is a descendant of this directory
+   */
+  contains(other) {
+    const relative = this.pathSystem.relative(this.path, other.path);
+    return !relative.startsWith("..") && relative !== "";
+  }
+};
+
+// lib/values/doc-relation-field-value.ts
+var DocRelationFieldValue = class _DocRelationFieldValue {
+  constructor(value) {
+    this.value = value;
+    zDocRelationField.parse(value);
+    Object.freeze(this);
+  }
+  /**
+   * Get field name
+   */
+  get fieldName() {
+    return this.value.fieldName;
+  }
+  /**
+   * Get relation target path
+   */
+  get relationPath() {
+    return this.value.filePath;
+  }
+  /**
+   * Get whether it's an array type
+   */
+  get isArray() {
+    return this.value.isArray;
+  }
+  /**
+   * Check if it's a single relation
+   */
+  get isSingle() {
+    return !this.value.isArray;
+  }
+  /**
+   * Check if it's a multiple relation
+   */
+  get isMultiple() {
+    return this.value.isArray;
+  }
+  /**
+   * Get target directory name
+   */
+  get targetDirectoryName() {
+    const parts = this.value.filePath.split("/");
+    return parts[parts.length - 1] || "";
+  }
+  /**
+   * Generate full relation path
+   */
+  fullPath(basePath) {
+    if (this.value.filePath.startsWith("/")) {
+      return this.value.filePath;
+    }
+    return `${basePath}/${this.value.filePath}`;
+  }
+  /**
+   * Check equality
+   */
+  equals(other) {
+    return this.fieldName === other.fieldName && this.relationPath === other.relationPath && this.isArray === other.isArray;
+  }
+  /**
+   * Convert to JSON format
+   */
+  toJson() {
+    return { ...this.value };
+  }
+  /**
+   * Create from data
+   */
+  static from(data) {
+    const validated = zDocRelationField.parse(data);
+    return new _DocRelationFieldValue(validated);
+  }
+  /**
+   * Create from properties
+   */
+  static fromProps(props) {
+    return new _DocRelationFieldValue(props);
+  }
+};
 export {
   DocClient,
+  DocCustomSchemaFieldValue,
+  DocDirectoryPathValue,
   DocDirectoryReference,
+  DocFileIndexContentValue,
   DocFileIndexEntity,
+  DocFileIndexMetaValue,
   DocFileIndexReference,
+  DocFileIndexSchemaValue,
+  DocFileMdContentValue,
   DocFileMdEntity,
+  DocFileMdMetaValue,
   DocFileMdReference,
+  DocFilePathValue,
   DocFileRelationReference,
   DocFileSystem,
   DocFileSystemMock,
@@ -5883,7 +6254,12 @@ export {
   DocMarkdownSystem,
   DocPathSystem,
   DocPathSystemMock,
+  DocRelationFieldValue,
+  DocRelationFileValue,
+  DocRelationValue,
   DocSchemaBuilder,
+  DocTreeDirectoryNodeValue,
+  DocTreeFileNodeValue,
   assertType,
   defaultTestConfig,
   defineSchema,