tinacms 3.8.3 → 3.9.0

package/dist/internalClient/index.d.ts

@@ -2,16 +2,20 @@ import { BranchData, EventBus } from '@tinacms/toolkit';
 import { DocumentNode, GraphQLSchema } from 'graphql';
 import { TokenObject } from '../auth/authenticate';
 import { AuthProvider, Schema, TinaSchema } from '@tinacms/schema-tools';
-import { SearchClient, SearchOptions, SearchQueryResponse, IndexableDocument, FuzzySearchOptions } from '@tinacms/search/index-client';
+import { FuzzySearchOptions, IndexableDocument, SearchClient, SearchOptions, SearchQueryResponse } from '@tinacms/search/index-client';
+import gql from 'graphql-tag';
+import { EditorialWorkflowResult } from '../toolkit/form-builder/editorial-workflow-constants';
+import { TinaCloudProject } from './types';
+export * from './authProvider';
 interface TinaSearchConfig {
     stopwordLanguages?: string[];
     fuzzyEnabled?: boolean;
     fuzzyOptions?: FuzzySearchOptions;
 }
-import gql from 'graphql-tag';
-import { EditorialWorkflowResult } from '../toolkit/form-builder/editorial-workflow-constants';
-import { TinaCloudProject } from './types';
-export * from './authProvider';
+type EditorialWorkflowStatusUpdate = {
+    status: string;
+    message?: string;
+};
 export type OnLoginFunc = (args: {
     token?: TokenObject;
 }) => Promise<void>;
