@tinacms/schema-tools 0.0.0-c45ac5d-20241213020122 → 0.0.0-c466c52-20250801052040

package/dist/index.js

@@ -20,42 +20,26 @@
   }
   const yup__namespace = /* @__PURE__ */ _interopNamespaceDefault(yup);
   function addNamespaceToSchema(maybeNode, namespace = []) {
-    if (typeof maybeNode === "string") {
+    if (typeof maybeNode !== "object" || maybeNode === null) {
       return maybeNode;
     }
-    if (typeof maybeNode === "boolean") {
-      return maybeNode;
-    }
-    if (typeof maybeNode === "function") {
-      return maybeNode;
-    }
-    const newNode = { ...maybeNode };
-    const keys = Object.keys(maybeNode);
-    Object.values(maybeNode).map((m, index) => {
-      const key = keys[index];
-      if (Array.isArray(m)) {
-        newNode[key] = m.map((element) => {
-          if (!element) {
-            return;
-          }
-          if (!element.hasOwnProperty("name")) {
-            return element;
+    const newNode = { ...maybeNode, namespace: [...namespace] };
+    Object.entries(maybeNode).forEach(([key, value]) => {
+      if (Array.isArray(value)) {
+        newNode[key] = value.map((element) => {
+          if (element && typeof element === "object" && "name" in element) {
+            const valueName = element.name || element.value;
+            return addNamespaceToSchema(element, [...namespace, valueName]);
           }
-          const value = element.name || element.value;
-          return addNamespaceToSchema(element, [...namespace, value]);
+          return element;
         });
+      } else if (value && typeof value === "object" && "name" in value) {
+        newNode[key] = addNamespaceToSchema(value, [...namespace, value.name]);
       } else {
-        if (!m) {
-          return;
-        }
-        if (!m.hasOwnProperty("name")) {
-          newNode[key] = m;
-        } else {
-          newNode[key] = addNamespaceToSchema(m, [...namespace, m.name]);
-        }
+        newNode[key] = value;
       }
     });
-    return { ...newNode, namespace };
+    return newNode;
   }
   function getDefaultExportFromCjs(x) {
     return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
@@ -1680,6 +1664,9 @@
     };
   };
   const normalizePath = (filepath) => filepath.replace(/\\/g, "/");
+  const canonicalPath = (filepath) => {
+    return normalizePath(filepath).split("/").filter((name2) => name2 !== "").join("/");
+  };
   class TinaSchema {
     /**
      * Create a schema class from a user defined schema object
@@ -1729,21 +1716,21 @@
       };
       this.getCollectionByFullPath = (filepath) => {
         const fileExtension = filepath.split(".").pop();
-        const normalizedPath = filepath.replace(/\\/g, "/");
+        const canonicalFilepath = canonicalPath(filepath);
         const possibleCollections = this.getCollections().filter((collection) => {
           var _a, _b;
-          if (!normalizedPath.endsWith(`.gitkeep.${collection.format || "md"}`) && fileExtension !== (collection.format || "md")) {
+          if (!canonicalFilepath.endsWith(`.gitkeep.${collection.format || "md"}`) && fileExtension !== (collection.format || "md")) {
             return false;
           }
           if (((_a = collection == null ? void 0 : collection.match) == null ? void 0 : _a.include) || ((_b = collection == null ? void 0 : collection.match) == null ? void 0 : _b.exclude)) {
             const matches = this.getMatches({ collection });
-            const match = picomatch$1.isMatch(normalizedPath, matches);
+            const match = picomatch$1.isMatch(canonicalFilepath, matches);
             if (!match) {
               return false;
             }
           }
-          const path = collection.path ? collection.path.replace(/\/?$/, "/") : "";
-          return normalizedPath.startsWith(path);
+          const collectionPath = canonicalPath(collection.path);
+          return collectionPath === "" || canonicalFilepath.startsWith(`${collectionPath}/`);
         });
         if (possibleCollections.length === 0) {
           throw new Error(`Unable to find collection for file at ${filepath}`);
@@ -1961,7 +1948,7 @@
           }
         }
       };
-      this.walkFields = (cb) => {
+      this.legacyWalkFields = (cb) => {
         const walk = (collectionOrObject, collection, path) => {
           if (collectionOrObject.templates) {
             collectionOrObject.templates.forEach((template) => {
@@ -1983,7 +1970,7 @@
         collections.forEach((collection) => walk(collection, collection, []));
       };
       this.schema = config;
-      this.walkFields(({ field, collection, path }) => {
+      this.legacyWalkFields(({ field, collection }) => {
         if (!("searchable" in field)) {
           if (field.type === "image") {
             field.searchable = false;
@@ -2004,20 +1991,67 @@
         field.uid = field.uid || false;
       });
     }
-    findReferences(name2) {
+    findReferencesFromCollection(name2) {
       const result = {};
       this.walkFields(({ field, collection: c, path }) => {
+        if (c.name !== name2) {
+          return;
+        }
         if (field.type === "reference") {
-          if (field.collections.includes(name2)) {
-            if (result[c.name] === void 0) {
-              result[c.name] = [];
+          field.collections.forEach((name22) => {
+            if (result[name22] === void 0) {
+              result[name22] = [];
             }
-            result[c.name].push({ path, field });
-          }
+            result[name22].push(path);
+          });
         }
       });
       return result;
     }
+    /**
+     * Walk all fields in tina schema
+     *
+     * @param cb callback function invoked for each field
+     */
+    walkFields(cb) {
+      const walk = (collectionOrObject, collection, path = "$") => {
+        if (collectionOrObject.templates) {
+          collectionOrObject.templates.forEach((template) => {
+            const templatePath = `${path}.${template.name}`;
+            template.fields.forEach((field) => {
+              const fieldPath = field.list ? `${templatePath}[*].${field.name}` : `${templatePath}.${field.name}`;
+              cb({ field, collection, path: fieldPath });
+              if (field.type === "object") {
+                walk(field, collection, fieldPath);
+              }
+            });
+          });
+        }
+        if (collectionOrObject.fields) {
+          collectionOrObject.fields.forEach((field) => {
+            const fieldPath = field.list ? `${path}.${field.name}[*]` : `${path}.${field.name}`;
+            cb({ field, collection, path: fieldPath });
+            if (field.type === "object" && field.fields) {
+              walk(field, collection, fieldPath);
+            } else if (field.templates) {
+              field.templates.forEach((template) => {
+                const templatePath = `${fieldPath}.${template.name}`;
+                template.fields.forEach((field2) => {
+                  const fieldPath2 = field2.list ? `${templatePath}[*].${field2.name}` : `${templatePath}.${field2.name}`;
+                  cb({ field: field2, collection, path: fieldPath2 });
+                  if (field2.type === "object") {
+                    walk(field2, collection, fieldPath2);
+                  }
+                });
+              });
+            }
+          });
+        }
+      };
+      this.getCollections().forEach((collection) => {
+        walk(collection, collection);
+      });
+    }
     /**
      * This function returns an array of glob matches for a given collection.
      *
@@ -2029,16 +2063,16 @@
     }) {
       var _a, _b;
       const collection = typeof collectionOrString === "string" ? this.getCollection(collectionOrString) : collectionOrString;
-      const normalPath = normalizePath(collection.path);
-      const pathSuffix = normalPath ? "/" : "";
+      const collectionPath = canonicalPath(collection.path);
+      const pathSuffix = collectionPath ? "/" : "";
       const format = collection.format || "md";
       const matches = [];
       if ((_a = collection == null ? void 0 : collection.match) == null ? void 0 : _a.include) {
-        const match = `${normalPath}${pathSuffix}${collection.match.include}.${format}`;
+        const match = `${collectionPath}${pathSuffix}${collection.match.include}.${format}`;
         matches.push(match);
       }
       if ((_b = collection == null ? void 0 : collection.match) == null ? void 0 : _b.exclude) {
-        const exclude = `!(${normalPath}${pathSuffix}${collection.match.exclude}.${format})`;
+        const exclude = `!(${collectionPath}${pathSuffix}${collection.match.exclude}.${format})`;
         matches.push(exclude);
       }
       return matches;
@@ -2231,6 +2265,15 @@
       })
     };
   };
+  const CONTENT_FORMATS = [
+    "mdx",
+    "md",
+    "markdown",
+    "json",
+    "yaml",
+    "yml",
+    "toml"
+  ];
   const parseZodError = ({ zodError }) => {
     var _a, _b, _c, _d;
     const errors = zodError.flatten((issue) => {
@@ -2540,15 +2583,6 @@ ${stringifiedField}`
     const newConfig = tinaConfigZod.parse(config);
     return newConfig;
   };
-  const FORMATS = [
-    "json",
-    "md",
-    "markdown",
-    "mdx",
-    "toml",
-    "yaml",
-    "yml"
-  ];
   const Template = z.z.object({
     label: z.z.string({
       invalid_type_error: "Invalid data type for property `label`. Must be of type `string`",
@@ -2584,7 +2618,7 @@ ${stringifiedField}`
         });
       }
     }),
-    format: z.z.enum(FORMATS).optional(),
+    format: z.z.enum(CONTENT_FORMATS).optional(),
     isAuthCollection: z.z.boolean().optional(),
     isDetached: z.z.boolean().optional()
   });
@@ -2703,11 +2737,13 @@ ${stringifiedField}`
       throw new Error(e);
     }
   };
+  exports2.CONTENT_FORMATS = CONTENT_FORMATS;
   exports2.NAMER = NAMER;
   exports2.TINA_HOST = TINA_HOST;
   exports2.TinaSchema = TinaSchema;
   exports2.TinaSchemaValidationError = TinaSchemaValidationError;
   exports2.addNamespaceToSchema = addNamespaceToSchema;
+  exports2.canonicalPath = canonicalPath;
   exports2.normalizePath = normalizePath;
   exports2.parseURL = parseURL;
   exports2.resolveField = resolveField;

package/dist/index.mjs

@@ -2,42 +2,26 @@ import * as yup from "yup";
 import UrlPattern from "url-pattern";
 import z$1, { z, ZodError } from "zod";
 function addNamespaceToSchema(maybeNode, namespace = []) {
-  if (typeof maybeNode === "string") {
+  if (typeof maybeNode !== "object" || maybeNode === null) {
     return maybeNode;
   }
-  if (typeof maybeNode === "boolean") {
-    return maybeNode;
-  }
-  if (typeof maybeNode === "function") {
-    return maybeNode;
-  }
-  const newNode = { ...maybeNode };
-  const keys = Object.keys(maybeNode);
-  Object.values(maybeNode).map((m, index) => {
-    const key = keys[index];
-    if (Array.isArray(m)) {
-      newNode[key] = m.map((element) => {
-        if (!element) {
-          return;
-        }
-        if (!element.hasOwnProperty("name")) {
-          return element;
+  const newNode = { ...maybeNode, namespace: [...namespace] };
+  Object.entries(maybeNode).forEach(([key, value]) => {
+    if (Array.isArray(value)) {
+      newNode[key] = value.map((element) => {
+        if (element && typeof element === "object" && "name" in element) {
+          const valueName = element.name || element.value;
+          return addNamespaceToSchema(element, [...namespace, valueName]);
         }
-        const value = element.name || element.value;
-        return addNamespaceToSchema(element, [...namespace, value]);
+        return element;
       });
+    } else if (value && typeof value === "object" && "name" in value) {
+      newNode[key] = addNamespaceToSchema(value, [...namespace, value.name]);
     } else {
-      if (!m) {
-        return;
-      }
-      if (!m.hasOwnProperty("name")) {
-        newNode[key] = m;
-      } else {
-        newNode[key] = addNamespaceToSchema(m, [...namespace, m.name]);
-      }
+      newNode[key] = value;
     }
   });
-  return { ...newNode, namespace };
+  return newNode;
 }
 function getDefaultExportFromCjs(x) {
   return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, "default") ? x["default"] : x;
@@ -1662,6 +1646,9 @@ const parseURL = (url) => {
   };
 };
 const normalizePath = (filepath) => filepath.replace(/\\/g, "/");
+const canonicalPath = (filepath) => {
+  return normalizePath(filepath).split("/").filter((name2) => name2 !== "").join("/");
+};
 class TinaSchema {
   /**
    * Create a schema class from a user defined schema object
@@ -1711,21 +1698,21 @@ class TinaSchema {
     };
     this.getCollectionByFullPath = (filepath) => {
       const fileExtension = filepath.split(".").pop();
-      const normalizedPath = filepath.replace(/\\/g, "/");
+      const canonicalFilepath = canonicalPath(filepath);
       const possibleCollections = this.getCollections().filter((collection) => {
         var _a, _b;
-        if (!normalizedPath.endsWith(`.gitkeep.${collection.format || "md"}`) && fileExtension !== (collection.format || "md")) {
+        if (!canonicalFilepath.endsWith(`.gitkeep.${collection.format || "md"}`) && fileExtension !== (collection.format || "md")) {
           return false;
         }
         if (((_a = collection == null ? void 0 : collection.match) == null ? void 0 : _a.include) || ((_b = collection == null ? void 0 : collection.match) == null ? void 0 : _b.exclude)) {
           const matches = this.getMatches({ collection });
-          const match = picomatch$1.isMatch(normalizedPath, matches);
+          const match = picomatch$1.isMatch(canonicalFilepath, matches);
           if (!match) {
             return false;
           }
         }
-        const path = collection.path ? collection.path.replace(/\/?$/, "/") : "";
-        return normalizedPath.startsWith(path);
+        const collectionPath = canonicalPath(collection.path);
+        return collectionPath === "" || canonicalFilepath.startsWith(`${collectionPath}/`);
       });
       if (possibleCollections.length === 0) {
         throw new Error(`Unable to find collection for file at ${filepath}`);
@@ -1943,7 +1930,7 @@ class TinaSchema {
         }
       }
     };
-    this.walkFields = (cb) => {
+    this.legacyWalkFields = (cb) => {
       const walk = (collectionOrObject, collection, path) => {
         if (collectionOrObject.templates) {
           collectionOrObject.templates.forEach((template) => {
@@ -1965,7 +1952,7 @@ class TinaSchema {
       collections.forEach((collection) => walk(collection, collection, []));
     };
     this.schema = config;
-    this.walkFields(({ field, collection, path }) => {
+    this.legacyWalkFields(({ field, collection }) => {
       if (!("searchable" in field)) {
         if (field.type === "image") {
           field.searchable = false;
@@ -1986,20 +1973,67 @@ class TinaSchema {
       field.uid = field.uid || false;
     });
   }
-  findReferences(name2) {
+  findReferencesFromCollection(name2) {
     const result = {};
     this.walkFields(({ field, collection: c, path }) => {
+      if (c.name !== name2) {
+        return;
+      }
       if (field.type === "reference") {
-        if (field.collections.includes(name2)) {
-          if (result[c.name] === void 0) {
-            result[c.name] = [];
+        field.collections.forEach((name22) => {
+          if (result[name22] === void 0) {
+            result[name22] = [];
           }
-          result[c.name].push({ path, field });
-        }
+          result[name22].push(path);
+        });
       }
     });
     return result;
   }
+  /**
+   * Walk all fields in tina schema
+   *
+   * @param cb callback function invoked for each field
+   */
+  walkFields(cb) {
+    const walk = (collectionOrObject, collection, path = "$") => {
+      if (collectionOrObject.templates) {
+        collectionOrObject.templates.forEach((template) => {
+          const templatePath = `${path}.${template.name}`;
+          template.fields.forEach((field) => {
+            const fieldPath = field.list ? `${templatePath}[*].${field.name}` : `${templatePath}.${field.name}`;
+            cb({ field, collection, path: fieldPath });
+            if (field.type === "object") {
+              walk(field, collection, fieldPath);
+            }
+          });
+        });
+      }
+      if (collectionOrObject.fields) {
+        collectionOrObject.fields.forEach((field) => {
+          const fieldPath = field.list ? `${path}.${field.name}[*]` : `${path}.${field.name}`;
+          cb({ field, collection, path: fieldPath });
+          if (field.type === "object" && field.fields) {
+            walk(field, collection, fieldPath);
+          } else if (field.templates) {
+            field.templates.forEach((template) => {
+              const templatePath = `${fieldPath}.${template.name}`;
+              template.fields.forEach((field2) => {
+                const fieldPath2 = field2.list ? `${templatePath}[*].${field2.name}` : `${templatePath}.${field2.name}`;
+                cb({ field: field2, collection, path: fieldPath2 });
+                if (field2.type === "object") {
+                  walk(field2, collection, fieldPath2);
+                }
+              });
+            });
+          }
+        });
+      }
+    };
+    this.getCollections().forEach((collection) => {
+      walk(collection, collection);
+    });
+  }
   /**
    * This function returns an array of glob matches for a given collection.
    *
@@ -2011,16 +2045,16 @@ class TinaSchema {
   }) {
     var _a, _b;
     const collection = typeof collectionOrString === "string" ? this.getCollection(collectionOrString) : collectionOrString;
-    const normalPath = normalizePath(collection.path);
-    const pathSuffix = normalPath ? "/" : "";
+    const collectionPath = canonicalPath(collection.path);
+    const pathSuffix = collectionPath ? "/" : "";
     const format = collection.format || "md";
     const matches = [];
     if ((_a = collection == null ? void 0 : collection.match) == null ? void 0 : _a.include) {
-      const match = `${normalPath}${pathSuffix}${collection.match.include}.${format}`;
+      const match = `${collectionPath}${pathSuffix}${collection.match.include}.${format}`;
       matches.push(match);
     }
     if ((_b = collection == null ? void 0 : collection.match) == null ? void 0 : _b.exclude) {
-      const exclude = `!(${normalPath}${pathSuffix}${collection.match.exclude}.${format})`;
+      const exclude = `!(${collectionPath}${pathSuffix}${collection.match.exclude}.${format})`;
       matches.push(exclude);
     }
     return matches;
@@ -2213,6 +2247,15 @@ const resolveForm = ({
     })
   };
 };
+const CONTENT_FORMATS = [
+  "mdx",
+  "md",
+  "markdown",
+  "json",
+  "yaml",
+  "yml",
+  "toml"
+];
 const parseZodError = ({ zodError }) => {
   var _a, _b, _c, _d;
   const errors = zodError.flatten((issue) => {
@@ -2522,15 +2565,6 @@ const validateTinaCloudSchemaConfig = (config) => {
   const newConfig = tinaConfigZod.parse(config);
   return newConfig;
 };
-const FORMATS = [
-  "json",
-  "md",
-  "markdown",
-  "mdx",
-  "toml",
-  "yaml",
-  "yml"
-];
 const Template = z.object({
   label: z.string({
     invalid_type_error: "Invalid data type for property `label`. Must be of type `string`",
@@ -2566,7 +2600,7 @@ const CollectionBaseSchema = z.object({
       });
     }
   }),
-  format: z.enum(FORMATS).optional(),
+  format: z.enum(CONTENT_FORMATS).optional(),
   isAuthCollection: z.boolean().optional(),
   isDetached: z.boolean().optional()
 });
@@ -2686,11 +2720,13 @@ const validateSchema = ({ schema }) => {
   }
 };
 export {
+  CONTENT_FORMATS,
   NAMER,
   TINA_HOST,
   TinaSchema,
   TinaSchemaValidationError,
   addNamespaceToSchema,
+  canonicalPath,
   normalizePath,
   parseURL,
   resolveField,

package/dist/schema/TinaSchema.d.ts

@@ -28,10 +28,7 @@ export declare class TinaSchema {
     } & Schema);
     getIsTitleFieldName: (collection: string) => string;
     getCollectionsByName: (collectionNames: string[]) => Collection<true>[];
-    findReferences(name: string): Record<string, {
-        path: string[];
-        field: TinaField;
-    }[]>;
+    findReferencesFromCollection(name: string): Record<string, string[]>;
     getCollection: (collectionName: string) => Collection<true>;
     getCollections: () => Collection<true>[];
     getCollectionByFullPath: (filepath: string) => Collection<true>;
@@ -63,7 +60,26 @@ export declare class TinaSchema {
      *
      */
     getTemplatesForCollectable: (collection: Collectable) => CollectionTemplateable;
-    walkFields: (cb: (args: {
+    /**
+     * Walk all fields in tina schema
+     *
+     * @param cb callback function invoked for each field
+     */
+    walkFields(cb: (args: {
+        field: any;
+        collection: any;
+        path: string;
+        isListItem?: boolean;
+    }) => void): void;
+    /**
+     * Walk all fields in Tina Schema
+     *
+     * This is a legacy version to preserve backwards compatibility for the tina generated schema. It does not
+     * traverse fields in object lists in rich-text templates.
+     *
+     * @param cb callback function invoked for each field
+     */
+    legacyWalkFields: (cb: (args: {
         field: TinaField;
         collection: Collection;
         path: string[];

package/dist/schema/addNamespaceToSchema.d.ts

@@ -1,4 +1,8 @@
-/**
-
-*/
-export declare function addNamespaceToSchema<T extends object | string>(maybeNode: T, namespace?: string[]): T;
+type Node = {
+    name?: string;
+    value?: string;
+    namespace?: string[];
+    [key: string]: any;
+};
+export declare function addNamespaceToSchema<T extends Node | string>(maybeNode: T, namespace?: string[]): T;
+export {};

package/dist/types/index.d.ts

@@ -1,5 +1,23 @@
 import type { FC } from 'react';
 import type React from 'react';
+export declare const CONTENT_FORMATS: readonly ["mdx", "md", "markdown", "json", "yaml", "yml", "toml"];
+export type ContentFormat = (typeof CONTENT_FORMATS)[number];
+export type ContentFrontmatterFormat = 'yaml' | 'toml' | 'json';
+export type Parser = {
+    type: 'mdx';
+} | {
+    type: 'markdown';
+    /**
+     * Tina will escape entities like `<` and `[` by default. You can choose to turn
+     * off all escaping, or specify HTML, so `<div>` will not be turned into `\<div>`
+     */
+    skipEscaping?: 'all' | 'html' | 'none';
+} | {
+    /**
+     * Experimental: Returns the native Slate.js document as JSON. Ideal to retain the pure editor content structure.
+     */
+    type: 'slatejson';
+};
 type Meta = {
     active?: boolean;
     dirty?: boolean;
@@ -111,6 +129,11 @@ export type UIField<Type, List extends boolean> = {
 type FieldGeneric<Type, List extends boolean | undefined, ExtraFieldUIProps = {}> = List extends true ? {
     list: true;
     ui?: UIField<Type, true> & ExtraFieldUIProps;
+    /**
+     * Defines where new items will be added in the list.
+     * If not specified, defaults to `append`.
+     */
+    addItemBehavior?: 'append' | 'prepend';
 } : List extends false ? {
     list?: false;
     ui?: UIField<Type, false> & ExtraFieldUIProps;
@@ -198,24 +221,21 @@ export type RichTextField<WithNamespace extends boolean = false> = (FieldGeneric
      * will be stored as frontmatter
      */
     isBody?: boolean;
+    /**@deprecated use overrides.toolbar */
     toolbarOverride?: ToolbarOverrideType[];
     templates?: RichTextTemplate<WithNamespace>[];
+    overrides?: {
+        toolbar?: ToolbarOverrideType[];
+        /**Default set to true */
+        showFloatingToolbar?: boolean;
+    };
     /**
      * By default, Tina parses markdown with MDX, this is a more strict parser
      * that allows you to use structured content inside markdown (via `templates`).
      *
      * Specify `"markdown"` if you're having problems with Tina parsing your content.
      */
-    parser?: {
-        type: 'markdown';
-        /**
-         * Tina will escape entities like `<` and `[` by default. You can choose to turn
-         * off all escaping, or specify HTML, so `<div>` will not be turned into `\<div>`
-         */
-        skipEscaping?: 'all' | 'html' | 'none';
-    } | {
-        type: 'mdx';
-    };
+    parser?: Parser;
 };
 export type RichTextTemplate<WithNamespace extends boolean = false> = Template<WithNamespace> & {
     inline?: boolean;
@@ -394,7 +414,7 @@ export interface Config<CMSCallback = undefined, FormifyCallback = undefined, Do
     token?: string | null;
     ui?: {
         /**
-         * When using Tina Cloud's branching feature, provide the URL for your given branch
+         * When using TinaCloud's branching feature, provide the URL for your given branch
          *
          * Eg. If you're deplying to Vercel, and your repo name is 'my-app',
          * Vercel's preview URL would be based on the branch:
@@ -408,11 +428,17 @@ export interface Config<CMSCallback = undefined, FormifyCallback = undefined, Do
          * ```
          * [more info](https://vercel.com/docs/concepts/deployments/generated-urls#url-with-git-branch)
          */
-        previewUrl: (context: {
+        previewUrl?: (context: {
             branch: string;
         }) => {
             url: string;
         };
+        /**
+         * Opt out of update checks - this will prevent the CMS for checking for new versions
+         * If true, the CMS will not check for updates.
+         * Defaults to false if not specified.
+         */
+        optOutOfUpdateCheck?: boolean;
     };
     /**
      * Configurations for the autogenerated GraphQL HTTP client
@@ -521,7 +547,7 @@ export interface Config<CMSCallback = undefined, FormifyCallback = undefined, Do
     } | {
         searchClient?: never;
         /**
-         * Use the Tina Cloud search index
+         * Use the TinaCloud search index
          */
         tina: {
             /**
@@ -548,7 +574,7 @@ export interface Config<CMSCallback = undefined, FormifyCallback = undefined, Do
         maxSearchIndexFieldLength?: number;
     };
     /**
-     * Used to override the default Tina Cloud API URL
+     * Used to override the default TinaCloud API URL
      *
      * [mostly for internal use only]
      */
@@ -581,7 +607,7 @@ interface BaseCollection {
     name: string;
     path: string;
     indexes?: IndexType[];
-    format?: 'json' | 'md' | 'markdown' | 'mdx' | 'yaml' | 'yml' | 'toml';
+    format?: ContentFormat;
     ui?: UICollection;
     /**
      * @deprecated - use `ui.defaultItem` on the each `template` instead
@@ -590,7 +616,7 @@ interface BaseCollection {
     /**
      * This format will be used to parse the markdown frontmatter
      */
-    frontmatterFormat?: 'yaml' | 'toml' | 'json';
+    frontmatterFormat?: ContentFrontmatterFormat;
     /**
      * The delimiters used to parse the frontmatter.
      */

package/dist/util/normalizePath.d.ts

@@ -1 +1,9 @@
 export declare const normalizePath: (filepath: string) => string;
+/**
+ * Returns the given path such that:
+ * - The path separator is converted from '\' to '/' if necessary.
+ * - Duplicate '/' are removed
+ * - Leading and trailing '/' are cleared
+ * @param filepath Filepath to convert to its canonical form
+ */
+export declare const canonicalPath: (filepath: string) => string;

package/dist/validate/schema.d.ts

@@ -3,21 +3,21 @@ export declare const CollectionBaseSchema: z.ZodObject<{
     label: z.ZodOptional<z.ZodString>;
     name: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
     path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-    format: z.ZodOptional<z.ZodEnum<["json", "md", "markdown", "mdx", "toml", "yaml", "yml"]>>;
+    format: z.ZodOptional<z.ZodEnum<["mdx", "md", "markdown", "json", "yaml", "yml", "toml"]>>;
     isAuthCollection: z.ZodOptional<z.ZodBoolean>;
     isDetached: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     name?: string;
     label?: string;
     path?: string;
-    format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+    format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
     isDetached?: boolean;
     isAuthCollection?: boolean;
 }, {
     name?: string;
     label?: string;
     path?: string;
-    format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+    format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
     isDetached?: boolean;
     isAuthCollection?: boolean;
 }>;
@@ -26,90 +26,90 @@ export declare const TinaCloudSchemaZod: z.ZodEffects<z.ZodObject<{
         label: z.ZodOptional<z.ZodString>;
         name: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
         path: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-        format: z.ZodOptional<z.ZodEnum<["json", "md", "markdown", "mdx", "toml", "yaml", "yml"]>>;
+        format: z.ZodOptional<z.ZodEnum<["mdx", "md", "markdown", "json", "yaml", "yml", "toml"]>>;
         isAuthCollection: z.ZodOptional<z.ZodBoolean>;
         isDetached: z.ZodOptional<z.ZodBoolean>;
     }, {
-        fields: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodType<import("..").TinaField, z.ZodTypeDef, import("..").TinaField>, "many">>, import("..").TinaField[], import("..").TinaField[]>, import("..").TinaField[], import("..").TinaField[]>, import("..").TinaField[], import("..").TinaField[]>, import("..").TinaField[], import("..").TinaField[]>;
+        fields: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodType<import("../types/index").TinaField, z.ZodTypeDef, import("../types/index").TinaField>, "many">>, import("../types/index").TinaField[], import("../types/index").TinaField[]>, import("../types/index").TinaField[], import("../types/index").TinaField[]>, import("../types/index").TinaField[], import("../types/index").TinaField[]>, import("../types/index").TinaField[], import("../types/index").TinaField[]>;
         templates: z.ZodEffects<z.ZodOptional<z.ZodArray<z.ZodEffects<z.ZodObject<{
             label: z.ZodString;
             name: z.ZodEffects<z.ZodString, string, string>;
-            fields: z.ZodArray<z.ZodType<import("..").TinaField, z.ZodTypeDef, import("..").TinaField>, "many">;
+            fields: z.ZodArray<z.ZodType<import("../types/index").TinaField, z.ZodTypeDef, import("../types/index").TinaField>, "many">;
         }, "strip", z.ZodTypeAny, {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }, {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }>, {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }, {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }>, "many">>, {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[], {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[]>;
     }>, "strip", z.ZodTypeAny, {
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }, {
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }>, {
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }, {
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }>, "many">;
@@ -237,13 +237,13 @@ export declare const TinaCloudSchemaZod: z.ZodEffects<z.ZodObject<{
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }[];
@@ -275,13 +275,13 @@ export declare const TinaCloudSchemaZod: z.ZodEffects<z.ZodObject<{
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }[];
@@ -313,13 +313,13 @@ export declare const TinaCloudSchemaZod: z.ZodEffects<z.ZodObject<{
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }[];
@@ -351,13 +351,13 @@ export declare const TinaCloudSchemaZod: z.ZodEffects<z.ZodObject<{
         name?: string;
         templates?: {
             name?: string;
-            fields?: import("..").TinaField[];
+            fields?: import("../types/index").TinaField[];
             label?: string;
         }[];
-        fields?: import("..").TinaField[];
+        fields?: import("../types/index").TinaField[];
         label?: string;
         path?: string;
-        format?: "markdown" | "mdx" | "json" | "md" | "yaml" | "yml" | "toml";
+        format?: "mdx" | "md" | "markdown" | "json" | "yaml" | "yml" | "toml";
         isDetached?: boolean;
         isAuthCollection?: boolean;
     }[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinacms/schema-tools",
-  "version": "0.0.0-c45ac5d-20241213020122",
+  "version": "0.0.0-c466c52-20250801052040",
   "main": "dist/index.js",
   "module": "./dist/index.mjs",
   "exports": {
@@ -25,14 +25,14 @@
   "devDependencies": {
     "@types/jest": "^29.5.14",
     "@types/micromatch": "^4.0.9",
-    "@types/react": "^18.3.12",
+    "@types/react": "^18.3.18",
     "@types/yup": "^0.29.14",
     "jest": "^29.7.0",
     "react": "^18.3.1",
     "ts-jest": "^29.2.5",
-    "typescript": "^5.6.3",
+    "typescript": "^5.7.3",
     "yup": "^0.32.11",
-    "@tinacms/scripts": "1.3.1"
+    "@tinacms/scripts": "1.4.0"
   },
   "peerDependencies": {
     "react": ">=16.14.0",
@@ -48,7 +48,7 @@
   "dependencies": {
     "picomatch-browser": "2.2.6",
     "url-pattern": "^1.0.3",
-    "zod": "^3.23.8"
+    "zod": "^3.24.2"
   },
   "scripts": {
     "build": "tinacms-scripts build",