tinacms 3.7.5 → 3.8.0

package/dist/react.d.ts

@@ -1,3 +1,5 @@
+import { addMetadata, hashFromQuery } from '@tinacms/bridge/metadata';
+export { addMetadata, hashFromQuery };
 export declare function useTina<T extends object>(props: {
     query: string;
     variables: object;
@@ -10,32 +12,4 @@ export declare function useTina<T extends object>(props: {
 export declare function useEditState(): {
     edit: boolean;
 };
-/**
- * Grab the field name for the given attribute
- * to signal to Tina which DOM element the field
- * is working with.
- */
-/**
- * Generate a field identifier for Tina to associate DOM elements with form fields.
- * Format: "queryId---path.to.field" or "queryId---path.to.array.index"
- */
-export declare const tinaField: <T extends {
-    _content_source?: {
-        queryId: string;
-        path: (number | string)[];
-    };
-} | Record<string, unknown> | null | undefined>(object: T, property?: keyof Omit<NonNullable<T>, "__typename" | "_sys">, index?: number) => string;
-/**
- * FIX: This function is updated to be more robust. It explicitly checks for
- * `null` and `String` objects to prevent them from being processed as
- * iterable objects, which is the root cause of the "Objects are not valid
- * as a React child" error.
- */
-export declare const addMetadata: <T extends object>(id: string, obj: T, path?: (string | number)[]) => T;
-/**
- * This is a pretty rudimentary approach to hashing the query and variables to
- * ensure we treat multiple queries on the page uniquely. It's possible
- * that we would have collisions, and I'm not sure of the likeliness but seems
- * like it'd be rare.
- */
-export declare const hashFromQuery: (input: string) => string;
+export { tinaField } from './tina-field';

package/dist/react.js

@@ -1,4 +1,8 @@
+import { hashFromQuery, addMetadata } from "@tinacms/bridge/metadata";
+import { addMetadata as addMetadata2, hashFromQuery as hashFromQuery2 } from "@tinacms/bridge/metadata";
+import { QUICK_EDIT_CSS } from "@tinacms/bridge/quick-edit-css";
 import React from "react";
+import { tinaField } from "@tinacms/bridge/tina-field";
 function useTina(props) {
   const stringifiedQuery = JSON.stringify({
     query: props.query,
@@ -53,48 +57,16 @@ function useTina(props) {
             }
           }
         }
-        if (fieldName) {
-          if (isInTinaIframe) {
-            parent.postMessage(
-              { type: "field:selected", fieldName },
-              window.location.origin
-            );
-          }
+        if (fieldName && isInTinaIframe) {
+          parent.postMessage(
+            { type: "field:selected", fieldName },
+            window.location.origin
+          );
         }
       };
       const style = document.createElement("style");
       style.type = "text/css";
-      style.textContent = `
-        [data-tina-field] {
-          outline: 2px dashed rgba(34,150,254,0.5);
-          transition: box-shadow ease-out 150ms;
-        }
-        [data-tina-field]:hover {
-          box-shadow: inset 100vi 100vh rgba(34,150,254,0.3);
-          outline: 2px solid rgba(34,150,254,1);
-          cursor: pointer;
-        }
-        [data-tina-field-overlay] {
-          outline: 2px dashed rgba(34,150,254,0.5);
-          position: relative;
-        }
-        [data-tina-field-overlay]:hover {
-          cursor: pointer;
-          outline: 2px solid rgba(34,150,254,1);
-        }
-        [data-tina-field-overlay]::after {
-          content: '';
-          position: absolute;
-          inset: 0;
-          z-index: 20;
-          transition: opacity ease-out 150ms;
-          background-color: rgba(34,150,254,0.3);
-          opacity: 0;
-        }
-        [data-tina-field-overlay]:hover::after {
-          opacity: 1;
-        }
-      `;
+      style.textContent = QUICK_EDIT_CSS;
       document.head.appendChild(style);
       document.body.classList.add("__tina-quick-editing-enabled");
       document.addEventListener("click", mouseDownHandler, true);
@@ -166,88 +138,9 @@ function useEditState() {
   }, []);
   return { edit };
 }
-const tinaField = (object, property, index) => {
-  const contentSource = object == null ? void 0 : object._content_source;
-  if (!contentSource) {
-    return "";
-  }
-  const { queryId, path } = contentSource;
-  if (!property) {
-    return `${queryId}---${path.join(".")}`;
-  }
-  const fullPath = typeof index === "number" ? [...path, property, index] : [...path, property];
-  return `${queryId}---${fullPath.join(".")}`;
-};
-const addMetadata = (id, obj, path = []) => {
-  if (obj === null) {
-    return obj;
-  }
-  if (isScalarOrUndefined(obj)) {
-    return obj;
-  }
-  if (obj instanceof String) {
-    return obj.valueOf();
-  }
-  if (Array.isArray(obj)) {
-    return obj.map(
-      (item, index) => addMetadata(id, item, [...path, index])
-    );
-  }
-  const transformedObj = {};
-  for (const [key, value] of Object.entries(obj)) {
-    const currentPath = [...path, key];
-    if ([
-      "__typename",
-      "_sys",
-      "_internalSys",
-      "_values",
-      "_internalValues",
-      "_content_source",
-      "_tina_metadata"
-    ].includes(key)) {
-      transformedObj[key] = value;
-    } else {
-      transformedObj[key] = addMetadata(id, value, currentPath);
-    }
-  }
-  if (transformedObj && typeof transformedObj === "object" && "type" in transformedObj && transformedObj.type === "root") {
-    return transformedObj;
-  }
-  return { ...transformedObj, _content_source: { queryId: id, path } };
-};
-function isScalarOrUndefined(value) {
-  const type = typeof value;
-  if (type === "string")
-    return true;
-  if (type === "number")
-    return true;
-  if (type === "boolean")
-    return true;
-  if (type === "undefined")
-    return true;
-  if (value == null)
-    return true;
-  if (value instanceof String)
-    return true;
-  if (value instanceof Number)
-    return true;
-  if (value instanceof Boolean)
-    return true;
-  return false;
-}
-const hashFromQuery = (input) => {
-  let hash = 0;
-  for (let i = 0; i < input.length; i++) {
-    const char = input.charCodeAt(i);
-    hash = (hash << 5) - hash + char & 4294967295;
-  }
-  const nonNegativeHash = Math.abs(hash);
-  const alphanumericHash = nonNegativeHash.toString(36);
-  return alphanumericHash;
-};
 export {
-  addMetadata,
-  hashFromQuery,
+  addMetadata2 as addMetadata,
+  hashFromQuery2 as hashFromQuery,
   tinaField,
   useEditState,
   useTina

package/dist/tina-field.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export of the canonical `tinaField` helper from `@tinacms/bridge`.
+ * Kept here so `tinacms/tina-field` consumers don't need to switch imports.
+ */
+export { tinaField } from '@tinacms/bridge/tina-field';

package/dist/tina-field.js

@@ -0,0 +1,4 @@
+import { tinaField } from "@tinacms/bridge/tina-field";
+export {
+  tinaField
+};

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

@@ -1,5 +1,5 @@
-import { Media, MediaStore, MediaUploadOptions, MediaList, MediaListOptions } from './media';
 import { CMS } from './cms';
+import { Media, MediaList, MediaListOptions, MediaStore, MediaUploadOptions } from './media';
 export declare class DummyMediaStore implements MediaStore {
     accept: string;
     persist(files: MediaUploadOptions[]): Promise<Media[]>;
@@ -35,7 +35,35 @@ export declare class TinaMediaStore implements MediaStore {
     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.
+     *
+     * `this.api.branch` is already URL-encoded by `Client.setBranch()`, so we
+     * decode then re-encode here to defend against double-encoding when this
+     * value is concatenated into a URL.
+     *
+     * `Client.setBranch()` runs the constructor's `options.branch` through
+     * `encodeURIComponent` without a guard, so an unset `options.branch`
+     * lands here as the literal string `"undefined"`. We treat that and the
+     * empty case as no-branch so we don't send `?branch=undefined` to the
+     * assets-api (which would route the call to a non-existent staging path).
+     */
+    private encodedBranchParam;
     private persist_cloud;
+    /**
+     * Resolves the just-uploaded items to canonical `Media` entries by hitting
+     * the assets-api `list` endpoint, which is the source of truth for the
+     * `src` URL — including the staging-branch path
+     * (`__staging/<branch>/__file/...`) and the per-stage CDN host.
+     * Constructing those URLs on the client would mirror server-side branch
+     * routing and CDN-host logic, which is fragile to keep in sync.
+     *
+     * Best-effort: items not found within the first page of their directory
+     * (e.g. very large directories) are omitted from the result rather than
+     * throwing — the upload itself already succeeded.
+     */
+    private fetchUploadedEntries;
     private persist_local;
     persist(media: MediaUploadOptions[]): Promise<Media[]>;
     private genThumbnail;

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

@@ -65,6 +65,14 @@ export interface MediaStore {
      * Lists all media in a specific directory.
      */
     list(options?: MediaListOptions): Promise<MediaList>;
+    /**
+     * Reserved hook for renaming a media object in the store.
+     *
+     * Not yet implemented in `TinaMediaStore` or surfaced in `MediaManager` —
+     * declared here as an extension point so stores can begin to opt in once
+     * the corresponding assets-api endpoint is built.
+     */
+    rename?(from: string, to: string): Promise<Media>;
     /**
      * Indicates that uploads and deletions are not supported
      *

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

@@ -5,6 +5,11 @@ import { CodeLeaf } from '../../components/plate-ui/code-leaf';
 import { CodeSyntaxLeaf } from '../../components/plate-ui/code-syntax-leaf';
 import { HrElement } from '../../components/plate-ui/hr-element';
 import { LinkElement } from '../../components/plate-ui/link-element';
+type HeadingComponentProps = {
+    attributes: React.HTMLAttributes<HTMLHeadingElement>;
+    children: React.ReactNode;
+    className?: string;
+};
 export declare const Components: () => {
     [CodeLinePlugin.key]: React.ForwardRefExoticComponent<Omit<Omit<import("@udecode/plate/react").PlateElementProps<import("@udecode/plate").TElement, import("@udecode/plate").AnyPluginConfig>, keyof {
         className?: string;
@@ -34,49 +39,12 @@ export declare const Components: () => {
         className?: string;
         style?: React.CSSProperties;
     }, "ref"> & React.RefAttributes<never>>;
-    h1: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
-    h2: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
-    h3: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
-    h4: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
-    /** Tailwind prose doesn't style h5 and h6 elements */
-    h5: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
-    h6: ({ attributes, editor, element, className, ...props }: {
-        [x: string]: any;
-        attributes: any;
-        editor: any;
-        element: any;
-        className: any;
-    }) => React.JSX.Element;
+    h1: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
+    h2: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
+    h3: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
+    h4: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
+    h5: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
+    h6: ({ attributes, children, className, }: HeadingComponentProps) => React.JSX.Element;
     p: React.ForwardRefExoticComponent<Omit<Omit<import("@udecode/plate/react").PlateElementProps<import("@udecode/plate").TElement, import("@udecode/plate").AnyPluginConfig>, keyof {
         className?: string;
         style?: React.CSSProperties;
@@ -327,3 +295,4 @@ export declare const Components: () => {
         style?: React.CSSProperties;
     }, "ref"> & React.RefAttributes<never>>;
 };
+export {};

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

@@ -35,7 +35,8 @@ interface RepositoryProviderProps {
     };
 }
 export declare const FileHistoryProvider: ({ contentRelativePath, tinaBranch, defaultBranchName, historyUrl, isLocalMode, }: RepositoryProviderProps) => React.JSX.Element;
-export declare const FormBreadcrumbs: ({ rootBreadcrumbName, ...props }: {
+export declare const FormBreadcrumbs: ({ rootBreadcrumbName, contentPath, ...props }: {
     rootBreadcrumbName?: string;
+    contentPath?: string;
 } & React.HTMLAttributes<HTMLDivElement>) => React.JSX.Element;
 export {};

package/package.json

@@ -2,7 +2,7 @@
   "name": "tinacms",
   "type": "module",
   "typings": "dist/index.d.ts",
-  "version": "3.7.5",
+  "version": "3.8.0",
   "main": "dist/index.js",
   "module": "./dist/index.js",
   "exports": {
@@ -10,6 +10,8 @@
     "./dist/client": "./dist/client.js",
     "./react": "./dist/react.js",
     "./dist/react": "./dist/react.js",
+    "./tina-field": "./dist/tina-field.js",
+    "./dist/tina-field": "./dist/tina-field.js",
     "./dist/rich-text": "./dist/rich-text/index.js",
     "./dist/rich-text/static": "./dist/rich-text/static.js",
     "./dist/rich-text/prism": "./dist/rich-text/prism.js"
@@ -24,6 +26,7 @@
       "src/rich-text/static.tsx",
       "src/rich-text/prism.tsx",
       "src/react.tsx",
+      "src/tina-field.ts",
       {
         "name": "src/client.ts",
         "target": "node"
@@ -114,9 +117,10 @@
     "webfontloader": "1.6.28",
     "yup": "^1.6.1",
     "zod": "^3.24.2",
-    "@tinacms/mdx": "2.1.3",
-    "@tinacms/schema-tools": "2.7.3",
-    "@tinacms/search": "1.2.12"
+    "@tinacms/bridge": "0.2.0",
+    "@tinacms/schema-tools": "2.7.4",
+    "@tinacms/mdx": "2.1.4",
+    "@tinacms/search": "1.2.14"
   },
   "devDependencies": {
     "@graphql-tools/utils": "^10.8.1",
@@ -144,7 +148,7 @@
     "typescript": "^5.7.3",
     "vite": "^5.4.14",
     "vitest": "^2.1.9",
-    "@tinacms/scripts": "1.6.0"
+    "@tinacms/scripts": "1.6.1"
   },
   "peerDependencies": {
     "react": ">=16.14.0",