tinacms 0.0.0-b012b6c-20250808011625 → 0.0.0-b0f55b5-20251228232811

package/dist/toolkit/fields/plugins/radio-group-field-plugin.d.ts

@@ -1,6 +1,6 @@
-export declare const RadioGroupField: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").RadioGroupProps, {}>) => import("react").JSX.Element;
+export declare const RadioGroupField: (props: import("./wrap-field-with-meta").InputFieldType<import("..").RadioGroupProps, {}>) => import("react").JSX.Element;
 export declare const RadioGroupFieldPlugin: {
     name: string;
-    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").RadioGroupProps, {}>) => import("react").JSX.Element;
+    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("..").RadioGroupProps, {}>) => import("react").JSX.Element;
     validate(value: any, values: any, meta: any, field: any): string;
 };

package/dist/toolkit/fields/plugins/select-field-plugin.d.ts

@@ -1,8 +1,8 @@
-export declare const SelectField: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").SelectProps, {}>) => import("react").JSX.Element;
+export declare const SelectField: (props: import("./wrap-field-with-meta").InputFieldType<import("..").SelectProps, {}>) => import("react").JSX.Element;
 export declare const SelectFieldPlugin: {
     name: string;
     type: string;
-    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").SelectProps, {}>) => import("react").JSX.Element;
+    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("..").SelectProps, {}>) => import("react").JSX.Element;
     parse: (value?: string) => string;
     validate(value: any, values: any, meta: any, field: any): string;
 };

package/dist/toolkit/fields/plugins/toggle-field-plugin.d.ts

@@ -1,7 +1,7 @@
-export declare const ToggleField: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").ToggleProps, {}>) => import("react").JSX.Element;
+export declare const ToggleField: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, {}>) => import("react").JSX.Element;
 export declare const ToggleFieldPlugin: {
     name: string;
     type: string;
-    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("../components").ToggleProps, {}>) => import("react").JSX.Element;
+    Component: (props: import("./wrap-field-with-meta").InputFieldType<import("..").ToggleProps, {}>) => import("react").JSX.Element;
     validate(value: any, values: any, meta: any, field: any): string;
 };

package/dist/toolkit/fields/plugins/wrap-field-with-meta.d.ts

@@ -21,11 +21,15 @@ interface FieldMetaProps extends React.HTMLAttributes<HTMLElement> {
     margin?: boolean;
     index?: number;
     tinaForm: Form;
+    focusIntent?: boolean;
+    hoverIntent?: boolean;
 }
