@sveltia/cms 0.129.5 → 0.140.0

package/types/public.d.ts

@@ -692,6 +692,14 @@ export type KeyValueFieldProps = {
      * Label for the value column. Default: Value.
      */
     value_label?: string;
+    /**
+     * Whether to save the field value at the top-level of the data file
+     * without the field name. If the `single_file` i18n structure is enabled, the key-value pairs will
+     * still be saved under locale keys. Default: `false`. See the
+     * [documentation](https://sveltiacms.app/en/docs/fields/keyvalue#top-level-key-value-pairs) for
+     * details.
+     */
+    root?: boolean;
 };
 /**
  * KeyValue field definition.
@@ -1237,7 +1245,7 @@ export type Field = StandardField | CustomField;
 /**
  * Internationalization (i18n) file structure type.
  */
-export type I18nFileStructure = "single_file" | "multiple_files" | "multiple_folders" | "multiple_folders_i18n_root";
+export type I18nFileStructure = "single_file" | "multiple_files" | "multiple_folders" | "multiple_folders_i18n_root" | "multiple_root_folders";
 /**
  * Global, collection-level or collection file-level i18n options. See the
  * [documentation](https://sveltiacms.app/en/docs/i18n) for details.
@@ -1245,7 +1253,8 @@ export type I18nFileStructure = "single_file" | "multiple_files" | "multiple_fol
 export type I18nOptions = {
     /**
      * File structure for entry collections. File/singleton
-     * collection must define the structure using `{{locale}}` in the `file` option. See the
+     * collection must define the structure using `{{locale}}` in the `file` option.
+     * `multiple_folders_i18n_root` has been deprecated in favor of `multiple_root_folders`. See the
      * [documentation](https://sveltiacms.app/en/docs/i18n#managing-content-structure) for details.
      */
     structure: I18nFileStructure;
@@ -1291,8 +1300,22 @@ export type I18nOptions = {
      * `multiple_files` i18n structure enabled, as well as to file/singleton collection items with the
      * `file` path ending with `.{{locale}}.<extension>`, aiming to support [Zola’s multilingual
      * sites](https://www.getzola.org/documentation/content/multilingual/).
+     * @deprecated Use the `omit_default_locale_from_file_path` option instead.
      */
     omit_default_locale_from_filename?: boolean;
+    /**
+     * Whether to exclude the default locale
+     * from entry file paths. Default: `false`. This option applies to both entry collections and file
+     * collections, where the path includes a `{{locale}}.` or  `{{locale}}/` placeholder. It aims to
+     * support [Zola’s multilingual sites](https://www.getzola.org/documentation/content/multilingual/).
+     */
+    omit_default_locale_from_file_path?: boolean;
+    /**
+     * Whether to exclude the default locale
+     * from preview URL paths. Default: `false`. This option helps to create cleaner URLs for the
+     * default locale when generating preview links for multilingual content.
+     */
+    omit_default_locale_from_preview_path?: boolean;
 };
 /**
  * Single file in a file/singleton collection.