@@ -124,11 +128,12 @@ export declare class Client {
     getIndexStatus({ ref }: {
         ref: string;
     }): Promise<{
-        status?: "unknown" | "complete" | "failed" | "inprogress";
+        status?: "complete" | "unknown" | "failed" | "inprogress";
         timestamp?: number;
     }>;
     listBranches(args?: {
         includeIndexStatus?: boolean;
+        signal?: AbortSignal;
     }): Promise<[{
         name?: string;
         protected?: boolean;
@@ -139,7 +144,7 @@ export declare class Client {
         githubPullRequestUrl?: string;
     }[]] | {
         indexStatus: {
-            status?: "unknown" | "complete" | "failed" | "inprogress";
+            status?: "complete" | "unknown" | "failed" | "inprogress";
             timestamp?: number;
         };
         name?: string;
@@ -147,9 +152,14 @@ export declare class Client {
         githubPullRequestUrl?: string;
     }[]>;
     usingProtectedBranch(): boolean;
-    branchExists(branchName: string): Promise<boolean>;
+    branchExists(branchName: string, args?: {
+        signal?: AbortSignal;
+    }): Promise<boolean>;
     createBranch({ baseBranch, branchName }: BranchData): Promise<string>;
     getLatestVersion(): Promise<LatestVersionResponse>;
+    private pollEditorialWorkflowStatus;
+    private toEditorialWorkflowError;
+    private postEditorialWorkflow;
     /**
      * Initiate and poll for the results of an editorial workflow operation
      *
@@ -169,6 +179,18 @@ export declare class Client {
             message?: string;
         }) => void;
     }): Promise<EditorialWorkflowResult>;
+    startMediaEditorialWorkflow(options: {
+        branchName: string;
+        baseBranch: string;
+        prTitle?: string;
+        operation: 'upload' | 'delete';
+        repoPath: string;
+    }): Promise<{
+        branchName: string;
+        requestId: string;
+        status?: string;
+    }>;
+    waitForEditorialWorkflowStatus(requestId: string, onStatusUpdate?: (status: EditorialWorkflowStatusUpdate) => void): Promise<EditorialWorkflowResult>;
 }
 export declare const DEFAULT_LOCAL_TINA_GQL_SERVER_URL = "http://localhost:4001/graphql";
 export declare class LocalClient extends Client {

package/dist/toolkit/components/media/index.d.ts

@@ -3,4 +3,4 @@ export { ListMediaItem, GridMediaItem } from './media-item';
 export { Breadcrumb } from './breadcrumb';
 export { CursorPaginator } from './pagination';
 export type { MediaPaginatorProps } from './pagination';
-export { DEFAULT_MEDIA_UPLOAD_TYPES } from './utils';
+export { DEFAULT_MEDIA_UPLOAD_TYPES, sanitizeFilename } from './utils';

package/dist/toolkit/components/media/media-workflow-overlay.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare const MediaWorkflowOverlay: () => React.JSX.Element;

package/dist/toolkit/components/media/utils.d.ts

@@ -3,3 +3,11 @@ export declare const dropzoneAcceptFromString: (str: string) => any;
 export declare const isImage: (filename: string) => boolean;
 export declare const isVideo: (filename: string) => boolean;
 export declare const absoluteImgURL: (str: string) => string;
+/**
+ * Normalizes filenames to NFC and replaces characters that are unsafe for
+ * URLs or common filesystems with a hyphen, while preserving the extension.
+ *
+ * Example: `image-a\u0308.jpg` becomes `image-ä.jpg`,
+ * so URLs use `%C3%A4` instead of the decomposed `%CC%88` sequence.
+ */
+export declare const sanitizeFilename: (filename: string) => string;

package/dist/toolkit/core/event.d.ts

@@ -6,12 +6,26 @@ export interface CMSEvent {
 export declare class EventBus {
     private listeners;
     subscribe<E extends CMSEvent = CMSEvent>(event: E['type'] | E['type'][], callback: Callback<E>): () => void;
-    dispatch<E extends CMSEvent = CMSEvent>(event: E): void;
+    dispatch<E extends CMSEvent = CMSEvent>(event: E): boolean;
+    /**
+     * Whether any listener *explicitly* targets `eventType`. The catch-all `'*'`
+     * pattern does not count — callers use this to detect a purpose-built
+     * subscriber (e.g. a mounted UI overlay) without being misled by ambient
+     * `'*'` listeners such as the alerts bridge, which would otherwise make
+     * {@link dispatch} report every event as "handled".
+     */
+    hasExplicitListenerFor<E extends CMSEvent = CMSEvent>(eventType: E['type']): boolean;
 }
 export declare class Listener<E extends CMSEvent = CMSEvent> {
     private eventPattern;
     private callback;
     constructor(eventPattern: E['type'], callback: Callback<E>);
     handleEvent(event: E): boolean;
+    /**
+     * Whether this listener explicitly targets `eventType`. Unlike
+     * {@link watchesEvent}, the catch-all `'*'` pattern does NOT match, so this
+     * reflects a purpose-built subscription rather than an ambient one.
+     */
+    isExplicitListenerFor(eventType: E['type']): boolean;
     watchesEvent(currentEvent: E): boolean;
 }

package/dist/toolkit/core/media-store.default.d.ts

@@ -1,4 +1,4 @@
-import { CMS } from './cms';
+import type { TinaCMS } from '../tina-cms';
 import { Media, MediaList, MediaListOptions, MediaStore, MediaUploadOptions } from './media';
 export declare class DummyMediaStore implements MediaStore {
     accept: string;
@@ -30,14 +30,16 @@ export declare class TinaMediaStore implements MediaStore {
     private url;
     private staticMedia;
     isStatic?: boolean;
-    constructor(cms: CMS, staticMedia?: StaticMedia);
+    private workflowBranchOverride;
+    private mediaWorkflowInProgress;
+    constructor(cms: TinaCMS, staticMedia?: StaticMedia);
     setup(): void;
     isAuthenticated(): Promise<boolean>;
     accept: string;
     maxSize: number;
     /**
-     * Returns the current branch as a single-encoded query-param value, or
-     * an empty string when no branch is set.
+     * Returns the workflow branch override or current branch as a single-encoded
+     * query-param value, or an empty string when no branch is set.
      *
      * `this.api.branch` is already URL-encoded by `Client.setBranch()`, so we
      * decode then re-encode here to defend against double-encoding when this
@@ -50,7 +52,32 @@ export declare class TinaMediaStore implements MediaStore {
      * assets-api (which would route the call to a non-existent staging path).
      */
     private encodedBranchParam;
+    private shortStableHash;
+    private trimEdges;
+    private branchSlugForMediaPath;
+    /** Joins a directory and filename into a normalized `dir/file` repo path. */
+    private joinMediaPath;
+    private branchQueryParam;
+    private requestMediaBranchChoice;
+    private prepareMediaBranch;
+    private resetWorkflowState;
+    private finalizeMediaWorkflow;
+    private dispatchMediaWorkflowError;
+    private runMediaOpWithWorkflow;
+    private prepareProtectedMediaBranch;
+    private waitForRequestStatus;
     private persist_cloud;
+    /**
+     * Uploads assets through the editorial workflow. The asset is staged, the
+     * server-side workflow catalogues it in the new branch's media index, and
+     * only then do we list it — while the branch override still routes list
+     * calls to the workflow branch, so the freshly uploaded item is returned to
+     * the caller (and added to the media manager) without needing a manual
+     * refresh.
+     */
+    private persistCloudViaWorkflow;
+    private uploadCloudMediaItem;
+    private groupMediaByDirectory;
     /**
      * Resolves the just-uploaded items to canonical `Media` entries by hitting
      * the assets-api `list` endpoint, which is the source of truth for the

package/dist/toolkit/fields/plugins/mdx-field-plugin/plate/components/plate-ui/command.d.ts

@@ -6,7 +6,7 @@ export declare const Command: React.ForwardRefExoticComponent<Omit<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>> & {
     label?: string;
     shouldFilter?: boolean;
     filter?: (value: string, search: string, keywords?: string[]) => number;
@@ -22,7 +22,7 @@ export declare const Command: React.ForwardRefExoticComponent<Omit<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>> & {
     label?: string;
     shouldFilter?: boolean;
     filter?: (value: string, search: string, keywords?: string[]) => number;
@@ -58,7 +58,7 @@ export declare const InputCommand: React.ForwardRefExoticComponent<Omit<Omit<Omi
 }, "key" | keyof React.InputHTMLAttributes<HTMLInputElement> | "asChild">, "value" | "type" | "onChange"> & {
     value?: string;
     onValueChange?: (search: string) => void;
-} & React.RefAttributes<HTMLInputElement>, "h" | "variant"> & import("class-variance-authority").VariantProps<(props?: {
+} & React.RefAttributes<HTMLInputElement>, "variant" | "h"> & import("class-variance-authority").VariantProps<(props?: {
     h?: "sm" | "md";
     variant?: "default" | "ghost";
 } & import("class-variance-authority/types").ClassProp) => string>, "ref"> & React.RefAttributes<HTMLInputElement>>;
@@ -68,7 +68,7 @@ export declare const CommandList: React.ForwardRefExoticComponent<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>> & {
     label?: string;
 } & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export declare const CommandEmpty: React.ForwardRefExoticComponent<Omit<{
@@ -77,14 +77,14 @@ export declare const CommandEmpty: React.ForwardRefExoticComponent<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>> & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export declare const CommandGroup: React.ForwardRefExoticComponent<Omit<{
     children?: React.ReactNode;
 } & Omit<Pick<Pick<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "key" | keyof React.HTMLAttributes<HTMLDivElement>> & {
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "value" | "heading"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>>, "value" | "heading"> & {
     heading?: React.ReactNode;
     value?: string;
     forceMount?: boolean;
@@ -93,7 +93,7 @@ export declare const CommandSeparator: React.ForwardRefExoticComponent<Omit<Pick
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>> & {
     alwaysRender?: boolean;
 } & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 export declare const CommandItem: React.ForwardRefExoticComponent<Omit<{
@@ -102,7 +102,7 @@ export declare const CommandItem: React.ForwardRefExoticComponent<Omit<{
     ref?: React.Ref<HTMLDivElement>;
 } & {
     asChild?: boolean;
-}, "key" | keyof React.HTMLAttributes<HTMLDivElement> | "asChild">, "value" | "disabled" | "onSelect"> & {
+}, "key" | "asChild" | keyof React.HTMLAttributes<HTMLDivElement>>, "value" | "disabled" | "onSelect"> & {
     disabled?: boolean;
     onSelect?: (value: string) => void;
     value?: string;

package/dist/toolkit/fields/plugins/mdx-field-plugin/plate/components/plate-ui/heading-items.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentType, SVGProps } from 'react';
+import { type HeadingLevel } from '@tinacms/schema-tools';
+export type HeadingItemIcon = ComponentType<SVGProps<SVGSVGElement>>;
+export interface HeadingMenuItem {
+    description: string;
+    icon: HeadingItemIcon;
+    label: string;
+    value: string;
+}
+export declare const headingItemsByLevel: Record<HeadingLevel, HeadingMenuItem>;
+export declare const paragraphItem: HeadingMenuItem;
+/** Looks up the menu item for any block value. Returns `undefined`
+ * for non-heading values so callers can fall back as they see fit
+ * (e.g. to `paragraphItem` for the dropdown trigger label). */
+export declare const getHeadingItem: (value: string) => HeadingMenuItem | undefined;

package/dist/toolkit/fields/plugins/mdx-field-plugin/plate/components/plate-ui/input.d.ts

@@ -2,7 +2,7 @@ export declare const inputVariants: (props?: {
     h?: "sm" | "md";
     variant?: "default" | "ghost";
 } & import("class-variance-authority/types").ClassProp) => string;
-export declare const Input: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "h" | "variant"> & import("class-variance-authority").VariantProps<(props?: {
+export declare const Input: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & Omit<import("react").DetailedHTMLProps<import("react").InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "variant" | "h"> & import("class-variance-authority").VariantProps<(props?: {
     h?: "sm" | "md";
     variant?: "default" | "ghost";
 } & import("class-variance-authority/types").ClassProp) => string>, "ref"> & import("react").RefAttributes<HTMLInputElement>>;

package/dist/toolkit/fields/plugins/mdx-field-plugin/plate/plugins/core/autoformat/autoformat-block.d.ts

@@ -1,2 +1,4 @@
 import { AutoformatRule } from '@udecode/plate-autoformat';
+import { type HeadingLevel } from '@tinacms/schema-tools';
+export declare const getAutoformatBlocks: (headingLevels?: readonly HeadingLevel[]) => AutoformatRule[];
 export declare const autoformatBlocks: AutoformatRule[];