@interactive-inc/docs-client 1.1.2 → 2.0.0

package/build/index.js

@@ -1,7 +1,45 @@
 import { z } from 'zod';
 import { stringify, parse } from 'yaml';
 
-// lib/models.ts
+// lib/create-safe-proxy.ts
+function isAsyncIterator(value) {
+  return value !== null && typeof value === "object" && Symbol.asyncIterator in value;
+}
+function createSafeProxy(target) {
+  return new Proxy(target, {
+    get(obj, prop, receiver) {
+      if (prop === "safe") return receiver;
+      const value = Reflect.get(obj, prop, receiver);
+      if (typeof value !== "function") return value;
+      return (...args) => {
+        const callResult = value.apply(obj, args);
+        if (callResult instanceof Promise) {
+          return callResult.catch((error) => {
+            return error instanceof Error ? error : new Error(String(error));
+          });
+        }
+        if (isAsyncIterator(callResult)) {
+          return safeAsyncIterator(callResult);
+        }
+        return callResult;
+      };
+    }
+  });
+}
+async function* safeAsyncIterator(iterable) {
+  const iterator = iterable[Symbol.asyncIterator]();
+  while (true) {
+    let next;
+    try {
+      next = await iterator.next();
+    } catch (error) {
+      yield error instanceof Error ? error : new Error(String(error));
+      return;
+    }
+    if (next.done) return;
+    yield next.value;
+  }
+}
 var zDocFilePath = z.object({
   name: z.string(),
   path: z.string(),
@@ -18,9 +56,7 @@ var zDocMetaFieldTypeMultiText = z.literal("multi-text");
 var zDocMetaFieldTypeMultiNumber = z.literal("multi-number");
 var zDocMetaFieldTypeMultiRelation = z.literal("multi-relation");
 var zDocMetaFieldTypeMultiSelectText = z.literal("multi-select-text");
-var zDocMetaFieldTypeMultiSelectNumber = z.literal(
-  "multi-select-number"
-);
+var zDocMetaFieldTypeMultiSelectNumber = z.literal("multi-select-number");
 z.union([
   zDocMetaFieldTypeText,
   zDocMetaFieldTypeNumber,
@@ -74,7 +110,8 @@ var zDocSchemaFieldRelation = z.object({
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
-  path: z.string().min(1),
+  // 空文字は path 未設定のプレースホルダとして許容する（empty() が生成する）
+  path: z.string(),
   default: z.string().nullable()
 });
 var zDocSchemaFieldMultiRelation = z.object({
@@ -82,7 +119,8 @@ var zDocSchemaFieldMultiRelation = z.object({
   required: z.boolean(),
   title: z.string().nullable(),
   description: z.string().nullable(),
-  path: z.string().min(1),
+  // 空文字は path 未設定のプレースホルダとして許容する（empty() が生成する）
+  path: z.string(),
   default: z.array(z.string()).nullable()
 });
 var zDocSchemaFieldSelectText = z.object({
@@ -155,14 +193,8 @@ var zDocMetaField = z.union([
   zDocMetaFieldMultiRelation
 ]);
 var zDocFileMdMeta = z.record(z.string(), zDocMetaField);
-var zDocFileMdMetaInput = z.record(
-  z.string(),
-  zDocMetaField.or(z.undefined())
-);
-var zDocFileIndexSchema = z.record(
-  z.string(),
-  zDocFileIndexSchemaField
-);
+var zDocFileMdMetaInput = z.record(z.string(), zDocMetaField.or(z.undefined()));
+var zDocFileIndexSchema = z.record(z.string(), zDocFileIndexSchemaField);
 var zDocFileIndexSchemaInput = z.record(
   z.string(),
   zDocFileIndexSchemaField.or(z.undefined())
@@ -322,7 +354,12 @@ var zDocClientConfig = z.object({
   archiveDirectoryName: z.string(),
   defaultDirectoryName: z.string(),
   indexMetaIncludes: z.array(z.string()),
-  directoryExcludes: z.array(z.string())
+  directoryExcludes: z.array(z.string()),
+  metaFileName: z.string().optional()
+});
+var zDocDirectoryMeta = z.object({
+  icon: z.string().nullable().optional(),
+  schema: zDocFileIndexSchema.optional()
 });
 
 // lib/modules/markdown-system/doc-markdown-system.ts
@@ -354,7 +391,7 @@ ${separator}`, separator.length);
     if (endIndex === -1) {
       return null;
     }
-    return text.slice(0, endIndex + separator.length + 1).replaceAll(separator, "").trim();
+    return text.slice(separator.length + 1, endIndex).trim();
   }
   /**
    * Extract body without FrontMatter (includes title and description)
@@ -471,6 +508,7 @@ ${text}`.trim();
 // lib/constants.ts
 var INDEX_META = "index-meta";
 var DOC_NODE_TYPE_DIRECTORY = "directory";
+var META_FILE_NAME = ".meta.json";
 
 // lib/values/doc-schema-field/doc-schema-field-boolean-value.ts
 var DocSchemaFieldBooleanValue = class _DocSchemaFieldBooleanValue {
@@ -1302,7 +1340,6 @@ var DocFileIndexSchemaValue = class _DocFileIndexSchemaValue {
   }
   /**
    * Create empty schema entity
-   * biome-ignore lint/complexity/noBannedTypes: {} as DocCustomSchema
    */
   static empty() {
     return new _DocFileIndexSchemaValue({}, {});
@@ -1364,12 +1401,15 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
    * Allows accepting Record<string, unknown> schemas from external sources
    */
   withUnknownSchema(draft) {
-    const typedSchema = draft;
+    const parseResult = zDocFileIndexSchema.safeParse(draft);
+    if (parseResult.success === false) {
+      throw new Error(`Invalid schema format: ${parseResult.error.message}`);
+    }
     return new _DocFileIndexMetaValue(
       {
         type: INDEX_META,
         icon: this.value.icon,
-        schema: typedSchema
+        schema: parseResult.data
       },
       {},
       this.config,
@@ -1413,10 +1453,7 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
    */
   static fromRecord(record, customSchema, config) {
     const icon = _DocFileIndexMetaValue.extractIcon(record, config);
-    const indexSchema = _DocFileIndexMetaValue.extractSchema(
-      record,
-      customSchema
-    );
+    const indexSchema = _DocFileIndexMetaValue.extractSchema(record, customSchema);
     const additionalProperties = {};
     for (const key of config.indexMetaIncludes) {
       if (key in record && key !== "icon" && key !== "schema") {
@@ -1428,12 +1465,7 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
       icon,
       schema: indexSchema
     };
-    return new _DocFileIndexMetaValue(
-      indexMeta,
-      customSchema,
-      config,
-      additionalProperties
-    );
+    return new _DocFileIndexMetaValue(indexMeta, customSchema, config, additionalProperties);
   }
   /**
    * Generate empty FrontMatter
@@ -1465,19 +1497,17 @@ var DocFileIndexMetaValue = class _DocFileIndexMetaValue {
     }
     return record;
   }
-  // biome-ignore lint/correctness/noUnusedPrivateClassMembers: Used in fromRecord static method
   static extractIcon(record, config) {
     if (typeof record.icon === "string") {
       return record.icon;
     }
     return config.defaultIndexIcon;
   }
-  // biome-ignore lint/correctness/noUnusedPrivateClassMembers: Used in fromRecord static method
   static extractSchema(record, customSchema) {
     if (typeof record.schema === "object" && record.schema !== null && !Array.isArray(record.schema)) {
       const rawSchema = record.schema;
       const normalizedSchema = {};
-      for (const key in rawSchema) {
+      for (const key of Object.keys(rawSchema)) {
         const field = rawSchema[key];
         normalizedSchema[key] = {
           ...field,
@@ -1524,11 +1554,7 @@ var DocFileIndexContentValue = class _DocFileIndexContentValue {
    * FrontMatter
    */
   meta() {
-    return new DocFileIndexMetaValue(
-      this.value.meta,
-      this.customSchema,
-      this.config
-    );
+    return new DocFileIndexMetaValue(this.value.meta, this.customSchema, this.config);
   }
   /**
    * Update title
@@ -1547,11 +1573,7 @@ var DocFileIndexContentValue = class _DocFileIndexContentValue {
    */
   withDescription(description, defaultTitle) {
     const engine = new DocMarkdownSystem();
-    const updatedBody = engine.updateDescription(
-      this.body,
-      description,
-      defaultTitle || this.title
-    );
+    const updatedBody = engine.updateDescription(this.body, description, defaultTitle || this.title);
     return new _DocFileIndexContentValue(
       {
         ...this.value,
@@ -1567,18 +1589,37 @@ var DocFileIndexContentValue = class _DocFileIndexContentValue {
    */
   static fromMarkdown(markdown, customSchema, config) {
     const engine = new DocMarkdownSystem();
-    const frontMatter = DocFileIndexMetaValue.from(
-      markdown,
+    const frontMatter = DocFileIndexMetaValue.from(markdown, customSchema, config);
+    return new _DocFileIndexContentValue(
+      {
+        type: "markdown-index",
+        body: engine.extractBody(markdown),
+        title: engine.extractTitle(markdown) || "",
+        description: engine.extractDescription(markdown) || "",
+        meta: frontMatter.toJson()
+      },
       customSchema,
       config
     );
+  }
+  /**
+   * Generate from Markdown text with .meta.json
+   * FrontMatter is ignored, only body/title/description are extracted
+   */
+  static fromMarkdownWithDirectoryMeta(markdown, customSchema, config, directoryMeta) {
+    const engine = new DocMarkdownSystem();
+    const meta = {
+      type: "index-meta",
+      icon: directoryMeta.icon ?? config.defaultIndexIcon,
+      schema: directoryMeta.schema ?? {}
+    };
     return new _DocFileIndexContentValue(
       {
         type: "markdown-index",
         body: engine.extractBody(markdown),
         title: engine.extractTitle(markdown) || "",
         description: engine.extractDescription(markdown) || "",
-        meta: frontMatter.toJson()
+        meta
       },
       customSchema,
       config
@@ -1636,8 +1677,26 @@ schema: {}
 
 # ${directoryName}
 `;
-    return _DocFileIndexContentValue.fromMarkdown(
-      content,
+    return _DocFileIndexContentValue.fromMarkdown(content, customSchema, config);
+  }
+  /**
+   * Generate default index.md content with .meta.json
+   */
+  static emptyWithDirectoryMeta(directoryName, customSchema, config, directoryMeta) {
+    const meta = {
+      type: "index-meta",
+      icon: directoryMeta.icon ?? config.defaultIndexIcon,
+      schema: directoryMeta.schema ?? {}
+    };
+    return new _DocFileIndexContentValue(
+      {
+        type: "markdown-index",
+        body: `# ${directoryName}
+`,
+        title: directoryName,
+        description: "",
+        meta
+      },
       customSchema,
       config
     );
@@ -1692,11 +1751,7 @@ var DocFileIndexEntity = class _DocFileIndexEntity {
    * Content
    */
   get content() {
-    return new DocFileIndexContentValue(
-      this.value.content,
-      this.customSchema,
-      this.config
-    );
+    return new DocFileIndexContentValue(this.value.content, this.customSchema, this.config);
   }
   /**
    * Path information
@@ -1748,6 +1803,7 @@ var DocFilePathValue = class _DocFilePathValue {
     this.value = value;
     zDocFilePath.parse(value);
     this.pathSystem = pathSystem;
+    Object.freeze(this.value);
     Object.freeze(this);
   }
   pathSystem;
@@ -1791,13 +1847,13 @@ var DocFilePathValue = class _DocFilePathValue {
    * Whether the file is archived
    */
   get isArchived() {
-    return this.path.includes("/.archive/");
+    return this.path.includes("/_/") || this.path.startsWith("_/");
   }
   /**
    * Export as JSON format
    */
   toJson() {
-    return this.value;
+    return { ...this.value };
   }
   /**
    * Create instance from relative path (DI support)
@@ -1841,9 +1897,7 @@ var DocCustomSchemaFieldBooleanValue = class _DocCustomSchemaFieldBooleanValue {
       return zDocMetaFieldBoolean.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldBooleanValue.defaultValue();
     }
@@ -1875,9 +1929,7 @@ var DocCustomSchemaFieldMultiNumberValue = class _DocCustomSchemaFieldMultiNumbe
       return zDocMetaFieldMultiNumber.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldMultiNumberValue.defaultValue();
     }
@@ -1909,9 +1961,7 @@ var DocCustomSchemaFieldMultiRelationValue = class _DocCustomSchemaFieldMultiRel
       return zDocMetaFieldMultiRelation.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldMultiRelationValue.defaultValue();
     }
@@ -1943,9 +1993,7 @@ var DocCustomSchemaFieldMultiSelectNumberValue = class _DocCustomSchemaFieldMult
       return zDocMetaFieldMultiSelectNumber.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldMultiSelectNumberValue.defaultValue();
     }
@@ -1977,9 +2025,7 @@ var DocCustomSchemaFieldMultiSelectTextValue = class _DocCustomSchemaFieldMultiS
       return zDocMetaFieldMultiSelectText.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldMultiSelectTextValue.defaultValue();
     }
@@ -2011,9 +2057,7 @@ var DocCustomSchemaFieldMultiTextValue = class _DocCustomSchemaFieldMultiTextVal
       return zDocMetaFieldMultiText.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldMultiTextValue.defaultValue();
     }
@@ -2045,9 +2089,7 @@ var DocCustomSchemaFieldNumberValue = class _DocCustomSchemaFieldNumberValue {
       return zDocMetaFieldNumber.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldNumberValue.defaultValue();
     }
@@ -2079,9 +2121,7 @@ var DocCustomSchemaFieldRelationValue = class _DocCustomSchemaFieldRelationValue
       return zDocMetaFieldRelation.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldRelationValue.defaultValue();
     }
@@ -2113,9 +2153,7 @@ var DocCustomSchemaFieldSelectNumberValue = class _DocCustomSchemaFieldSelectNum
       return zDocMetaFieldSelectNumber.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldSelectNumberValue.defaultValue();
     }
@@ -2147,9 +2185,7 @@ var DocCustomSchemaFieldSelectTextValue = class _DocCustomSchemaFieldSelectTextV
       return zDocMetaFieldSelectText.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldSelectTextValue.defaultValue();
     }
@@ -2181,9 +2217,7 @@ var DocCustomSchemaFieldTextValue = class _DocCustomSchemaFieldTextValue {
       return zDocMetaFieldText.parse(value);
     } catch {
       if (this.value.required) {
-        throw new Error(
-          `required field "${this.key.toString()}" is missing or invalid`
-        );
+        throw new Error(`required field "${this.key.toString()}" is missing or invalid`);
       }
       return _DocCustomSchemaFieldTextValue.defaultValue();
     }
@@ -2246,10 +2280,7 @@ var DocMetaFieldBooleanValue = class _DocMetaFieldBooleanValue {
   }
   type = "boolean";
   static from(key, value) {
-    return new _DocMetaFieldBooleanValue(
-      key,
-      zDocMetaFieldBoolean.parse(value)
-    );
+    return new _DocMetaFieldBooleanValue(key, zDocMetaFieldBoolean.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldBooleanValue(key, false);
@@ -2269,10 +2300,7 @@ var DocMetaFieldMultiNumberValue = class _DocMetaFieldMultiNumberValue {
   }
   type = "multi-number";
   static from(key, value) {
-    return new _DocMetaFieldMultiNumberValue(
-      key,
-      zDocMetaFieldMultiNumber.parse(value)
-    );
+    return new _DocMetaFieldMultiNumberValue(key, zDocMetaFieldMultiNumber.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldMultiNumberValue(key, []);
@@ -2292,10 +2320,7 @@ var DocMetaFieldMultiRelationValue = class _DocMetaFieldMultiRelationValue {
   }
   type = "multi-relation";
   static from(key, value) {
-    return new _DocMetaFieldMultiRelationValue(
-      key,
-      zDocMetaFieldMultiRelation.parse(value)
-    );
+    return new _DocMetaFieldMultiRelationValue(key, zDocMetaFieldMultiRelation.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldMultiRelationValue(key, []);
@@ -2338,10 +2363,7 @@ var DocMetaFieldMultiSelectTextValue = class _DocMetaFieldMultiSelectTextValue {
   }
   type = "multi-select-text";
   static from(key, value) {
-    return new _DocMetaFieldMultiSelectTextValue(
-      key,
-      zDocMetaFieldMultiSelectText.parse(value)
-    );
+    return new _DocMetaFieldMultiSelectTextValue(key, zDocMetaFieldMultiSelectText.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldMultiSelectTextValue(key, []);
@@ -2361,10 +2383,7 @@ var DocMetaFieldMultiTextValue = class _DocMetaFieldMultiTextValue {
   }
   type = "multi-text";
   static from(key, value) {
-    return new _DocMetaFieldMultiTextValue(
-      key,
-      zDocMetaFieldMultiText.parse(value)
-    );
+    return new _DocMetaFieldMultiTextValue(key, zDocMetaFieldMultiText.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldMultiTextValue(key, []);
@@ -2404,10 +2423,7 @@ var DocMetaFieldRelationValue = class _DocMetaFieldRelationValue {
   }
   type = "relation";
   static from(key, value) {
-    return new _DocMetaFieldRelationValue(
-      key,
-      zDocMetaFieldRelation.parse(value)
-    );
+    return new _DocMetaFieldRelationValue(key, zDocMetaFieldRelation.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldRelationValue(key, null);
@@ -2427,10 +2443,7 @@ var DocMetaFieldSelectNumberValue = class _DocMetaFieldSelectNumberValue {
   }
   type = "select-number";
   static from(key, value) {
-    return new _DocMetaFieldSelectNumberValue(
-      key,
-      zDocMetaFieldSelectNumber.parse(value)
-    );
+    return new _DocMetaFieldSelectNumberValue(key, zDocMetaFieldSelectNumber.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldSelectNumberValue(key, null);
@@ -2450,10 +2463,7 @@ var DocMetaFieldSelectTextValue = class _DocMetaFieldSelectTextValue {
   }
   type = "select-text";
   static from(key, value) {
-    return new _DocMetaFieldSelectTextValue(
-      key,
-      zDocMetaFieldSelectText.parse(value)
-    );
+    return new _DocMetaFieldSelectTextValue(key, zDocMetaFieldSelectText.parse(value));
   }
   static default(key) {
     return new _DocMetaFieldSelectTextValue(key, null);
@@ -2564,7 +2574,7 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
   constructor(value, customSchema) {
     this.value = value;
     this.customSchema = customSchema;
-    for (const key in customSchema) {
+    for (const key of Object.keys(customSchema)) {
       const field = customSchema[key];
       if (field.required && !(key in value)) {
         throw new Error(`Required field "${key}" is missing`);
@@ -2696,10 +2706,7 @@ var DocFileMdMetaValue = class _DocFileMdMetaValue {
       const value = customSchemaField.validate(record[key]);
       validatedRecord[key] = value;
     }
-    return new _DocFileMdMetaValue(
-      validatedRecord,
-      customSchema
-    );
+    return new _DocFileMdMetaValue(validatedRecord, customSchema);
   }
   static empty(customSchema) {
     const record = {};
@@ -2775,11 +2782,7 @@ var DocFileMdContentValue = class _DocFileMdContentValue {
   withDescription(description, defaultTitle) {
     const fullText = this.toText();
     const engine = new DocMarkdownSystem();
-    const updatedText = engine.updateDescription(
-      fullText,
-      description,
-      defaultTitle || this.title
-    );
+    const updatedText = engine.updateDescription(fullText, description, defaultTitle || this.title);
     const updatedBody = engine.extractBody(updatedText);
     return new _DocFileMdContentValue(
       {
@@ -2936,15 +2939,9 @@ var DocFileMdEntity = class _DocFileMdEntity {
   withPath(pathOrUpdater) {
     if (typeof pathOrUpdater === "function") {
       const updatedPath = pathOrUpdater(this.path);
-      return new _DocFileMdEntity(
-        { ...this.value, path: updatedPath },
-        this.customSchema
-      );
+      return new _DocFileMdEntity({ ...this.value, path: updatedPath }, this.customSchema);
     }
-    return new _DocFileMdEntity(
-      { ...this.value, path: pathOrUpdater },
-      this.customSchema
-    );
+    return new _DocFileMdEntity({ ...this.value, path: pathOrUpdater }, this.customSchema);
   }
   withMeta(metaOrUpdater) {
     if (typeof metaOrUpdater === "function") {
@@ -3040,7 +3037,6 @@ var DocRelationFileValue = class _DocRelationFileValue {
       path: null
     });
   }
-  // biome-ignore lint/correctness/noUnusedPrivateClassMembers: Used in from static method
   static extractFileName(filePath) {
     if (!filePath) {
       return filePath;
@@ -3115,40 +3111,28 @@ var DocFileRelationReference = class {
     Object.freeze(this);
   }
   pathSystem;
+  get safe() {
+    return createSafeProxy(this);
+  }
   get fileSystem() {
     return this.props.fileSystem;
   }
   get basePath() {
     return this.fileSystem.getBasePath();
   }
-  /**
-   * Relation path
-   */
   get path() {
     return this.props.filePath;
   }
-  /**
-   * Full path
-   */
   get fullPath() {
-    return this.pathSystem.join(
-      this.fileSystem.getBasePath(),
-      this.props.filePath
-    );
+    return this.pathSystem.join(this.fileSystem.getBasePath(), this.props.filePath);
   }
   async read() {
     const files = await this.readFiles();
-    if (files instanceof Error) {
-      return files;
-    }
     return new DocRelationValue({
       path: this.path,
       files: files.map((value) => value.toJson())
     });
   }
-  /**
-   * Read list of relation files
-   */
   async readFiles() {
     const exists = await this.fileSystem.exists(this.path);
     if (!exists) {
@@ -3156,14 +3140,11 @@ var DocFileRelationReference = class {
     }
     const filePaths = await this.fileSystem.readDirectoryFilePaths(this.path);
     if (filePaths instanceof Error) {
-      return filePaths;
+      throw filePaths;
     }
     const files = [];
     for (const filePath of filePaths) {
       const file = await this.readFile(filePath);
-      if (file instanceof Error) {
-        return file;
-      }
       if (file === null) {
         continue;
       }
@@ -3171,9 +3152,6 @@ var DocFileRelationReference = class {
     }
     return files;
   }
-  /**
-   * Read single relation file
-   */
   async readFile(filePath) {
     if (filePath.includes("index.md")) {
       return null;
@@ -3183,17 +3161,13 @@ var DocFileRelationReference = class {
     }
     const content = await this.fileSystem.readFile(filePath);
     if (content instanceof Error) {
-      return content;
+      throw content;
     }
     if (content === null) {
       return null;
     }
     const contentValue = DocFileMdContentValue.fromMarkdown(content, {});
-    const pathValue = DocFilePathValue.fromPathWithSystem(
-      filePath,
-      this.pathSystem,
-      this.basePath
-    );
+    const pathValue = DocFilePathValue.fromPathWithSystem(filePath, this.pathSystem, this.basePath);
     const fileEntity = new DocFileMdEntity(
       {
         type: "markdown",
@@ -3205,42 +3179,21 @@ var DocFileRelationReference = class {
     );
     return DocRelationFileValue.from(filePath, fileEntity.value.content.title);
   }
-  /**
-   * Check if file exists
-   */
   async exists(slug) {
     const filePath = `${this.path}/${slug}.md`;
     return this.fileSystem.exists(filePath);
   }
-  /**
-   * Get list of file names (without extension)
-   */
   async readSlugs() {
     const files = await this.readFiles();
-    if (files instanceof Error) {
-      return files;
-    }
     return files.map((file) => file.id);
   }
-  /**
-   * Get file count
-   */
   async count() {
     const files = await this.readFiles();
-    if (files instanceof Error) {
-      return files;
-    }
     return files.length;
   }
-  /**
-   * Check if empty
-   */
   async isEmpty() {
-    const count = await this.count();
-    if (count instanceof Error) {
-      return count;
-    }
-    return count === 0;
+    const fileCount = await this.count();
+    return fileCount === 0;
   }
 };
 
@@ -3254,6 +3207,9 @@ var DocFileIndexReference = class _DocFileIndexReference {
   }
   pathSystem;
   customSchema;
+  get safe() {
+    return createSafeProxy(this);
+  }
   get fileSystem() {
     return this.props.fileSystem;
   }
@@ -3266,13 +3222,14 @@ var DocFileIndexReference = class _DocFileIndexReference {
   get fileFullPath() {
     return this.pathSystem.join(this.basePath, this.filePath);
   }
-  get durectoryPath() {
+  get directoryPath() {
     return this.pathSystem.dirname(this.filePath);
   }
   async read() {
+    const directoryMeta = await this.readDirectoryMeta();
     const content = await this.fileSystem.readFile(this.filePath);
     if (content instanceof Error) {
-      return content;
+      throw content;
     }
     if (content === null) {
       const dirPath = this.pathSystem.dirname(this.filePath);
@@ -3282,11 +3239,12 @@ var DocFileIndexReference = class _DocFileIndexReference {
         this.pathSystem,
         this.fileSystem.getBasePath()
       );
-      const contentValue2 = DocFileIndexContentValue.empty(
+      const contentValue2 = directoryMeta ? DocFileIndexContentValue.emptyWithDirectoryMeta(
         dirName,
         this.customSchema,
-        this.props.config
-      );
+        this.props.config,
+        directoryMeta
+      ) : DocFileIndexContentValue.empty(dirName, this.customSchema, this.props.config);
       return new DocFileIndexEntity(
         {
           type: "index",
@@ -3302,11 +3260,12 @@ var DocFileIndexReference = class _DocFileIndexReference {
       this.pathSystem,
       this.fileSystem.getBasePath()
     );
-    const contentValue = DocFileIndexContentValue.fromMarkdown(
+    const contentValue = directoryMeta ? DocFileIndexContentValue.fromMarkdownWithDirectoryMeta(
       content,
       this.customSchema,
-      this.props.config
-    );
+      this.props.config,
+      directoryMeta
+    ) : DocFileIndexContentValue.fromMarkdown(content, this.customSchema, this.props.config);
     return new DocFileIndexEntity(
       {
         type: "index",
@@ -3317,21 +3276,38 @@ var DocFileIndexReference = class _DocFileIndexReference {
       this.customSchema
     );
   }
+  async readDirectoryMeta() {
+    const metaFileName = this.props.config.metaFileName ?? ".meta.json";
+    const metaPath = this.pathSystem.join(this.directoryPath, metaFileName);
+    const metaContent = await this.fileSystem.readFile(metaPath);
+    if (metaContent instanceof Error) {
+      return null;
+    }
+    if (metaContent === null || metaContent === "") {
+      return null;
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(metaContent);
+    } catch {
+      return null;
+    }
+    const parseResult = zDocDirectoryMeta.safeParse(parsed);
+    if (parseResult.success === false) {
+      return null;
+    }
+    return parseResult.data;
+  }
   async readSchemaValue() {
-    const indexFile = await this.read();
-    if (indexFile instanceof Error) {
+    try {
+      const indexFile = await this.read();
+      return indexFile.content.meta().schema().value;
+    } catch {
       return {};
     }
-    return indexFile.content.meta().schema().value;
   }
-  /**
-   * Read file content
-   */
   async readContent() {
     const entity = await this.read();
-    if (entity instanceof Error) {
-      return entity;
-    }
     return entity.value.content.body;
   }
   /**
@@ -3360,22 +3336,19 @@ var DocFileIndexReference = class _DocFileIndexReference {
       this.customSchema
     );
   }
-  /**
-   * Write content to file
-   */
   async writeContent(content) {
-    return await this.fileSystem.writeFile(this.filePath, content);
+    const writeResult = await this.fileSystem.writeFile(this.filePath, content);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Write entity
-   */
   async write(entity) {
     const content = entity.content.toText();
-    return await this.fileSystem.writeFile(this.filePath, content);
+    const writeResult = await this.fileSystem.writeFile(this.filePath, content);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Create new file with default content
-   */
   async writeDefault() {
     const dirPath = this.pathSystem.dirname(this.filePath);
     const dirName = this.pathSystem.basename(dirPath) || this.props.config.defaultDirectoryName;
@@ -3384,32 +3357,22 @@ var DocFileIndexReference = class _DocFileIndexReference {
       "",
       `Please describe the overview of ${dirName} here.`
     ].join("\n");
-    const writeResult = await this.fileSystem.writeFile(
-      this.filePath,
-      defaultContent
-    );
+    const writeResult = await this.fileSystem.writeFile(this.filePath, defaultContent);
     if (writeResult instanceof Error) {
-      return writeResult;
+      throw writeResult;
     }
-    return null;
   }
-  /**
-   * Delete file
-   */
   async delete() {
-    return await this.fileSystem.deleteFile(this.filePath);
+    const deleteResult = await this.fileSystem.deleteFile(this.filePath);
+    if (deleteResult instanceof Error) {
+      throw deleteResult;
+    }
   }
-  /**
-   * Check if file exists
-   */
   async exists() {
     return this.fileSystem.exists(this.filePath);
   }
   async relations() {
     const indexFile = await this.read();
-    if (indexFile instanceof Error) {
-      return indexFile;
-    }
     const schema = indexFile.content.meta().schema();
     if (!schema) {
       return [];
@@ -3419,11 +3382,14 @@ var DocFileIndexReference = class _DocFileIndexReference {
     for (const key of fieldKeys) {
       const fieldValue = schema.value[key];
       if (fieldValue === void 0) continue;
-      if (fieldValue.type !== "relation" && fieldValue.type !== "multi-relation") {
-        continue;
+      let path = null;
+      if (fieldValue.type === "relation") {
+        path = schema.relation(key).path;
+      }
+      if (fieldValue.type === "multi-relation") {
+        path = schema.multiRelation(key).path;
       }
-      const field = schema.field(key);
-      const path = field.path;
+      if (path === null) continue;
       const fileRef = new DocFileRelationReference({
         filePath: path,
         fileSystem: this.fileSystem,
@@ -3435,55 +3401,44 @@ var DocFileIndexReference = class _DocFileIndexReference {
   }
   async readRelations() {
     const relations = await this.relations();
-    if (relations instanceof Error) {
-      return relations;
-    }
     const files = [];
     for (const relation of relations) {
-      const entity = await relation.read();
-      if (entity === null) {
-        continue;
-      }
-      if (entity instanceof Error) {
+      try {
+        const entity = await relation.read();
+        if (entity === null) continue;
+        files.push(entity);
+      } catch {
         continue;
       }
-      files.push(entity);
     }
     return files;
   }
-  /**
-   * Get file size in bytes
-   */
   async size() {
-    return this.fileSystem.getFileSize(this.filePath);
+    const fileSize = await this.fileSystem.getFileSize(this.filePath);
+    if (fileSize instanceof Error) {
+      throw fileSize;
+    }
+    return fileSize;
   }
-  /**
-   * Get last modified date
-   */
   async lastModified() {
-    return this.fileSystem.getFileUpdatedTime(this.filePath);
+    const updatedTime = await this.fileSystem.getFileUpdatedTime(this.filePath);
+    if (updatedTime instanceof Error) {
+      throw updatedTime;
+    }
+    return updatedTime;
   }
-  /**
-   * Get file creation date
-   */
   async createdAt() {
-    return this.fileSystem.getFileCreatedTime(this.filePath);
+    const createdTime = await this.fileSystem.getFileCreatedTime(this.filePath);
+    if (createdTime instanceof Error) {
+      throw createdTime;
+    }
+    return createdTime;
   }
-  /**
-   * Move file to archive and return new reference
-   */
   async archive(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.filePath);
     const fileName = this.pathSystem.basename(this.filePath);
-    const archivePath = this.pathSystem.join(
-      dirPath,
-      archiveDirectoryName,
-      fileName
-    );
-    const moveResult = await this.fileSystem.moveFile(
-      this.filePath,
-      archivePath
-    );
+    const archivePath = this.pathSystem.join(dirPath, archiveDirectoryName, fileName);
+    const moveResult = await this.fileSystem.moveFile(this.filePath, archivePath);
     if (moveResult instanceof Error) {
       throw moveResult;
     }
@@ -3495,9 +3450,6 @@ var DocFileIndexReference = class _DocFileIndexReference {
       config: this.props.config
     });
   }
-  /**
-   * Restore file from archive and return new reference
-   */
   async restore(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.filePath);
     const parentDirName = this.pathSystem.basename(dirPath);
@@ -3505,14 +3457,8 @@ var DocFileIndexReference = class _DocFileIndexReference {
       throw new Error(`File is not in archive directory: ${this.filePath}`);
     }
     const fileName = this.pathSystem.basename(this.filePath);
-    const restorePath = this.pathSystem.join(
-      this.pathSystem.dirname(dirPath),
-      fileName
-    );
-    const moveResult = await this.fileSystem.moveFile(
-      this.filePath,
-      restorePath
-    );
+    const restorePath = this.pathSystem.join(this.pathSystem.dirname(dirPath), fileName);
+    const moveResult = await this.fileSystem.moveFile(this.filePath, restorePath);
     if (moveResult instanceof Error) {
       throw moveResult;
     }
@@ -3582,6 +3528,9 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
   }
   pathSystem;
   customSchema;
+  get safe() {
+    return createSafeProxy(this);
+  }
   get fileSystem() {
     return this.props.fileSystem;
   }
@@ -3622,22 +3571,18 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
     });
   }
   async read() {
+    if (this.path.endsWith(".md")) {
+      throw new Error("Use DocFileMdReference to read Markdown files.");
+    }
     const content = await this.fileSystem.readFile(this.path);
     if (content instanceof Error) {
-      return content;
+      throw content;
     }
     if (content === null) {
-      return new Error(`File not found at ${this.path}.`);
+      throw new Error(`File not found at ${this.path}.`);
     }
     const isInArchiveDir = this.path.includes("/_/") || this.path.startsWith("_/");
-    if (this.path.endsWith(".md")) {
-      throw new Error("Use DocFileMdReference to read Markdown files.");
-    }
-    const pathValue = DocFilePathValue.fromPathWithSystem(
-      this.path,
-      this.pathSystem,
-      this.basePath
-    );
+    const pathValue = DocFilePathValue.fromPathWithSystem(this.path, this.pathSystem, this.basePath);
     const extension = this.pathSystem.extname(this.path).substring(1);
     return new DocFileUnknownEntity({
       type: "unknown",
@@ -3647,25 +3592,15 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       isArchived: isInArchiveDir
     });
   }
-  /**
-   * Read file content
-   */
   async readContent() {
     const entity = await this.read();
-    if (entity instanceof Error) {
-      return entity;
-    }
     return entity.value.content;
   }
   /**
    * Create empty DocFileUnknownEntity
    */
   empty() {
-    const pathValue = DocFilePathValue.fromPathWithSystem(
-      this.path,
-      this.pathSystem,
-      this.basePath
-    );
+    const pathValue = DocFilePathValue.fromPathWithSystem(this.path, this.pathSystem, this.basePath);
     const extension = this.pathSystem.extname(this.path).substring(1);
     return new DocFileUnknownEntity({
       type: "unknown",
@@ -3675,81 +3610,71 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       isArchived: false
     });
   }
-  /**
-   * Write content to file
-   */
   async writeContent(content) {
-    return await this.fileSystem.writeFile(this.path, content);
+    const writeResult = await this.fileSystem.writeFile(this.path, content);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Write entity
-   */
   async write(entity) {
-    return await this.fileSystem.writeFile(this.path, entity.value.content);
+    const writeResult = await this.fileSystem.writeFile(this.path, entity.value.content);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Write raw content
-   */
   async writeRaw(content) {
-    return await this.fileSystem.writeFile(this.path, content);
+    const writeResult = await this.fileSystem.writeFile(this.path, content);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Delete file
-   */
   async delete() {
-    return await this.fileSystem.deleteFile(this.path);
+    const deleteResult = await this.fileSystem.deleteFile(this.path);
+    if (deleteResult instanceof Error) {
+      throw deleteResult;
+    }
   }
-  /**
-   * Check if file exists
-   */
   async exists() {
     return this.fileSystem.exists(this.path);
   }
-  /**
-   * Copy file
-   */
   async copyTo(destinationPath) {
-    return await this.fileSystem.copyFile(this.path, destinationPath);
+    const copyResult = await this.fileSystem.copyFile(this.path, destinationPath);
+    if (copyResult instanceof Error) {
+      throw copyResult;
+    }
   }
-  /**
-   * Move file
-   */
   async moveTo(destinationPath) {
-    return await this.fileSystem.moveFile(this.path, destinationPath);
+    const moveResult = await this.fileSystem.moveFile(this.path, destinationPath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
   }
-  /**
-   * Get file size in bytes
-   */
   async size() {
-    return this.fileSystem.getFileSize(this.path);
+    const fileSize = await this.fileSystem.getFileSize(this.path);
+    if (fileSize instanceof Error) {
+      throw fileSize;
+    }
+    return fileSize;
   }
-  /**
-   * Get file last modified time
-   */
   async lastModified() {
-    return this.fileSystem.getFileUpdatedTime(this.path);
+    const updatedTime = await this.fileSystem.getFileUpdatedTime(this.path);
+    if (updatedTime instanceof Error) {
+      throw updatedTime;
+    }
+    return updatedTime;
   }
-  /**
-   * Get file creation time
-   */
   async createdAt() {
-    return this.fileSystem.getFileCreatedTime(this.path);
+    const createdTime = await this.fileSystem.getFileCreatedTime(this.path);
+    if (createdTime instanceof Error) {
+      throw createdTime;
+    }
+    return createdTime;
   }
-  /**
-   * Move file to archive and return new reference
-   */
   async archive(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.path);
     const fileName = this.pathSystem.basename(this.path);
-    const archivePath = this.pathSystem.join(
-      dirPath,
-      archiveDirectoryName,
-      fileName
-    );
-    const moveResult = await this.moveTo(archivePath);
-    if (moveResult instanceof Error) {
-      throw moveResult;
-    }
+    const archivePath = this.pathSystem.join(dirPath, archiveDirectoryName, fileName);
+    await this.moveTo(archivePath);
     return new _DocFileUnknownReference({
       path: archivePath,
       fileSystem: this.fileSystem,
@@ -3758,9 +3683,6 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       customSchema: this.customSchema
     });
   }
-  /**
-   * Restore file from archive and return new reference
-   */
   async restore(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.path);
     const parentDirName = this.pathSystem.basename(dirPath);
@@ -3768,14 +3690,8 @@ var DocFileUnknownReference = class _DocFileUnknownReference {
       throw new Error(`File is not in archive directory: ${this.path}`);
     }
     const fileName = this.pathSystem.basename(this.path);
-    const restorePath = this.pathSystem.join(
-      this.pathSystem.dirname(dirPath),
-      fileName
-    );
-    const moveResult = await this.moveTo(restorePath);
-    if (moveResult instanceof Error) {
-      throw moveResult;
-    }
+    const restorePath = this.pathSystem.join(this.pathSystem.dirname(dirPath), fileName);
+    await this.moveTo(restorePath);
     return new _DocFileUnknownReference({
       path: restorePath,
       fileSystem: this.fileSystem,
@@ -3796,6 +3712,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
   }
   pathSystem;
   customSchema;
+  get safe() {
+    return createSafeProxy(this);
+  }
   get fileSystem() {
     return this.props.fileSystem;
   }
@@ -3827,11 +3746,7 @@ var DocDirectoryReference = class _DocDirectoryReference {
     return this.props.indexFileName;
   }
   get indexFilePath() {
-    return this.pathSystem.join(
-      this.basePath,
-      this.relativePath,
-      this.props.indexFileName
-    );
+    return this.pathSystem.join(this.basePath, this.relativePath, this.props.indexFileName);
   }
   get archiveDirectoryName() {
     return this.props.archiveDirectoryName;
@@ -3840,19 +3755,14 @@ var DocDirectoryReference = class _DocDirectoryReference {
     return this.pathSystem.basename(this.path);
   }
   async fileNames() {
-    const filePaths = await this.fileSystem.readDirectoryFilePaths(
-      this.relativePath
-    );
+    const filePaths = await this.fileSystem.readDirectoryFilePaths(this.relativePath);
     if (filePaths instanceof Error) {
-      return filePaths;
+      throw filePaths;
     }
     return filePaths.map((p) => this.pathSystem.basename(p)).filter((name) => name.includes("."));
   }
   async archivedFileNames() {
-    const archivePath = this.pathSystem.join(
-      this.relativePath,
-      this.archiveDirectoryName
-    );
+    const archivePath = this.pathSystem.join(this.relativePath, this.archiveDirectoryName);
     const filePaths = await this.fileSystem.readDirectoryFilePaths(archivePath);
     if (filePaths instanceof Error) {
       return [];
@@ -3860,10 +3770,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
     return filePaths.map((p) => this.pathSystem.basename(p)).filter((name) => name.includes("."));
   }
   async *filesGenerator() {
-    const fileNames = await this.fileNames();
-    if (fileNames instanceof Error) return;
-    for (const fileName of fileNames) {
-      if (fileName === "index.md") continue;
+    const allFileNames = await this.fileNames();
+    for (const fileName of allFileNames) {
+      if (fileName === this.indexFileName) continue;
       if (fileName.endsWith(".md")) {
         yield new DocFileMdReference({
           path: this.pathSystem.join(this.relativePath, fileName),
@@ -3882,17 +3791,12 @@ var DocDirectoryReference = class _DocDirectoryReference {
         customSchema: this.customSchema
       });
     }
-    const archivedFileNames = await this.archivedFileNames();
-    if (archivedFileNames instanceof Error) return;
-    for (const fileName of archivedFileNames) {
+    const archivedNames = await this.archivedFileNames();
+    for (const fileName of archivedNames) {
       if (fileName === this.indexFileName) continue;
       if (fileName.endsWith(".md")) {
         yield new DocFileMdReference({
-          path: this.pathSystem.join(
-            this.relativePath,
-            this.archiveDirectoryName,
-            fileName
-          ),
+          path: this.pathSystem.join(this.relativePath, this.archiveDirectoryName, fileName),
           fileSystem: this.fileSystem,
           pathSystem: this.pathSystem,
           customSchema: this.customSchema,
@@ -3901,11 +3805,7 @@ var DocDirectoryReference = class _DocDirectoryReference {
         continue;
       }
       yield new DocFileUnknownReference({
-        path: this.pathSystem.join(
-          this.relativePath,
-          this.archiveDirectoryName,
-          fileName
-        ),
+        path: this.pathSystem.join(this.relativePath, this.archiveDirectoryName, fileName),
         fileSystem: this.fileSystem,
         pathSystem: this.pathSystem,
         config: this.props.config,
@@ -3914,29 +3814,22 @@ var DocDirectoryReference = class _DocDirectoryReference {
     }
   }
   async *mdFilesGenerator() {
-    const generator = this.filesGenerator();
-    for await (const file of generator) {
-      if (file instanceof Error) {
-        yield file;
-        return;
-      }
+    for await (const file of this.filesGenerator()) {
       if (file instanceof DocFileMdReference) {
         yield file;
       }
     }
   }
   async files() {
-    const files = [];
+    const allFiles = [];
     for await (const ref of this.filesGenerator()) {
-      if (ref instanceof Error) continue;
-      files.push(ref);
+      allFiles.push(ref);
     }
-    return files;
+    return allFiles;
   }
   async mdFiles() {
     const refs = [];
     for await (const file of this.mdFilesGenerator()) {
-      if (file instanceof Error) continue;
       refs.push(file);
     }
     return refs;
@@ -3972,63 +3865,61 @@ var DocDirectoryReference = class _DocDirectoryReference {
   async readFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
-      const entity = await file.read();
-      if (entity instanceof Error) continue;
-      entities.push(entity);
+      try {
+        const entity = await file.read();
+        entities.push(entity);
+      } catch {
+        continue;
+      }
     }
     return entities;
   }
   async readMdFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
-      const entity = await file.read();
-      if (entity instanceof Error) continue;
-      if (entity instanceof DocFileUnknownEntity) continue;
-      entities.push(entity);
+      try {
+        const entity = await file.read();
+        if (entity instanceof DocFileUnknownEntity) continue;
+        entities.push(entity);
+      } catch {
+        continue;
+      }
     }
     return entities;
   }
   async readUnknownFiles() {
     const entities = [];
     for await (const file of this.filesGenerator()) {
-      const entity = await file.read();
-      if (entity instanceof Error) continue;
-      if (entity instanceof DocFileMdEntity) continue;
-      entities.push(entity);
+      try {
+        const entity = await file.read();
+        if (entity instanceof DocFileMdEntity) continue;
+        entities.push(entity);
+      } catch {
+        continue;
+      }
     }
     return entities;
   }
-  /**
-   * Get list of subdirectory names
-   */
   async directoryNames() {
-    const allFileNames = await this.fileSystem.readDirectoryFileNames(
-      this.relativePath
-    );
+    const allFileNames = await this.fileSystem.readDirectoryFileNames(this.relativePath);
     if (allFileNames instanceof Error) {
       return [];
     }
-    const directoryNames = [];
+    const names = [];
     for (const fileName of allFileNames) {
-      if (fileName.startsWith(this.archiveDirectoryName)) continue;
+      if (fileName === this.archiveDirectoryName) continue;
       if (this.props.config.directoryExcludes.includes(fileName)) continue;
       const filePath = this.pathSystem.join(this.relativePath, fileName);
       const isDirectory = await this.fileSystem.isDirectory(filePath);
       if (isDirectory) {
-        directoryNames.push(fileName);
+        names.push(fileName);
       }
     }
-    return directoryNames;
+    return names;
   }
-  /**
-   * Get subdirectory references
-   */
   async directories() {
-    const directoryNames = await this.directoryNames();
-    if (directoryNames instanceof Error) {
-      return [];
-    }
-    return directoryNames.map((dirName) => {
+    const names = await this.directoryNames();
+    return names.map((dirName) => {
       const dirPath = this.pathSystem.join(this.relativePath, dirName);
       return new _DocDirectoryReference({
         path: dirPath,
@@ -4077,10 +3968,7 @@ var DocDirectoryReference = class _DocDirectoryReference {
     return this.indexFile().read();
   }
   async writeFile(entity) {
-    const filePath = this.pathSystem.join(
-      this.relativePath,
-      entity.value.path.nameWithExtension
-    );
+    const filePath = this.pathSystem.join(this.relativePath, entity.value.path.nameWithExtension);
     let content = null;
     if (entity instanceof DocFileUnknownEntity) {
       content = entity.value.content;
@@ -4092,20 +3980,16 @@ var DocDirectoryReference = class _DocDirectoryReference {
       content = entity.content().toText();
     }
     if (content === null) {
-      return new Error("Entity content is undefined");
+      throw new Error("Entity content is undefined");
     }
     const writeResult = await this.fileSystem.writeFile(filePath, content);
     if (writeResult instanceof Error) {
-      return writeResult;
+      throw writeResult;
     }
-    return null;
   }
   async exists() {
     return await this.fileSystem.exists(this.relativePath);
   }
-  /**
-   * Create new Markdown file
-   */
   async createMdFile(fileName) {
     const actualFileName = fileName || this.uniqueFileName("document");
     const mdFileName = actualFileName.endsWith(".md") ? actualFileName : `${actualFileName}.md`;
@@ -4117,15 +4001,9 @@ var DocDirectoryReference = class _DocDirectoryReference {
       pathSystem: this.pathSystem,
       config: this.props.config
     });
-    const writeResult = await fileRef.writeDefault();
-    if (writeResult instanceof Error) {
-      throw writeResult;
-    }
+    await fileRef.writeDefault();
     return fileRef;
   }
-  /**
-   * Generate unique filename
-   */
   uniqueFileName(prefix = "document") {
     const [uuid] = crypto.randomUUID().split("-");
     return `${prefix}-${uuid}.md`;
@@ -4142,6 +4020,9 @@ var DocFileMdReference = class _DocFileMdReference {
   }
   pathSystem;
   customSchema;
+  get safe() {
+    return createSafeProxy(this);
+  }
   get fileSystem() {
     return this.props.fileSystem;
   }
@@ -4178,21 +4059,18 @@ var DocFileMdReference = class _DocFileMdReference {
   async read() {
     const content = await this.fileSystem.readFile(this.path);
     if (content instanceof Error) {
-      return content;
+      throw content;
     }
     const actualPath = this.path;
     if (content === null) {
       const archivedContent = await this.fileSystem.readFile(this.archivedPath);
       if (archivedContent instanceof Error) {
-        return archivedContent;
+        throw archivedContent;
       }
       if (archivedContent !== null) {
-        const contentValue2 = DocFileMdContentValue.fromMarkdown(
-          archivedContent,
-          this.customSchema
-        );
+        const contentValue2 = DocFileMdContentValue.fromMarkdown(archivedContent, this.customSchema);
         const pathValue2 = DocFilePathValue.fromPathWithSystem(
-          actualPath,
+          this.archivedPath,
           this.pathSystem,
           this.basePath
         );
@@ -4208,12 +4086,9 @@ var DocFileMdReference = class _DocFileMdReference {
       }
     }
     if (content === null) {
-      return new Error(`File not found at ${this.path} or in archive.`);
+      throw new Error(`File not found at ${this.path} or in archive.`);
     }
-    const contentValue = DocFileMdContentValue.fromMarkdown(
-      content,
-      this.customSchema
-    );
+    const contentValue = DocFileMdContentValue.fromMarkdown(content, this.customSchema);
     const pathValue = DocFilePathValue.fromPathWithSystem(
       actualPath,
       this.pathSystem,
@@ -4230,14 +4105,8 @@ var DocFileMdReference = class _DocFileMdReference {
       this.customSchema
     );
   }
-  /**
-   * Read file content
-   */
   async readText() {
     const entity = await this.read();
-    if (entity instanceof Error) {
-      return entity;
-    }
     return entity.value.content.body;
   }
   /**
@@ -4245,11 +4114,7 @@ var DocFileMdReference = class _DocFileMdReference {
    */
   empty() {
     const contentValue = DocFileMdContentValue.empty("", this.customSchema);
-    const pathValue = DocFilePathValue.fromPathWithSystem(
-      this.path,
-      this.pathSystem,
-      this.basePath
-    );
+    const pathValue = DocFilePathValue.fromPathWithSystem(this.path, this.pathSystem, this.basePath);
     return new DocFileMdEntity(
       {
         type: "markdown",
@@ -4260,65 +4125,50 @@ var DocFileMdReference = class _DocFileMdReference {
       this.customSchema
     );
   }
-  /**
-   * Write entity
-   */
   async write(entity) {
     const content = entity.content().toText();
     const writeResult = await this.fileSystem.writeFile(this.path, content);
     if (writeResult instanceof Error) {
-      return writeResult;
+      throw writeResult;
     }
-    return null;
   }
   async writeText(text) {
-    return await this.fileSystem.writeFile(this.path, text);
+    const writeResult = await this.fileSystem.writeFile(this.path, text);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Create new file with default content
-   */
   async writeDefault() {
     const fileName = this.pathSystem.basename(this.path, ".md");
-    const defaultContent = [
-      `# ${fileName}`,
-      "",
-      "Write your content here."
-    ].join("\n");
-    return await this.fileSystem.writeFile(this.path, defaultContent);
+    const defaultContent = [`# ${fileName}`, "", "Write your content here."].join("\n");
+    const writeResult = await this.fileSystem.writeFile(this.path, defaultContent);
+    if (writeResult instanceof Error) {
+      throw writeResult;
+    }
   }
-  /**
-   * Delete file
-   */
   async delete() {
-    return await this.fileSystem.deleteFile(this.path);
+    const deleteResult = await this.fileSystem.deleteFile(this.path);
+    if (deleteResult instanceof Error) {
+      throw deleteResult;
+    }
   }
-  /**
-   * Copy file
-   */
   async copyTo(destinationPath) {
-    return await this.fileSystem.copyFile(this.path, destinationPath);
+    const copyResult = await this.fileSystem.copyFile(this.path, destinationPath);
+    if (copyResult instanceof Error) {
+      throw copyResult;
+    }
   }
-  /**
-   * Move file
-   */
   async moveTo(destinationPath) {
-    return await this.fileSystem.moveFile(this.path, destinationPath);
+    const moveResult = await this.fileSystem.moveFile(this.path, destinationPath);
+    if (moveResult instanceof Error) {
+      throw moveResult;
+    }
   }
-  /**
-   * Move file to archive and return new reference
-   */
   async archive(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.path);
     const fileName = this.pathSystem.basename(this.path);
-    const archivePath = this.pathSystem.join(
-      dirPath,
-      archiveDirectoryName,
-      fileName
-    );
-    const moveResult = await this.moveTo(archivePath);
-    if (moveResult instanceof Error) {
-      throw moveResult;
-    }
+    const archivePath = this.pathSystem.join(dirPath, archiveDirectoryName, fileName);
+    await this.moveTo(archivePath);
     return new _DocFileMdReference({
       path: archivePath,
       fileSystem: this.fileSystem,
@@ -4327,9 +4177,6 @@ var DocFileMdReference = class _DocFileMdReference {
       config: this.props.config
     });
   }
-  /**
-   * Restore file from archive and return new reference
-   */
   async restore(archiveDirectoryName = this.props.config.archiveDirectoryName) {
     const dirPath = this.pathSystem.dirname(this.path);
     const parentDirName = this.pathSystem.basename(dirPath);
@@ -4337,14 +4184,8 @@ var DocFileMdReference = class _DocFileMdReference {
       throw new Error(`File is not in archive directory: ${this.path}`);
     }
     const fileName = this.pathSystem.basename(this.path);
-    const restorePath = this.pathSystem.join(
-      this.pathSystem.dirname(dirPath),
-      fileName
-    );
-    const moveResult = await this.moveTo(restorePath);
-    if (moveResult instanceof Error) {
-      throw moveResult;
-    }
+    const restorePath = this.pathSystem.join(this.pathSystem.dirname(dirPath), fileName);
+    await this.moveTo(restorePath);
     return new _DocFileMdReference({
       path: restorePath,
       fileSystem: this.fileSystem,
@@ -4353,23 +4194,26 @@ var DocFileMdReference = class _DocFileMdReference {
       config: this.props.config
     });
   }
-  /**
-   * Get file size in bytes
-   */
   async size() {
-    return this.fileSystem.getFileSize(this.path);
+    const fileSize = await this.fileSystem.getFileSize(this.path);
+    if (fileSize instanceof Error) {
+      throw fileSize;
+    }
+    return fileSize;
   }
-  /**
-   * Get file last modified time
-   */
   async lastModified() {
-    return this.fileSystem.getFileUpdatedTime(this.path);
+    const updatedTime = await this.fileSystem.getFileUpdatedTime(this.path);
+    if (updatedTime instanceof Error) {
+      throw updatedTime;
+    }
+    return updatedTime;
   }
-  /**
-   * Get file creation time
-   */
   async createdAt() {
-    return this.fileSystem.getFileCreatedTime(this.path);
+    const createdTime = await this.fileSystem.getFileCreatedTime(this.path);
+    if (createdTime instanceof Error) {
+      throw createdTime;
+    }
+    return createdTime;
   }
   directory() {
     const paths = this.directoryPath.split(this.pathSystem.separator);
@@ -4395,15 +4239,9 @@ var DocFileMdReference = class _DocFileMdReference {
       config: this.props.config
     });
   }
-  /**
-   * Get relation based on schema
-   */
   async relation(key, targetSchema) {
     const file = await this.read();
-    if (file instanceof Error) {
-      return file;
-    }
-    const relationValue = file.content().meta().field(key);
+    const relationValue = file.content().meta().relation(key);
     if (relationValue === null) {
       return null;
     }
@@ -4412,40 +4250,37 @@ var DocFileMdReference = class _DocFileMdReference {
       return null;
     }
     const indexFile = await indexRef.read();
-    if (indexFile instanceof Error) {
-      return null;
-    }
     const schemaValue = indexFile.content.meta().schema();
-    const fieldValue = schemaValue.value[key];
+    const fieldValue = schemaValue.value[String(key)];
     if (!fieldValue || fieldValue.type !== "relation") {
       return null;
     }
-    const schemaField = schemaValue.field(
-      key
-    );
-    const relationField = schemaField;
-    let resolvedPath = relationField.path;
-    if (relationField.path.startsWith("..")) {
-      resolvedPath = this.pathSystem.join(
-        this.directoryPath,
-        relationField.path
-      );
-      resolvedPath = this.pathSystem.normalize(resolvedPath);
-    }
+    const relationField = schemaValue.relation(key);
+    const resolvedPath = this.resolveRelationDirectory(relationField.path);
     const fullPath = this.pathSystem.join(resolvedPath, `${relationValue}.md`);
     return new _DocFileMdReference({
       path: fullPath,
       fileSystem: this.fileSystem,
       pathSystem: this.pathSystem,
-      customSchema: targetSchema || {},
+      customSchema: targetSchema ?? {},
       config: this.props.config
     });
   }
   /**
-   * Get index.md in the same directory
+   * スキーマで定義された relation の path を解決する。
+   * ".." 始まりの相対パスはファイルのディレクトリ基準で正規化する
    */
+  resolveRelationDirectory(schemaPath) {
+    if (schemaPath.startsWith("..")) {
+      return this.pathSystem.normalize(this.pathSystem.join(this.directoryPath, schemaPath));
+    }
+    return schemaPath;
+  }
   async directoryIndex() {
-    const indexPath = this.pathSystem.join(this.directoryPath, "index.md");
+    const indexFileName = this.props.config.indexFileName;
+    const archiveDirectoryName = this.props.config.archiveDirectoryName;
+    const metaFileName = this.props.config.metaFileName ?? META_FILE_NAME;
+    const indexPath = this.pathSystem.join(this.directoryPath, indexFileName);
     const exists = await this.fileSystem.exists(indexPath);
     if (exists) {
       return new DocFileIndexReference({
@@ -4456,10 +4291,21 @@ var DocFileMdReference = class _DocFileMdReference {
         config: this.props.config
       });
     }
+    const metaPath = this.pathSystem.join(this.directoryPath, metaFileName);
+    const metaExists = await this.fileSystem.exists(metaPath);
+    if (metaExists) {
+      return new DocFileIndexReference({
+        path: indexPath,
+        fileSystem: this.fileSystem,
+        pathSystem: this.pathSystem,
+        customSchema: this.customSchema,
+        config: this.props.config
+      });
+    }
     const archivedIndexPath = this.pathSystem.join(
       this.directoryPath,
-      "_",
-      "index.md"
+      archiveDirectoryName,
+      indexFileName
     );
     const archivedExists = await this.fileSystem.exists(archivedIndexPath);
     if (archivedExists) {
@@ -4473,20 +4319,9 @@ var DocFileMdReference = class _DocFileMdReference {
     }
     return null;
   }
-  /**
-   * Get multiple relations based on schema
-   */
   async relations(key, customSchema) {
     const file = await this.read();
-    if (file instanceof Error) {
-      return [];
-    }
-    const meta = file.content().meta();
-    const schemaField = meta.schemaField(key);
-    if (schemaField.type !== "multi-relation") {
-      return [];
-    }
-    const fileNames = meta.multiRelation(key);
+    const fileNames = file.content().meta().multiRelation(key);
     if (fileNames === null) {
       return [];
     }
@@ -4495,41 +4330,30 @@ var DocFileMdReference = class _DocFileMdReference {
       return [];
     }
     const indexFile = await indexRef.read();
-    if (indexFile instanceof Error) {
+    const indexSchema = indexFile.content.meta().schema();
+    const fieldValue = indexSchema.value[String(key)];
+    if (!fieldValue || fieldValue.type !== "multi-relation") {
       return [];
     }
-    const indexSchema = indexFile.content.meta().schema();
     const indexSchemaField = indexSchema.multiRelation(key);
+    const resolvedPath = this.resolveRelationDirectory(indexSchemaField.path);
     return fileNames.map((fileName) => {
-      const resolvedPath = indexSchemaField.path;
       const fullPath = this.pathSystem.join(resolvedPath, `${fileName}.md`);
       return new _DocFileMdReference({
         path: fullPath,
         fileSystem: this.fileSystem,
         pathSystem: this.pathSystem,
-        customSchema: customSchema || {},
+        customSchema: customSchema ?? {},
         config: this.props.config
       });
     });
   }
-  /**
-   * File: Markdown > FrontMatter
-   */
   async readFrontMatter() {
     const entity = await this.read();
-    if (entity instanceof Error) {
-      return entity;
-    }
     return entity.content().meta();
   }
-  /**
-   * File: Markdown > FrontMatter
-   */
   async updateFrontMatter(key, value) {
     const entity = await this.read();
-    if (entity instanceof Error) {
-      return entity;
-    }
     const frontMatter = entity.content().meta();
     const draftFrontMatter = frontMatter.withProperty(key, value);
     const draftContent = entity.content().withMeta(draftFrontMatter);
@@ -4678,6 +4502,8 @@ var DocFileTreeSystem = class {
     for (const fileName of fileNames) {
       if (fileName === this.props.archiveDirectoryName) continue;
       if (this.config.directoryExcludes.includes(fileName)) continue;
+      const metaFileName = this.config.metaFileName ?? ".meta.json";
+      if (fileName === metaFileName) continue;
       const filePath = directoryPath ? this.props.pathSystem.join(directoryPath, fileName) : fileName;
       const isDirectory = await this.props.fileSystem.isDirectory(filePath);
       if (!isDirectory) {
@@ -4688,7 +4514,7 @@ var DocFileTreeSystem = class {
         results.push(fileNode);
         continue;
       }
-      const directoryNode = await this.createDirectoryNode(fileName, filePath);
+      const directoryNode = await this.createDirectoryNode(fileName, filePath, false);
       if (directoryNode instanceof Error) {
         return directoryNode;
       }
@@ -4700,58 +4526,70 @@ var DocFileTreeSystem = class {
    * Create file node
    */
   async createFileNode(fileName, filePath) {
-    let title = fileName;
-    let icon = "";
-    if (fileName.endsWith(".md")) {
-      const mdFile = this.createMdFileReference(filePath);
-      if (await mdFile.exists()) {
-        const entity = await mdFile.read();
-        if (!(entity instanceof Error)) {
-          title = entity.value.content.title || fileName;
-        }
-      }
-      icon = "\u{1F4C4}";
-    } else {
-      icon = "\u{1F4C4}";
-    }
+    const title = await this.readFileTitle(fileName, filePath);
     return DocTreeFileNodeValue.from({
       name: fileName,
       path: filePath,
-      icon,
+      icon: "\u{1F4C4}",
       title
     });
   }
+  /**
+   * Read title from a file
+   */
+  async readFileTitle(fileName, filePath) {
+    if (!fileName.endsWith(".md")) {
+      return fileName;
+    }
+    const mdFile = this.createMdFileReference(filePath);
+    if (!await mdFile.exists()) {
+      return fileName;
+    }
+    try {
+      const entity = await mdFile.read();
+      return entity.value.content.title || fileName;
+    } catch {
+      return fileName;
+    }
+  }
   /**
    * Create directory node
    */
-  async createDirectoryNode(fileName, filePath) {
-    let title = fileName;
-    let icon = this.config.defaultIndexIcon;
-    const indexFile = this.createIndexFileReference(filePath);
-    if (await indexFile.exists()) {
-      const entity = await indexFile.read();
-      if (entity instanceof Error) {
-        return entity;
-      }
-      title = entity.value.content.title || fileName;
-      const content = entity.content;
-      const frontMatter = content.meta();
-      if (frontMatter) {
-        icon = frontMatter.icon || this.config.defaultIndexIcon;
-      }
+  async createDirectoryNode(fileName, filePath, directoryOnly) {
+    const indexInfo = await this.readDirectoryIndexInfo(fileName, filePath);
+    if (indexInfo instanceof Error) {
+      return indexInfo;
     }
-    const children = await this.buildFileTree(filePath);
+    const children = directoryOnly ? await this.buildDirectoryTree(filePath) : await this.buildFileTree(filePath);
     if (children instanceof Error) {
       return children;
     }
     return DocTreeDirectoryNodeValue.from({
       name: fileName,
       path: filePath,
-      icon,
-      title,
+      icon: indexInfo.icon,
+      title: indexInfo.title,
       children
     });
   }
+  /**
+   * Read title and icon from directory index file
+   */
+  async readDirectoryIndexInfo(fileName, filePath) {
+    const indexFile = this.createIndexFileReference(filePath);
+    if (!await indexFile.exists()) {
+      return { title: fileName, icon: this.config.defaultIndexIcon };
+    }
+    try {
+      const entity = await indexFile.read();
+      const title = entity.value.content.title || fileName;
+      const frontMatter = entity.content.meta();
+      const icon = frontMatter?.icon || this.config.defaultIndexIcon;
+      return { title, icon };
+    } catch (error) {
+      return error instanceof Error ? error : new Error(String(error));
+    }
+  }
   /**
    * Create index file reference
    */
@@ -4789,13 +4627,12 @@ var DocFileTreeSystem = class {
     for (const fileName of fileNames) {
       if (fileName === this.props.archiveDirectoryName) continue;
       if (this.config.directoryExcludes.includes(fileName)) continue;
+      const metaFileName = this.config.metaFileName ?? ".meta.json";
+      if (fileName === metaFileName) continue;
       const filePath = directoryPath ? this.props.pathSystem.join(directoryPath, fileName) : fileName;
       const isDirectory = await this.props.fileSystem.isDirectory(filePath);
       if (!isDirectory) continue;
-      const directoryNode = await this.createDirectoryNodeForTree(
-        fileName,
-        filePath
-      );
+      const directoryNode = await this.createDirectoryNode(fileName, filePath, true);
       if (directoryNode instanceof Error) {
         return directoryNode;
       }
@@ -4803,42 +4640,16 @@ var DocFileTreeSystem = class {
     }
     return results;
   }
-  /**
-   * Create directory node for directory tree
-   */
-  async createDirectoryNodeForTree(fileName, filePath) {
-    let title = fileName;
-    let icon = this.config.defaultIndexIcon;
-    const indexFile = this.createIndexFileReference(filePath);
-    if (await indexFile.exists()) {
-      const entity = await indexFile.read();
-      if (entity instanceof Error) {
-        return entity;
-      }
-      title = entity.value.content.title || fileName;
-      const content = entity.content;
-      const frontMatter = content.meta();
-      if (frontMatter && typeof frontMatter === "object" && "icon" in frontMatter) {
-        icon = frontMatter.icon || this.config.defaultIndexIcon;
-      }
-    }
-    const children = await this.buildDirectoryTree(filePath);
-    if (children instanceof Error) {
-      return children;
-    }
-    return DocTreeDirectoryNodeValue.from({
-      name: fileName,
-      path: filePath,
-      icon,
-      title,
-      children
-    });
-  }
 };
 
 // lib/modules/path-system/doc-path-system.ts
-var DocPathSystem = class {
+var DocPathSystem = class _DocPathSystem {
   separator = "/";
+  constructor() {
+    if (new.target === _DocPathSystem) {
+      Object.freeze(this);
+    }
+  }
   /**
    * Join paths
    */
@@ -4894,8 +4705,8 @@ var DocPathSystem = class {
    * Calculate relative path
    */
   relative(from, to) {
-    const fromSegments = from.split(this.separator).filter(Boolean);
-    const toSegments = to.split(this.separator).filter(Boolean);
+    const fromSegments = from.split(this.separator).filter((s) => s !== "" && s !== ".");
+    const toSegments = to.split(this.separator).filter((s) => s !== "" && s !== ".");
     let commonLength = 0;
     for (let i = 0; i < Math.min(fromSegments.length, toSegments.length); i++) {
       if (fromSegments[i] === toSegments[i]) {
@@ -4973,9 +4784,10 @@ var DocClient = class {
       archiveDirectoryName: "_",
       defaultDirectoryName: "Directory",
       indexMetaIncludes: [],
-      directoryExcludes: [".vitepress"]
+      directoryExcludes: [".vitepress"],
+      metaFileName: ".meta.json"
     };
-    this.config = props.config ? zDocClientConfig.parse(props.config) : defaultConfig;
+    this.config = zDocClientConfig.parse({ ...defaultConfig, ...props.config });
     const fileTreeSystem = new DocFileTreeSystem({
       fileSystem: this.fileSystem,
       pathSystem: this.pathSystem,
@@ -4984,17 +4796,21 @@ var DocClient = class {
       config: this.config
     });
     this.fileTreeSystem = props.fileTreeSystem ?? fileTreeSystem;
+    Object.freeze(this);
+  }
+  get safe() {
+    return createSafeProxy(this);
   }
   basePath() {
     return this.fileSystem.getBasePath();
   }
-  /**
-   * Get file reference
-   */
   file(relativePath, customSchema) {
     const fileName = this.pathSystem.basename(relativePath);
     if (fileName === this.config.indexFileName) {
       const dirPath = this.pathSystem.dirname(relativePath);
+      if (customSchema === void 0) {
+        return this.indexFile(dirPath === "." ? "" : dirPath);
+      }
       return this.indexFile(dirPath === "." ? "" : dirPath, customSchema);
     }
     if (relativePath.endsWith(".md")) {
@@ -5011,9 +4827,6 @@ var DocClient = class {
       customSchema: {}
     });
   }
-  /**
-   * Markdown file reference
-   */
   mdFile(relativePath, customSchema) {
     const normalizedPath = relativePath.endsWith(".md") ? relativePath : `${relativePath}.md`;
     if (customSchema === void 0) {
@@ -5033,9 +4846,6 @@ var DocClient = class {
       config: this.config
     });
   }
-  /**
-   * Index file reference
-   */
   indexFile(relativePath, customSchema) {
     const indexPath = relativePath === "" ? this.config.indexFileName : `${relativePath}/${this.config.indexFileName}`;
     if (customSchema === void 0) {
@@ -5055,9 +4865,6 @@ var DocClient = class {
       config: this.config
     });
   }
-  /**
-   * Directory reference
-   */
   directory(relativePath, customSchema) {
     if (customSchema === void 0) {
       return new DocDirectoryReference({
@@ -5081,18 +4888,18 @@ var DocClient = class {
     });
   }
   async fileTree(directoryPath = "") {
-    const results = await this.fileTreeSystem.buildFileTree(directoryPath);
-    if (results instanceof Error) {
-      throw results;
+    const treeNodes = await this.fileTreeSystem.buildFileTree(directoryPath);
+    if (treeNodes instanceof Error) {
+      throw treeNodes;
     }
-    return results.map((node) => node.toJson());
+    return treeNodes.map((node) => node.toJson());
   }
   async directoryTree(directoryPath = "") {
-    const results = await this.fileTreeSystem.buildDirectoryTree(directoryPath);
-    if (results instanceof Error) {
-      throw results;
+    const treeNodes = await this.fileTreeSystem.buildDirectoryTree(directoryPath);
+    if (treeNodes instanceof Error) {
+      throw treeNodes;
     }
-    return results.map((node) => node.toJson());
+    return treeNodes.map((node) => node.toJson());
   }
 };
 
@@ -5303,7 +5110,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldText.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldTextValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5313,7 +5120,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldNumber.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldNumberValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5323,7 +5130,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldBoolean.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldBooleanValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5333,7 +5140,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldSelectText.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldSelectTextValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5343,7 +5150,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldSelectNumber.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldSelectNumberValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5353,7 +5160,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldRelation.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldRelationValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5363,7 +5170,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldMultiText.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldMultiTextValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5373,7 +5180,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldMultiNumber.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldMultiNumberValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5383,7 +5190,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldMultiSelectText.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldMultiSelectTextValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5393,7 +5200,7 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldMultiSelectNumber.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldMultiSelectNumberValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
@@ -5403,13 +5210,16 @@ var DocCustomSchemaFieldValue = class {
         return zDocMetaFieldMultiRelation.parse(value);
       } catch {
         if (this.value.required) {
-          return DocMetaFieldMultiRelationValue.defaultValue();
+          throw new Error(`required field "${this.fieldType()}" is missing or invalid`);
         }
         return null;
       }
     }
     throw new Error("Unknown field type");
   }
+  fieldType() {
+    return this.value.type;
+  }
 };
 
 // lib/values/doc-directory-path-value.ts
@@ -5417,6 +5227,7 @@ var DocDirectoryPathValue = class _DocDirectoryPathValue {
   constructor(value, pathSystem) {
     this.value = value;
     this.pathSystem = pathSystem;
+    Object.freeze(this.value);
     Object.freeze(this);
   }
   /**
@@ -5553,7 +5364,7 @@ var DocDirectoryPathValue = class _DocDirectoryPathValue {
    * Export as JSON format
    */
   toJson() {
-    return this.value;
+    return { ...this.value };
   }
   /**
    * Check if paths are equal
@@ -5566,7 +5377,7 @@ var DocDirectoryPathValue = class _DocDirectoryPathValue {
    */
   contains(other) {
     const relative = this.pathSystem.relative(this.path, other.path);
-    return !relative.startsWith("..") && relative !== "";
+    return !relative.startsWith("..") && relative !== "" && relative !== ".";
   }
 };
 
@@ -5650,4 +5461,4 @@ var DocRelationFieldValue = class _DocRelationFieldValue {
   }
 };
 
-export { DocClient, DocCustomSchemaFieldValue, DocDirectoryPathValue, DocDirectoryReference, DocFileIndexContentValue, DocFileIndexEntity, DocFileIndexMetaValue, DocFileIndexReference, DocFileIndexSchemaValue, DocFileMdContentValue, DocFileMdEntity, DocFileMdMetaValue, DocFileMdReference, DocFilePathValue, DocFileRelationReference, DocFileTreeSystem, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, DocPathSystem, DocPathSystemMock, DocRelationFieldValue, DocRelationFileValue, DocRelationValue, DocTreeDirectoryNodeValue, DocTreeFileNodeValue, assertType, defaultTestConfig, defineSchema, docCustomSchemaField, expectType };
+export { DocClient, DocCustomSchemaFieldValue, DocDirectoryPathValue, DocDirectoryReference, DocFileIndexContentValue, DocFileIndexEntity, DocFileIndexMetaValue, DocFileIndexReference, DocFileIndexSchemaValue, DocFileMdContentValue, DocFileMdEntity, DocFileMdMetaValue, DocFileMdReference, DocFilePathValue, DocFileRelationReference, DocFileTreeSystem, DocFileUnknownEntity, DocFileUnknownReference, DocMarkdownSystem, DocPathSystem, DocPathSystemMock, DocRelationFieldValue, DocRelationFileValue, DocRelationValue, DocTreeDirectoryNodeValue, DocTreeFileNodeValue, assertType, createSafeProxy, defaultTestConfig, defineSchema, docCustomSchemaField, expectType };