-export declare const FieldMeta: ({ name, label, description, error, margin, children, index, tinaForm, ...props }: FieldMetaProps) => React.JSX.Element;
-export declare const FieldWrapper: ({ margin, children, ...props }: {
+export declare const FieldMeta: ({ name, label, description, error, margin, children, index, tinaForm, focusIntent, hoverIntent, ...props }: FieldMetaProps) => React.JSX.Element;
+export declare const FieldWrapper: ({ margin, children, "data-tina-field-active": dataActive, "data-tina-field-hovering": dataHovering, ...restProps }: {
     margin: boolean;
     children: React.ReactNode;
+    "data-tina-field-active"?: string;
+    "data-tina-field-hovering"?: string;
 } & Partial<React.ComponentPropsWithoutRef<"div">>) => React.JSX.Element;
 export interface FieldLabel extends React.HTMLAttributes<HTMLLabelElement> {
     children?: any | any[];

package/dist/toolkit/form-builder/create-branch-modal.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+export declare const CreateBranchModal: ({ close, safeSubmit, path, values, crudType, }: {
+    safeSubmit: () => Promise<void>;
+    close: () => void;
+    path: string;
+    values: Record<string, unknown>;
+    crudType: string;
+}) => React.JSX.Element;
+export declare const PrefixedTextField: ({ label, prefix, ...props }: {
+    [x: string]: any;
+    label?: any;
+    prefix?: string;
+}) => React.JSX.Element;

package/dist/toolkit/form-builder/fields-builder.d.ts

@@ -3,10 +3,11 @@ import * as React from 'react';
 export interface FieldsBuilderProps {
     form: Form;
     activeFieldName?: string;
+    hoveringFieldName?: string;
     fields: Field[];
     padding?: boolean;
 }
-export declare function FieldsBuilder({ form, fields, activeFieldName, padding, }: FieldsBuilderProps): React.JSX.Element;
+export declare function FieldsBuilder({ form, fields, activeFieldName, hoveringFieldName, padding, }: FieldsBuilderProps): React.JSX.Element;
 export declare const FieldsGroup: ({ padding, children, }: {
     padding?: boolean;
     children?: any | any[];

package/dist/toolkit/form-builder/form-builder.d.ts

@@ -5,6 +5,7 @@ export interface FormBuilderProps {
     form: {
         tinaForm: Form;
         activeFieldName?: string;
+        hoveringFieldName?: string;
     };
     hideFooter?: boolean;
     label?: string;
@@ -29,14 +30,3 @@ export declare const CreateBranchModel: ({ close, safeSubmit, relativePath, valu
     values: Record<string, unknown>;
     crudType: string;
 }) => React.JSX.Element;
-export declare const CreateBranchModal: ({ close, safeSubmit, path, values, crudType, }: {
-    safeSubmit: () => Promise<void>;
-    close: () => void;
-    path: string;
-    values: Record<string, unknown>;
-    crudType: string;
-}) => React.JSX.Element;
-export declare const PrefixedTextField: ({ prefix, ...props }: {
-    [x: string]: any;
-    prefix?: string;
-}) => React.JSX.Element;

package/dist/toolkit/form-builder/index.d.ts

@@ -7,4 +7,5 @@ export * from './form-portal';
 export * from './loading-dots';
 export * from './reset-form';
 export * from './form-actions';
+export * from './create-branch-modal';
 export type { FieldRenderProps } from 'react-final-form';

package/dist/toolkit/forms/field.d.ts

@@ -20,9 +20,10 @@ export interface Field<F extends Field = AnyField> {
      * a guarantee that the given field will receive focus since that functionality
      * needs to be built on a per-component basis.
      *
-     * This is also a one-way stree. The "active field" for a given form isn't
+     * This is also a one-way street. The "active field" for a given form isn't
      * necessarily updated when a user clicks on a new field. So you can have a
      * field which is marked as the active field, and have focus on another field
      */
-    experimental_focusIntent?: boolean;
+    focusIntent?: boolean;
+    hoverIntent?: boolean;
 }

package/dist/toolkit/icons/TinaExtended.d.ts

@@ -0,0 +1,4 @@
+import * as React from 'react';
+export declare const TinaExtendedIcon: ({ ...props }: {
+    [x: string]: any;
+}) => React.JSX.Element;

package/dist/toolkit/icons/index.d.ts

@@ -52,3 +52,4 @@ export * from './Folder';
 export * from './File';
 export * from './Circle';
 export * from './CircleCheck';
+export * from './TinaExtended';

package/dist/toolkit/index.d.ts

@@ -19,7 +19,7 @@ export type { TinaState } from './tina-state';
 export * from './forms';
 export * from './icons';
 export * from './react-dismissible';
-export { Nav, LocalWarning, BillingWarning, SyncStatusButton, } from './react-sidebar';
+export { Nav, NavCloudLink, NavProvider, NavMenuTrigger, useNav, LocalWarning, BillingWarning, SyncStatusButton, } from './react-sidebar';
 export { useCMS } from './react-core';
 /**
  * Custom `tinacms` things

package/dist/toolkit/plugin-branch-switcher/branch-button.d.ts

@@ -1,3 +1,5 @@
 import * as React from 'react';
-export declare const BranchButton: () => React.JSX.Element;
+export declare const BranchButton: ({ className }: {
+    className?: string;
+}) => React.JSX.Element;
 export declare const BranchPreviewButton: (props: React.ButtonHTMLAttributes<HTMLButtonElement>) => React.JSX.Element;

package/dist/toolkit/react-modals/modal/modal-actions.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
-export declare const ModalActions: ({ children }: {
+export declare const ModalActions: ({ align, children }: {
+    align?: string;
     children: any;
 }) => React.JSX.Element;

package/dist/toolkit/react-modals/modal/modal-header.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 export interface ModalHeaderProps {
-    children: React.ReactChild | React.ReactChild[];
+    children: React.ReactNode;
     close?(): void;
 }
 export declare const ModalHeader: ({ children, close }: ModalHeaderProps) => React.JSX.Element;

package/dist/toolkit/react-sidebar/components/NavMenuTrigger.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+interface NavMenuTriggerProps {
+    className?: string;
+    label?: string;
+}
+/**
+ * A button component that triggers the navigation menu
+ * Can be used anywhere within the NavProvider hierarchy
+ */
+export declare const NavMenuTrigger: React.FC<NavMenuTriggerProps>;
+export {};

package/dist/toolkit/react-sidebar/components/badge.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+export declare const Badge: ({ children, calloutStyle, className, displayIcon, ...props }: {
+    children?: React.ReactNode;
+    calloutStyle?: "warning" | "info" | "success" | "error";
+    displayIcon?: boolean;
+} & React.HTMLProps<HTMLDivElement>) => React.JSX.Element;

package/dist/toolkit/react-sidebar/components/callout.d.ts

@@ -0,0 +1,5 @@
+import * as React from 'react';
+export declare const Callout: ({ children, calloutStyle, className, ...props }: {
+    children?: React.ReactNode;
+    calloutStyle?: "warning" | "info" | "success" | "error";
+} & React.HTMLProps<HTMLDivElement>) => React.JSX.Element;

package/dist/toolkit/react-sidebar/components/local-warning.d.ts

@@ -1,3 +1,5 @@
 import * as React from 'react';
-export declare const LocalWarning: () => React.JSX.Element;
+export declare const LocalWarning: ({ className }: {
+    className?: string;
+}) => React.JSX.Element;
 export declare const BillingWarning: () => React.JSX.Element;

package/dist/toolkit/react-sidebar/components/nav-components.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { CloudConfigPlugin } from '../../react-cloud-config';
+interface NavCloudLinkProps {
+    config: CloudConfigPlugin;
+}
+/**
+ * Shared component for rendering cloud configuration links
+ * Used across both admin and sidebar navigation
+ */
+export declare const NavCloudLink: React.FC<NavCloudLinkProps>;
+export {};

package/dist/toolkit/react-sidebar/components/nav-context.d.ts

@@ -0,0 +1,15 @@
+import React, { ReactNode } from 'react';
+export interface NavContextValue {
+    menuIsOpen: boolean;
+    toggleMenu: () => void;
+    openMenu: () => void;
+    closeMenu: () => void;
+}
+export declare const NavContext: React.Context<NavContextValue>;
+export declare const useNav: () => NavContextValue;
+interface NavProviderProps {
+    children: ReactNode;
+    defaultOpen?: boolean;
+}
+export declare const NavProvider: React.FC<NavProviderProps>;
+export {};

package/dist/toolkit/react-sidebar/components/nav.d.ts

@@ -9,8 +9,8 @@ interface NavCollection {
 interface NavProps {
     isLocalMode: boolean;
     showHamburger?: boolean;
-    menuIsOpen: boolean;
-    toggleMenu: () => void;
+    menuIsOpen?: boolean;
+    toggleMenu?: () => void;
     children?: any;
     className?: string;
     userName?: string;
@@ -41,5 +41,5 @@ interface NavProps {
         };
     }>;
 }
-export declare const Nav: ({ isLocalMode, showHamburger, menuIsOpen, toggleMenu, className, children, showCollections, collectionsInfo, screens, cloudConfigs, contentCreators, sidebarWidth, RenderNavSite, RenderNavCloud, RenderNavCollection, AuthRenderNavCollection, ...props }: NavProps) => React.JSX.Element;
+export declare const Nav: ({ isLocalMode, showHamburger, menuIsOpen: menuIsOpenProp, toggleMenu: toggleMenuProp, className, children, showCollections, collectionsInfo, screens, cloudConfigs, contentCreators, sidebarWidth, RenderNavSite, RenderNavCloud, RenderNavCollection, AuthRenderNavCollection, ...props }: NavProps) => React.JSX.Element;
 export {};

package/dist/toolkit/react-sidebar/components/sidebar-body.d.ts

@@ -9,8 +9,33 @@ export interface FormHeaderProps {
         activeFieldName?: string;
         tinaForm: Form;
     };
+    branch?: string;
+    isLocalMode?: boolean;
+    repoProvider?: {
+        defaultBranchName?: string;
+        historyUrl?: (context: {
+            relativePath: string;
+            branch: string;
+        }) => {
+            url: string;
+        };
+    };
+}
+export declare const FormHeader: ({ activeForm, repoProvider, branch, isLocalMode, }: FormHeaderProps) => React.JSX.Element;
+interface RepositoryProviderProps {
+    contentRelativePath: string;
+    tinaBranch?: string;
+    isLocalMode?: boolean;
+    defaultBranchName?: string;
+    historyUrl?: (context: {
+        relativePath: string;
+        branch: string;
+    }) => {
+        url: string;
+    };
 }
-export declare const FormHeader: ({ activeForm }: FormHeaderProps) => React.JSX.Element;
+export declare const FileHistoryProvider: ({ contentRelativePath, tinaBranch, defaultBranchName, historyUrl, isLocalMode, }: RepositoryProviderProps) => React.JSX.Element;
 export declare const FormBreadcrumbs: ({ rootBreadcrumbName, ...props }: {
     rootBreadcrumbName?: string;
 } & React.HTMLAttributes<HTMLDivElement>) => React.JSX.Element;
+export {};

package/dist/toolkit/react-sidebar/index.d.ts

@@ -3,3 +3,6 @@ export { SidebarProvider } from './components/sidebar';
 export { Nav } from './components/nav';
 export { LocalWarning, BillingWarning } from './components/local-warning';
 export { SyncStatusButton } from './components/sync-status';
+export { NavCloudLink } from './components/nav-components';
+export { NavProvider, useNav } from './components/nav-context';
+export { NavMenuTrigger } from './components/NavMenuTrigger';

package/dist/toolkit/styles/dropdown-button.d.ts

@@ -0,0 +1,75 @@
+import * as React from 'react';
+import { ButtonProps } from './button';
+export interface DropdownButtonItem {
+    label: string;
+    onClick: () => void;
+    variant?: 'default' | 'destructive';
+    icon?: React.ReactNode;
+    disabled?: boolean;
+}
+export interface DropdownButtonProps extends Omit<ButtonProps, 'onClick'> {
+    /**
+     * The main action to perform when the button is clicked
+     */
+    onMainAction?: () => void;
+    /**
+     * Array of dropdown menu items
+     */
+    items: DropdownButtonItem[];
+    /**
+     * Whether to show the dropdown arrow in a split button style
+     * @default true
+     */
+    showSplitButton?: boolean;
+    /**
+     * Alignment of the dropdown menu
+     * @default 'end'
+     */
+    align?: 'start' | 'center' | 'end';
+}
+/**
+ * A button component that combines a primary action with a dropdown menu of additional options.
+ *
+ * This component follows the split-button pattern found in TinaCMS, where the main button
+ * performs a primary action and a small arrow button opens a dropdown menu with additional options.
+ *
+ * @example
+ * // Basic usage with split button
+ * <DropdownButton
+ *   variant="primary"
+ *   onMainAction={() => console.log('Save to new branch')}
+ *   items={[
+ *     { label: 'Save to protected branch', onClick: () => console.log('Protected') },
+ *     { label: 'Save and publish', onClick: () => console.log('Publish') },
+ *   ]}
+ * >
+ *   Save to new branch
+ * </DropdownButton>
+ *
+ * @example
+ * // Dropdown-only button (no main action)
+ * <DropdownButton
+ *   variant="secondary"
+ *   showSplitButton={false}
+ *   items={[
+ *     { label: 'Save to new branch', onClick: () => console.log('New branch') },
+ *     { label: 'Save to protected branch', onClick: () => console.log('Protected') },
+ *   ]}
+ * >
+ *   Save options
+ * </DropdownButton>
+ *
+ * @example
+ * // With icons and destructive action
+ * <DropdownButton
+ *   variant="primary"
+ *   onMainAction={() => console.log('Save')}
+ *   items={[
+ *     { label: 'Duplicate', onClick: () => console.log('Duplicate'), icon: <CopyIcon /> },
+ *     { label: 'Delete', onClick: () => console.log('Delete'), variant: 'destructive', icon: <TrashIcon /> },
+ *   ]}
+ * >
+ *   Save
+ * </DropdownButton>
+ */
+export declare const DropdownButton: React.ForwardRefExoticComponent<DropdownButtonProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/toolkit/styles/index.d.ts

@@ -2,3 +2,4 @@ export * from './button';
 export * from './font-loader';
 export * from './overflow-menu';
 export * from './message';
+export * from './dropdown-button';

package/dist/toolkit/tina-state.d.ts

@@ -1,5 +1,24 @@
 import { Form } from './react-tinacms';
 import { TinaCMS } from './tina-cms';
+export declare const ACTION_TYPES: {
+    readonly FORMS_ADD: "forms:add";
+    readonly FORMS_REMOVE: "forms:remove";
+    readonly FORMS_CLEAR: "forms:clear";
+    readonly FORMS_SET_ACTIVE_FORM_ID: "forms:set-active-form-id";
+    readonly FORMS_SET_ACTIVE_FIELD_NAME: "forms:set-active-field-name";
+    readonly FORMS_SET_HOVERED_FIELD_NAME: "forms:set-hovered-field-name";
+    readonly FORM_LISTS_ADD: "form-lists:add";
+    readonly FORM_LISTS_REMOVE: "form-lists:remove";
+    readonly FORM_LISTS_CLEAR: "form-lists:clear";
+    readonly SET_EDIT_MODE: "set-edit-mode";
+    readonly INCREMENT_OPERATION_INDEX: "increment-operation-index";
+    readonly SET_QUICK_EDITING_SUPPORTED: "set-quick-editing-supported";
+    readonly SET_QUICK_EDITING_ENABLED: "set-quick-editing-enabled";
+    readonly TOGGLE_QUICK_EDITING_ENABLED: "toggle-quick-editing-enabled";
+    readonly TOGGLE_EDIT_STATE: "toggle-edit-state";
+    readonly SIDEBAR_SET_DISPLAY_STATE: "sidebar:set-display-state";
+    readonly SIDEBAR_SET_LOADING_STATE: "sidebar:set-loading-state";
+};
 type FormListItem = {
     type: 'document';
     path: string;
@@ -22,50 +41,56 @@ type Breadcrumb = {
     namespace: string[];
 };
 export type TinaAction = {
-    type: 'forms:add';
+    type: typeof ACTION_TYPES.FORMS_ADD;
     value: Form;
 } | {
-    type: 'forms:remove';
+    type: typeof ACTION_TYPES.FORMS_REMOVE;
     value: string;
 } | {
-    type: 'forms:clear';
+    type: typeof ACTION_TYPES.FORMS_CLEAR;
 } | {
-    type: 'form-lists:add';
+    type: typeof ACTION_TYPES.FORM_LISTS_ADD;
     value: FormList;
 } | {
-    type: 'form-lists:remove';
+    type: typeof ACTION_TYPES.FORM_LISTS_REMOVE;
     value: string;
 } | {
-    type: 'forms:set-active-form-id';
+    type: typeof ACTION_TYPES.FORMS_SET_ACTIVE_FORM_ID;
     value: string;
 } | {
-    type: 'forms:set-active-field-name';
+    type: typeof ACTION_TYPES.FORMS_SET_ACTIVE_FIELD_NAME;
     value: {
         formId: string;
         fieldName: string;
     };
 } | {
-    type: 'form-lists:clear';
+    type: typeof ACTION_TYPES.FORMS_SET_HOVERED_FIELD_NAME;
+    value: {
+        formId: string;
+        fieldName: string | null;
+    };
+} | {
+    type: typeof ACTION_TYPES.FORM_LISTS_CLEAR;
 } | {
-    type: 'set-edit-mode';
+    type: typeof ACTION_TYPES.SET_EDIT_MODE;
     value: 'visual' | 'basic';
 } | {
-    type: 'increment-operation-index';
+    type: typeof ACTION_TYPES.INCREMENT_OPERATION_INDEX;
 } | {
-    type: 'set-quick-editing-supported';
+    type: typeof ACTION_TYPES.SET_QUICK_EDITING_SUPPORTED;
     value: boolean;
 } | {
-    type: 'set-quick-editing-enabled';
+    type: typeof ACTION_TYPES.SET_QUICK_EDITING_ENABLED;
     value?: boolean;
 } | {
-    type: 'toggle-quick-editing-enabled';
+    type: typeof ACTION_TYPES.TOGGLE_QUICK_EDITING_ENABLED;
 } | {
-    type: 'toggle-edit-state';
+    type: typeof ACTION_TYPES.TOGGLE_EDIT_STATE;
 } | {
-    type: 'sidebar:set-display-state';
+    type: typeof ACTION_TYPES.SIDEBAR_SET_DISPLAY_STATE;
     value: TinaState['sidebarDisplayState'] | 'openOrFull';
 } | {
-    type: 'sidebar:set-loading-state';
+    type: typeof ACTION_TYPES.SIDEBAR_SET_LOADING_STATE;
     value: boolean;
 };
 export interface TinaState {
@@ -83,6 +108,7 @@ export interface TinaState {
     forms: {
         activeFieldName?: string | null;
         tinaForm: Form;
+        hoveringFieldName?: string | null;
     }[];
     formLists: FormList[];
     editingMode: 'visual' | 'basic';

package/dist/unifiedClient/index.d.ts

@@ -29,7 +29,7 @@ export declare class TinaClient<GenQueries> {
     initialized: boolean;
     cacheLock: AsyncLock | undefined;
     cacheDir: string;
-    cache: Cache;
+    cache: Cache | null;
     constructor({ token, url, queries, errorPolicy, cacheDir, }: TinaClientArgs<GenQueries>);
     init(): Promise<void>;
     request<DataType extends Record<string, any> = any>({ errorPolicy, ...args }: TinaClientRequestArgs, options: {

package/dist/utils/index.d.ts

@@ -20,3 +20,4 @@ export interface CreateClientProps {
 export declare const createClient: ({ clientId, isLocalClient, branch, tinaioConfig, schema, apiUrl, tinaGraphQLVersion, }: CreateClientProps) => Client;
 export declare function assertShape<T>(value: unknown, yupSchema: (args: typeof yup) => yup.AnySchema, errorMessage?: string): asserts value is T;
 export declare function safeAssertShape<T>(value: unknown, yupSchema: (args: typeof yup) => yup.AnySchema): boolean;
+export declare const get: (obj: any, path: any, defaultValue?: any) => any;