@10x-media/undo-redo 0.1.0-beta.0

package/dist/plugin/options.d.ts

@@ -0,0 +1,109 @@
+import { TranslationsOption } from "../translations/index.js";
+import { Field } from "payload";
+
+//#region src/plugin/options.d.ts
+/**
+ * Option shape and resolution. Kept free of Payload config plumbing so the
+ * precedence rules are testable on their own: they are the part a host is most
+ * likely to be surprised by.
+ */
+/** One or more `react-hotkeys-hook` chords, e.g. `'mod+z'` or `['mod+y', 'mod+shift+z']`. */
+type ShortcutKeys = string | string[];
+/**
+ * Settings a single collection or global can override.
+ *
+ * Declared as a type alias rather than an interface so it satisfies
+ * `Record<string, unknown>`, which `definePlugin` constrains its options to.
+ */
+type UndoRedoDocOptions = {
+  /** Mount the history inspector overlay behind an extra toolbar button. */debug?: boolean; /** Entries kept before the oldest is dropped. Defaults to 50. */
+  maxHistory?: number;
+  /**
+   * Milliseconds of quiet before edits are captured as one entry. Raise it to
+   * coalesce more typing into a single undo step, lower it for finer steps.
+   */
+  captureDebounce?: number;
+  /**
+   * Append the controls to the document controls automatically. Turn it off to
+   * place `<UndoRedoControls />` yourself in another admin slot.
+   */
+  autoMount?: boolean;
+  /**
+   * Form-state paths to leave out of the history, as patterns where `*` matches
+   * one path segment: `slug`, `list.*.readingTime`. A pattern also covers
+   * everything below it. Merged with, never replacing, the fields Payload owns.
+   *
+   * Use this for fields you cannot edit the definition of; for your own fields
+   * prefer `admin.custom` on the field itself, which survives renames.
+   */
+  ignorePaths?: string[]; /** Field types to leave out of the history wherever they appear. */
+  ignoreFieldTypes?: Field['type'][];
+};
+type UndoRedoPluginOptions = UndoRedoDocOptions & {
+  /** Disable the plugin entirely (incoming config returned untouched). */disabled?: boolean;
+  /**
+   * Keyboard chords, in `react-hotkeys-hook` syntax. `mod` resolves to Cmd on
+   * macOS and Ctrl elsewhere. Set to `false` to drop keyboard handling and keep
+   * the buttons.
+   *
+   * Deliberately global: shortcuts that change between collections are a way to
+   * confuse editors, not a feature.
+   */
+  shortcuts?: false | {
+    undo?: ShortcutKeys;
+    redo?: ShortcutKeys;
+  };
+  /**
+   * Per-collection settings. Undo/redo is on everywhere by default, so this is
+   * an opt-*out* map: `false` disables a collection, an object overrides the
+   * top-level settings for it. `collections: false` disables all of them.
+   */
+  collections?: false | Record<string, false | UndoRedoDocOptions>; /** Per-global settings, same shape as `collections`. */
+  globals?: false | Record<string, false | UndoRedoDocOptions>;
+  /**
+   * Per-locale overrides for this plugin's UI strings, keyed by the typed
+   * translation keys exported from `@10x-media/undo-redo/i18n`. Values win over
+   * the built-in locales key-by-key; locales the plugin does not ship are added
+   * whole. App-level `i18n.translations` still wins over both.
+   */
+  translations?: TranslationsOption;
+};
+declare const DEFAULT_CAPTURE_DEBOUNCE_MS = 400;
+declare const DEFAULT_SHORTCUTS: {
+  readonly undo: readonly ["mod+z"];
+  readonly redo: readonly ["mod+shift+z", "mod+y"];
+};
+/** Fully resolved settings for one collection or global. */
+interface ResolvedDocOptions {
+  autoMount: boolean;
+  debug: boolean;
+  maxHistory: number;
+  captureDebounce: number;
+  ignorePaths: string[];
+  ignoreFieldTypes: string[];
+  shortcuts: false | {
+    undo: string[];
+    redo: string[];
+  };
+}
+/** The subset the client component needs, and all of it JSON-serializable. */
+type ControlsClientProps = Omit<ResolvedDocOptions, 'autoMount'>;
+type DocScope = 'collections' | 'globals';
+/**
+ * Resolve the settings for one document type, or `null` when undo/redo is off
+ * for it.
+ *
+ * Precedence is plugin defaults, then top-level options, then the per-slug
+ * entry. `ignorePaths` and `ignoreFieldTypes` merge across those layers instead
+ * of replacing: a collection adding one path should not silently drop the ones
+ * declared globally, nor the fields Payload owns.
+ */
+declare const resolveDocOptions: (options: UndoRedoPluginOptions, scope: DocScope, slug: string) => ResolvedDocOptions | null;
+/** Strip the settings only the config layer uses, leaving the client's props. */
+declare const toClientProps: ({
+  autoMount: _autoMount,
+  ...clientProps
+}: ResolvedDocOptions) => ControlsClientProps;
+//#endregion
+export { ControlsClientProps, DEFAULT_CAPTURE_DEBOUNCE_MS, DEFAULT_SHORTCUTS, DocScope, ResolvedDocOptions, ShortcutKeys, UndoRedoDocOptions, UndoRedoPluginOptions, resolveDocOptions, toClientProps };
+//# sourceMappingURL=options.d.ts.map

package/dist/plugin/options.js

@@ -0,0 +1,52 @@
+import { DEFAULT_IGNORED_PATHS } from "../history/historyCore.js";
+//#region src/plugin/options.ts
+const DEFAULT_CAPTURE_DEBOUNCE_MS = 400;
+const DEFAULT_SHORTCUTS = {
+	undo: ["mod+z"],
+	redo: ["mod+shift+z", "mod+y"]
+};
+const toArray = (keys, fallback) => keys === void 0 ? [...fallback] : Array.isArray(keys) ? [...keys] : [keys];
+const resolveShortcuts = (options) => {
+	if (options.shortcuts === false) return false;
+	return {
+		undo: toArray(options.shortcuts?.undo, DEFAULT_SHORTCUTS.undo),
+		redo: toArray(options.shortcuts?.redo, DEFAULT_SHORTCUTS.redo)
+	};
+};
+/**
+* Resolve the settings for one document type, or `null` when undo/redo is off
+* for it.
+*
+* Precedence is plugin defaults, then top-level options, then the per-slug
+* entry. `ignorePaths` and `ignoreFieldTypes` merge across those layers instead
+* of replacing: a collection adding one path should not silently drop the ones
+* declared globally, nor the fields Payload owns.
+*/
+const resolveDocOptions = (options, scope, slug) => {
+	const scoped = options[scope];
+	if (scoped === false) return null;
+	const entry = scoped?.[slug];
+	if (entry === false) return null;
+	const layers = entry ? [options, entry] : [options];
+	const pick = (key) => {
+		for (let i = layers.length - 1; i >= 0; i--) {
+			const value = layers[i]?.[key];
+			if (value !== void 0) return value;
+		}
+	};
+	return {
+		autoMount: pick("autoMount") ?? true,
+		debug: pick("debug") === true,
+		maxHistory: pick("maxHistory") ?? 50,
+		captureDebounce: pick("captureDebounce") ?? 400,
+		ignorePaths: [...new Set([...DEFAULT_IGNORED_PATHS, ...layers.flatMap((layer) => layer.ignorePaths ?? [])])],
+		ignoreFieldTypes: [...new Set(layers.flatMap((layer) => layer.ignoreFieldTypes ?? []))],
+		shortcuts: resolveShortcuts(options)
+	};
+};
+/** Strip the settings only the config layer uses, leaving the client's props. */
+const toClientProps = ({ autoMount: _autoMount, ...clientProps }) => clientProps;
+//#endregion
+export { DEFAULT_CAPTURE_DEBOUNCE_MS, DEFAULT_SHORTCUTS, resolveDocOptions, toClientProps };
+
+//# sourceMappingURL=options.js.map

package/dist/plugin/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","names":[],"sources":["../../src/plugin/options.ts"],"sourcesContent":["import type { Field } from 'payload'\n\nimport { DEFAULT_IGNORED_PATHS, MAX_HISTORY_ENTRIES } from '../history/historyCore'\nimport type { TranslationsOption } from '../translations'\n\n/**\n * Option shape and resolution. Kept free of Payload config plumbing so the\n * precedence rules are testable on their own: they are the part a host is most\n * likely to be surprised by.\n */\n\n/** One or more `react-hotkeys-hook` chords, e.g. `'mod+z'` or `['mod+y', 'mod+shift+z']`. */\nexport type ShortcutKeys = string | string[]\n\n/**\n * Settings a single collection or global can override.\n *\n * Declared as a type alias rather than an interface so it satisfies\n * `Record<string, unknown>`, which `definePlugin` constrains its options to.\n */\nexport type UndoRedoDocOptions = {\n\t/** Mount the history inspector overlay behind an extra toolbar button. */\n\tdebug?: boolean\n\t/** Entries kept before the oldest is dropped. Defaults to 50. */\n\tmaxHistory?: number\n\t/**\n\t * Milliseconds of quiet before edits are captured as one entry. Raise it to\n\t * coalesce more typing into a single undo step, lower it for finer steps.\n\t */\n\tcaptureDebounce?: number\n\t/**\n\t * Append the controls to the document controls automatically. Turn it off to\n\t * place `<UndoRedoControls />` yourself in another admin slot.\n\t */\n\tautoMount?: boolean\n\t/**\n\t * Form-state paths to leave out of the history, as patterns where `*` matches\n\t * one path segment: `slug`, `list.*.readingTime`. A pattern also covers\n\t * everything below it. Merged with, never replacing, the fields Payload owns.\n\t *\n\t * Use this for fields you cannot edit the definition of; for your own fields\n\t * prefer `admin.custom` on the field itself, which survives renames.\n\t */\n\tignorePaths?: string[]\n\t/** Field types to leave out of the history wherever they appear. */\n\tignoreFieldTypes?: Field['type'][]\n}\n\nexport type UndoRedoPluginOptions = UndoRedoDocOptions & {\n\t/** Disable the plugin entirely (incoming config returned untouched). */\n\tdisabled?: boolean\n\t/**\n\t * Keyboard chords, in `react-hotkeys-hook` syntax. `mod` resolves to Cmd on\n\t * macOS and Ctrl elsewhere. Set to `false` to drop keyboard handling and keep\n\t * the buttons.\n\t *\n\t * Deliberately global: shortcuts that change between collections are a way to\n\t * confuse editors, not a feature.\n\t */\n\tshortcuts?: false | { undo?: ShortcutKeys; redo?: ShortcutKeys }\n\t/**\n\t * Per-collection settings. Undo/redo is on everywhere by default, so this is\n\t * an opt-*out* map: `false` disables a collection, an object overrides the\n\t * top-level settings for it. `collections: false` disables all of them.\n\t */\n\tcollections?: false | Record<string, false | UndoRedoDocOptions>\n\t/** Per-global settings, same shape as `collections`. */\n\tglobals?: false | Record<string, false | UndoRedoDocOptions>\n\t/**\n\t * Per-locale overrides for this plugin's UI strings, keyed by the typed\n\t * translation keys exported from `@10x-media/undo-redo/i18n`. Values win over\n\t * the built-in locales key-by-key; locales the plugin does not ship are added\n\t * whole. App-level `i18n.translations` still wins over both.\n\t */\n\ttranslations?: TranslationsOption\n}\n\nexport const DEFAULT_CAPTURE_DEBOUNCE_MS = 400\n\nexport const DEFAULT_SHORTCUTS = {\n\tundo: ['mod+z'],\n\tredo: ['mod+shift+z', 'mod+y'],\n} as const\n\n/** Fully resolved settings for one collection or global. */\nexport interface ResolvedDocOptions {\n\tautoMount: boolean\n\tdebug: boolean\n\tmaxHistory: number\n\tcaptureDebounce: number\n\tignorePaths: string[]\n\tignoreFieldTypes: string[]\n\tshortcuts: false | { undo: string[]; redo: string[] }\n}\n\n/** The subset the client component needs, and all of it JSON-serializable. */\nexport type ControlsClientProps = Omit<ResolvedDocOptions, 'autoMount'>\n\nconst toArray = (keys: ShortcutKeys | undefined, fallback: readonly string[]): string[] =>\n\tkeys === undefined ? [...fallback] : Array.isArray(keys) ? [...keys] : [keys]\n\nconst resolveShortcuts = (options: UndoRedoPluginOptions): ResolvedDocOptions['shortcuts'] => {\n\tif (options.shortcuts === false) return false\n\treturn {\n\t\tundo: toArray(options.shortcuts?.undo, DEFAULT_SHORTCUTS.undo),\n\t\tredo: toArray(options.shortcuts?.redo, DEFAULT_SHORTCUTS.redo),\n\t}\n}\n\nexport type DocScope = 'collections' | 'globals'\n\n/**\n * Resolve the settings for one document type, or `null` when undo/redo is off\n * for it.\n *\n * Precedence is plugin defaults, then top-level options, then the per-slug\n * entry. `ignorePaths` and `ignoreFieldTypes` merge across those layers instead\n * of replacing: a collection adding one path should not silently drop the ones\n * declared globally, nor the fields Payload owns.\n */\nexport const resolveDocOptions = (\n\toptions: UndoRedoPluginOptions,\n\tscope: DocScope,\n\tslug: string\n): ResolvedDocOptions | null => {\n\tconst scoped = options[scope]\n\tif (scoped === false) return null\n\tconst entry = scoped?.[slug]\n\tif (entry === false) return null\n\n\tconst layers: UndoRedoDocOptions[] = entry ? [options, entry] : [options]\n\tconst pick = <K extends keyof UndoRedoDocOptions>(key: K): UndoRedoDocOptions[K] | undefined => {\n\t\tfor (let i = layers.length - 1; i >= 0; i--) {\n\t\t\tconst value = layers[i]?.[key]\n\t\t\tif (value !== undefined) return value\n\t\t}\n\t\treturn undefined\n\t}\n\n\treturn {\n\t\tautoMount: pick('autoMount') ?? true,\n\t\tdebug: pick('debug') === true,\n\t\tmaxHistory: pick('maxHistory') ?? MAX_HISTORY_ENTRIES,\n\t\tcaptureDebounce: pick('captureDebounce') ?? DEFAULT_CAPTURE_DEBOUNCE_MS,\n\t\tignorePaths: [\n\t\t\t...new Set([...DEFAULT_IGNORED_PATHS, ...layers.flatMap((layer) => layer.ignorePaths ?? [])]),\n\t\t],\n\t\tignoreFieldTypes: [...new Set(layers.flatMap((layer) => layer.ignoreFieldTypes ?? []))],\n\t\tshortcuts: resolveShortcuts(options),\n\t}\n}\n\n/** Strip the settings only the config layer uses, leaving the client's props. */\nexport const toClientProps = ({\n\tautoMount: _autoMount,\n\t...clientProps\n}: ResolvedDocOptions): ControlsClientProps => clientProps\n"],"mappings":";;AA6EA,MAAa,8BAA8B;AAE3C,MAAa,oBAAoB;CAChC,MAAM,CAAC,OAAO;CACd,MAAM,CAAC,eAAe,OAAO;AAC9B;AAgBA,MAAM,WAAW,MAAgC,aAChD,SAAS,KAAA,IAAY,CAAC,GAAG,QAAQ,IAAI,MAAM,QAAQ,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI;AAE7E,MAAM,oBAAoB,YAAoE;CAC7F,IAAI,QAAQ,cAAc,OAAO,OAAO;CACxC,OAAO;EACN,MAAM,QAAQ,QAAQ,WAAW,MAAM,kBAAkB,IAAI;EAC7D,MAAM,QAAQ,QAAQ,WAAW,MAAM,kBAAkB,IAAI;CAC9D;AACD;;;;;;;;;;AAaA,MAAa,qBACZ,SACA,OACA,SAC+B;CAC/B,MAAM,SAAS,QAAQ;CACvB,IAAI,WAAW,OAAO,OAAO;CAC7B,MAAM,QAAQ,SAAS;CACvB,IAAI,UAAU,OAAO,OAAO;CAE5B,MAAM,SAA+B,QAAQ,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO;CACxE,MAAM,QAA4C,QAA8C;EAC/F,KAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;GAC5C,MAAM,QAAQ,OAAO,KAAK;GAC1B,IAAI,UAAU,KAAA,GAAW,OAAO;EACjC;CAED;CAEA,OAAO;EACN,WAAW,KAAK,WAAW,KAAK;EAChC,OAAO,KAAK,OAAO,MAAM;EACzB,YAAY,KAAK,YAAY,KAAA;EAC7B,iBAAiB,KAAK,iBAAiB,KAAA;EACvC,aAAa,CACZ,GAAG,IAAI,IAAI,CAAC,GAAG,uBAAuB,GAAG,OAAO,SAAS,UAAU,MAAM,eAAe,CAAC,CAAC,CAAC,CAAC,CAC7F;EACA,kBAAkB,CAAC,GAAG,IAAI,IAAI,OAAO,SAAS,UAAU,MAAM,oBAAoB,CAAC,CAAC,CAAC,CAAC;EACtF,WAAW,iBAAiB,OAAO;CACpC;AACD;;AAGA,MAAa,iBAAiB,EAC7B,WAAW,YACX,GAAG,kBAC2C"}

package/dist/plugin/registerTranslations.js

@@ -0,0 +1,19 @@
+import { toNested, translations } from "../translations/index.js";
+import { deepMergeSimple } from "payload/shared";
+//#region src/plugin/registerTranslations.ts
+/**
+* Merge this plugin's translations into the host config. Plugin-level
+* `overrides` win over the built-ins key-by-key and may add locales the plugin
+* does not ship. A host value wins over both (`deepMergeSimple` lets the second
+* argument override), so projects can override any string.
+*/
+const registerTranslations = (config, overrides) => {
+	const nested = {};
+	for (const [locale, flat] of Object.entries(overrides ?? {})) nested[locale] = toNested(flat);
+	config.i18n ??= {};
+	config.i18n.translations = deepMergeSimple(deepMergeSimple(translations, nested), config.i18n.translations ?? {});
+};
+//#endregion
+export { registerTranslations };
+
+//# sourceMappingURL=registerTranslations.js.map

package/dist/plugin/registerTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTranslations.js","names":[],"sources":["../../src/plugin/registerTranslations.ts"],"sourcesContent":["import type { Config } from 'payload'\nimport { deepMergeSimple } from 'payload/shared'\n\nimport { type TranslationsOption, toNested, translations } from '../translations'\n\ntype Translations = NonNullable<NonNullable<Config['i18n']>['translations']>\n\n/**\n * Merge this plugin's translations into the host config. Plugin-level\n * `overrides` win over the built-ins key-by-key and may add locales the plugin\n * does not ship. A host value wins over both (`deepMergeSimple` lets the second\n * argument override), so projects can override any string.\n */\nexport const registerTranslations = (config: Config, overrides?: TranslationsOption): void => {\n\tconst nested: Record<string, Record<string, Record<string, string>>> = {}\n\tfor (const [locale, flat] of Object.entries(overrides ?? {})) {\n\t\tnested[locale] = toNested(flat)\n\t}\n\tconfig.i18n ??= {}\n\tconfig.i18n.translations = deepMergeSimple<Translations>(\n\t\tdeepMergeSimple(translations, nested),\n\t\tconfig.i18n.translations ?? {}\n\t)\n}\n"],"mappings":";;;;;;;;;AAaA,MAAa,wBAAwB,QAAgB,cAAyC;CAC7F,MAAM,SAAiE,CAAC;CACxE,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,aAAa,CAAC,CAAC,GAC1D,OAAO,UAAU,SAAS,IAAI;CAE/B,OAAO,SAAS,CAAC;CACjB,OAAO,KAAK,eAAe,gBAC1B,gBAAgB,cAAc,MAAM,GACpC,OAAO,KAAK,gBAAgB,CAAC,CAC9B;AACD"}

package/dist/plugin/withUndoRedo.d.ts

@@ -0,0 +1,34 @@
+import { ResolvedDocOptions } from "./options.js";
+import { CollectionConfig, GlobalConfig, PayloadComponent } from "payload";
+
+//#region src/plugin/withUndoRedo.d.ts
+/** Client component path resolved through the package export map by the import map. */
+declare const UNDO_REDO_COMPONENT_PATH = "@10x-media/undo-redo/client#UndoRedoControls";
+/**
+ * The component entry to append to a `beforeDocumentControls` slot, carrying
+ * the resolved settings as client props.
+ *
+ * The settings travel as props rather than being re-derived on the client so
+ * there is a single resolution path: whatever the config says is what the
+ * mounted controls use, and the debug overlay shows exactly that.
+ */
+declare const undoRedoComponent: (options: ResolvedDocOptions) => PayloadComponent<never, never>;
+/**
+ * Add the undo/redo controls to a collection's edit view by appending to
+ * `admin.components.edit.beforeDocumentControls`, preserving any components
+ * the config already declares.
+ *
+ * A `null` options object means undo/redo is off for this collection, and
+ * `autoMount: false` means the host mounts the controls itself; both return the
+ * config untouched.
+ */
+declare const withUndoRedo: (config: CollectionConfig, options: ResolvedDocOptions | null) => CollectionConfig;
+/**
+ * Global variant: globals declare the same slot under
+ * `admin.components.elements.beforeDocumentControls` (see
+ * @payloadcms/next renderDocumentSlots).
+ */
+declare const withUndoRedoGlobal: (config: GlobalConfig, options: ResolvedDocOptions | null) => GlobalConfig;
+//#endregion
+export { UNDO_REDO_COMPONENT_PATH, undoRedoComponent, withUndoRedo, withUndoRedoGlobal };
+//# sourceMappingURL=withUndoRedo.d.ts.map

package/dist/plugin/withUndoRedo.js

@@ -0,0 +1,72 @@
+import { toClientProps } from "./options.js";
+//#region src/plugin/withUndoRedo.ts
+/** Client component path resolved through the package export map by the import map. */
+const UNDO_REDO_COMPONENT_PATH = "@10x-media/undo-redo/client#UndoRedoControls";
+/**
+* The component entry to append to a `beforeDocumentControls` slot, carrying
+* the resolved settings as client props.
+*
+* The settings travel as props rather than being re-derived on the client so
+* there is a single resolution path: whatever the config says is what the
+* mounted controls use, and the debug overlay shows exactly that.
+*/
+const undoRedoComponent = (options) => ({
+	path: UNDO_REDO_COMPONENT_PATH,
+	clientProps: toClientProps(options)
+});
+/**
+* Add the undo/redo controls to a collection's edit view by appending to
+* `admin.components.edit.beforeDocumentControls`, preserving any components
+* the config already declares.
+*
+* A `null` options object means undo/redo is off for this collection, and
+* `autoMount: false` means the host mounts the controls itself; both return the
+* config untouched.
+*/
+const withUndoRedo = (config, options) => {
+	if (!options?.autoMount) return config;
+	const admin = config.admin ?? {};
+	const components = admin.components ?? {};
+	const edit = components.edit ?? {};
+	return {
+		...config,
+		admin: {
+			...admin,
+			components: {
+				...components,
+				edit: {
+					...edit,
+					beforeDocumentControls: [...edit.beforeDocumentControls ?? [], undoRedoComponent(options)]
+				}
+			}
+		}
+	};
+};
+/**
+* Global variant: globals declare the same slot under
+* `admin.components.elements.beforeDocumentControls` (see
+* @payloadcms/next renderDocumentSlots).
+*/
+const withUndoRedoGlobal = (config, options) => {
+	if (!options?.autoMount) return config;
+	const admin = config.admin ?? {};
+	const components = admin.components ?? {};
+	const elements = components.elements ?? {};
+	return {
+		...config,
+		admin: {
+			...admin,
+			components: {
+				...components,
+				elements: {
+					...elements,
+					beforeDocumentControls: [...elements.beforeDocumentControls ?? [], undoRedoComponent(options)]
+				}
+			}
+		}
+	};
+};
+//#endregion
+export { UNDO_REDO_COMPONENT_PATH, undoRedoComponent, withUndoRedo, withUndoRedoGlobal };
+
+//# sourceMappingURL=withUndoRedo.js.map

package/dist/plugin/withUndoRedo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withUndoRedo.js","names":[],"sources":["../../src/plugin/withUndoRedo.ts"],"sourcesContent":["import type { CollectionConfig, GlobalConfig, PayloadComponent } from 'payload'\n\nimport { type ResolvedDocOptions, toClientProps } from './options'\n\n/** Client component path resolved through the package export map by the import map. */\nexport const UNDO_REDO_COMPONENT_PATH = '@10x-media/undo-redo/client#UndoRedoControls'\n\n/**\n * The component entry to append to a `beforeDocumentControls` slot, carrying\n * the resolved settings as client props.\n *\n * The settings travel as props rather than being re-derived on the client so\n * there is a single resolution path: whatever the config says is what the\n * mounted controls use, and the debug overlay shows exactly that.\n */\nexport const undoRedoComponent = (options: ResolvedDocOptions): PayloadComponent<never, never> => ({\n\tpath: UNDO_REDO_COMPONENT_PATH,\n\tclientProps: toClientProps(options),\n})\n\n/**\n * Add the undo/redo controls to a collection's edit view by appending to\n * `admin.components.edit.beforeDocumentControls`, preserving any components\n * the config already declares.\n *\n * A `null` options object means undo/redo is off for this collection, and\n * `autoMount: false` means the host mounts the controls itself; both return the\n * config untouched.\n */\nexport const withUndoRedo = (\n\tconfig: CollectionConfig,\n\toptions: ResolvedDocOptions | null\n): CollectionConfig => {\n\tif (!options?.autoMount) return config\n\tconst admin = config.admin ?? {}\n\tconst components = admin.components ?? {}\n\tconst edit = components.edit ?? {}\n\treturn {\n\t\t...config,\n\t\tadmin: {\n\t\t\t...admin,\n\t\t\tcomponents: {\n\t\t\t\t...components,\n\t\t\t\tedit: {\n\t\t\t\t\t...edit,\n\t\t\t\t\tbeforeDocumentControls: [\n\t\t\t\t\t\t...(edit.beforeDocumentControls ?? []),\n\t\t\t\t\t\tundoRedoComponent(options),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t}\n}\n\n/**\n * Global variant: globals declare the same slot under\n * `admin.components.elements.beforeDocumentControls` (see\n * @payloadcms/next renderDocumentSlots).\n */\nexport const withUndoRedoGlobal = (\n\tconfig: GlobalConfig,\n\toptions: ResolvedDocOptions | null\n): GlobalConfig => {\n\tif (!options?.autoMount) return config\n\tconst admin = config.admin ?? {}\n\tconst components = admin.components ?? {}\n\tconst elements = components.elements ?? {}\n\treturn {\n\t\t...config,\n\t\tadmin: {\n\t\t\t...admin,\n\t\t\tcomponents: {\n\t\t\t\t...components,\n\t\t\t\telements: {\n\t\t\t\t\t...elements,\n\t\t\t\t\tbeforeDocumentControls: [\n\t\t\t\t\t\t...(elements.beforeDocumentControls ?? []),\n\t\t\t\t\t\tundoRedoComponent(options),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t}\n}\n"],"mappings":";;;AAKA,MAAa,2BAA2B;;;;;;;;;AAUxC,MAAa,qBAAqB,aAAiE;CAClG,MAAM;CACN,aAAa,cAAc,OAAO;AACnC;;;;;;;;;;AAWA,MAAa,gBACZ,QACA,YACsB;CACtB,IAAI,CAAC,SAAS,WAAW,OAAO;CAChC,MAAM,QAAQ,OAAO,SAAS,CAAC;CAC/B,MAAM,aAAa,MAAM,cAAc,CAAC;CACxC,MAAM,OAAO,WAAW,QAAQ,CAAC;CACjC,OAAO;EACN,GAAG;EACH,OAAO;GACN,GAAG;GACH,YAAY;IACX,GAAG;IACH,MAAM;KACL,GAAG;KACH,wBAAwB,CACvB,GAAI,KAAK,0BAA0B,CAAC,GACpC,kBAAkB,OAAO,CAC1B;IACD;GACD;EACD;CACD;AACD;;;;;;AAOA,MAAa,sBACZ,QACA,YACkB;CAClB,IAAI,CAAC,SAAS,WAAW,OAAO;CAChC,MAAM,QAAQ,OAAO,SAAS,CAAC;CAC/B,MAAM,aAAa,MAAM,cAAc,CAAC;CACxC,MAAM,WAAW,WAAW,YAAY,CAAC;CACzC,OAAO;EACN,GAAG;EACH,OAAO;GACN,GAAG;GACH,YAAY;IACX,GAAG;IACH,UAAU;KACT,GAAG;KACH,wBAAwB,CACvB,GAAI,SAAS,0BAA0B,CAAC,GACxC,kBAAkB,OAAO,CAC1B;IACD;GACD;EACD;CACD;AACD"}

package/dist/schema/fieldConfig.d.ts

@@ -0,0 +1,36 @@
+//#region src/schema/fieldConfig.d.ts
+/**
+ * Per-field opt-out, declared next to the field it applies to.
+ *
+ * It has to live under `admin.custom` rather than the field's own `custom`:
+ * Payload strips `custom` from the client config (it is listed in
+ * `serverOnlyFieldProperties`, see payload/src/fields/config/client.ts), while
+ * `admin.custom` is documented as available on both sides and survives. The
+ * controls run on the client, so `admin.custom` is the only channel that
+ * reaches them.
+ */
+/** Namespace this plugin claims inside the shared `admin.custom` object. */
+declare const UNDO_REDO_FIELD_KEY = "undoRedo";
+interface UndoRedoFieldConfig {
+  /**
+   * Leave this field out of the undo history entirely: its changes create no
+   * entries and undo never writes to it. Applies to the whole subtree when set
+   * on anything with children: a group, array, blocks field, tabs field, an
+   * individual tab, a row or a collapsible.
+   */
+  disabled?: boolean;
+}
+/**
+ * Build the `admin.custom` fragment for a field.
+ *
+ * ```ts
+ * { name: 'content', type: 'richText', admin: { custom: undoRedoCustom({ disabled: true }) } }
+ * ```
+ *
+ * Spread it when the field already carries other custom data:
+ * `custom: { ...existing, ...undoRedoCustom({ disabled: true }) }`.
+ */
+declare const undoRedoCustom: (config: UndoRedoFieldConfig) => Record<string, UndoRedoFieldConfig>;
+//#endregion
+export { UNDO_REDO_FIELD_KEY, UndoRedoFieldConfig, undoRedoCustom };
+//# sourceMappingURL=fieldConfig.d.ts.map

package/dist/schema/fieldConfig.js

@@ -0,0 +1,28 @@
+//#region src/schema/fieldConfig.ts
+/**
+* Per-field opt-out, declared next to the field it applies to.
+*
+* It has to live under `admin.custom` rather than the field's own `custom`:
+* Payload strips `custom` from the client config (it is listed in
+* `serverOnlyFieldProperties`, see payload/src/fields/config/client.ts), while
+* `admin.custom` is documented as available on both sides and survives. The
+* controls run on the client, so `admin.custom` is the only channel that
+* reaches them.
+*/
+/** Namespace this plugin claims inside the shared `admin.custom` object. */
+const UNDO_REDO_FIELD_KEY = "undoRedo";
+/**
+* Build the `admin.custom` fragment for a field.
+*
+* ```ts
+* { name: 'content', type: 'richText', admin: { custom: undoRedoCustom({ disabled: true }) } }
+* ```
+*
+* Spread it when the field already carries other custom data:
+* `custom: { ...existing, ...undoRedoCustom({ disabled: true }) }`.
+*/
+const undoRedoCustom = (config) => ({ [UNDO_REDO_FIELD_KEY]: config });
+//#endregion
+export { UNDO_REDO_FIELD_KEY, undoRedoCustom };
+
+//# sourceMappingURL=fieldConfig.js.map

package/dist/schema/fieldConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldConfig.js","names":[],"sources":["../../src/schema/fieldConfig.ts"],"sourcesContent":["/**\n * Per-field opt-out, declared next to the field it applies to.\n *\n * It has to live under `admin.custom` rather than the field's own `custom`:\n * Payload strips `custom` from the client config (it is listed in\n * `serverOnlyFieldProperties`, see payload/src/fields/config/client.ts), while\n * `admin.custom` is documented as available on both sides and survives. The\n * controls run on the client, so `admin.custom` is the only channel that\n * reaches them.\n */\n\n/** Namespace this plugin claims inside the shared `admin.custom` object. */\nexport const UNDO_REDO_FIELD_KEY = 'undoRedo'\n\nexport interface UndoRedoFieldConfig {\n\t/**\n\t * Leave this field out of the undo history entirely: its changes create no\n\t * entries and undo never writes to it. Applies to the whole subtree when set\n\t * on anything with children: a group, array, blocks field, tabs field, an\n\t * individual tab, a row or a collapsible.\n\t */\n\tdisabled?: boolean\n}\n\n/**\n * Build the `admin.custom` fragment for a field.\n *\n * ```ts\n * { name: 'content', type: 'richText', admin: { custom: undoRedoCustom({ disabled: true }) } }\n * ```\n *\n * Spread it when the field already carries other custom data:\n * `custom: { ...existing, ...undoRedoCustom({ disabled: true }) }`.\n */\nexport const undoRedoCustom = (\n\tconfig: UndoRedoFieldConfig\n): Record<string, UndoRedoFieldConfig> => ({ [UNDO_REDO_FIELD_KEY]: config })\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,sBAAsB;;;;;;;;;;;AAsBnC,MAAa,kBACZ,YAC0C,GAAG,sBAAsB,OAAO"}

package/dist/schema/fieldSchema.d.ts

@@ -0,0 +1,63 @@
+//#region src/schema/fieldSchema.d.ts
+/**
+ * Walks a Payload field schema and flattens it into the path patterns the
+ * history matcher speaks, annotating each with the field's type and whether the
+ * host opted it out of undo/redo.
+ *
+ * This exists because form state carries no type information: `FormField` has a
+ * `fieldSchema` member, but only when `buildFormState` is called with
+ * `includeSchema: true`, which the document edit view never does. The client
+ * config is the only place a mounted component can learn that `layout.0.body`
+ * is rich text rather than a plain string.
+ *
+ * Row indexes collapse to `*`, because a schema describes every row at once:
+ * an array `list` containing `title` yields `list.*.title`, which the matcher
+ * then tests against the concrete `list.0.title`.
+ */
+/** Anything that can carry this plugin's per-field opt-out. */
+interface CustomCarrier {
+  admin?: {
+    custom?: Record<string, unknown>;
+  };
+}
+/** The structural shape this walk needs, satisfied by both `Field` and `ClientField`. */
+interface WalkableField extends CustomCarrier {
+  type: string;
+  name?: string;
+  fields?: WalkableField[];
+  blocks?: (WalkableBlock | string)[];
+  blockReferences?: (WalkableBlock | string)[];
+  tabs?: WalkableTab[];
+}
+interface WalkableBlock {
+  slug: string;
+  fields: WalkableField[];
+}
+interface WalkableTab extends CustomCarrier {
+  name?: string;
+  fields: WalkableField[];
+}
+interface FieldSchemaEntry {
+  /** Form-state path pattern, with `*` standing in for every array or blocks row index. */
+  pattern: string;
+  /**
+   * The field's type, or `undefined` when the pattern is ambiguous: two blocks
+   * in one blocks field can declare the same field name with different types,
+   * and a form-state path carries no block discriminator to tell them apart.
+   * Callers must treat `undefined` as "unknown" and fall back to inspecting the
+   * value, never as "no field here".
+   */
+  type: string | undefined;
+  /** Every type seen at this pattern, so ambiguity is inspectable rather than silent. */
+  types: string[];
+  /**
+   * Whether any contributor marked the field opted out. Ambiguous patterns
+   * resolve by OR: honouring an opt-out that was meant for a sibling block is
+   * the safe direction, ignoring one the host asked for is not.
+   */
+  disabled: boolean;
+}
+type FieldSchemaMap = Map<string, FieldSchemaEntry>;
+//#endregion
+export { FieldSchemaEntry, FieldSchemaMap, WalkableBlock, WalkableField, WalkableTab };
+//# sourceMappingURL=fieldSchema.d.ts.map

package/dist/schema/fieldSchema.js

@@ -0,0 +1,122 @@
+import { UNDO_REDO_FIELD_KEY } from "./fieldConfig.js";
+//#region src/schema/fieldSchema.ts
+const readFieldConfig = (field) => field.admin?.custom?.[UNDO_REDO_FIELD_KEY];
+const isDisabled = (field) => readFieldConfig(field)?.disabled === true;
+const record = (context, pattern, found) => {
+	const existing = context.map.get(pattern);
+	if (!existing) {
+		context.map.set(pattern, {
+			pattern,
+			type: found.type,
+			types: [found.type],
+			disabled: found.disabled
+		});
+		return;
+	}
+	if (!existing.types.includes(found.type)) {
+		existing.types.push(found.type);
+		existing.type = void 0;
+	}
+	existing.disabled ||= found.disabled;
+};
+const join = (parent, segment) => parent === "" ? segment : `${parent}.${segment}`;
+/** `blockReferences` wins when present: Payload populates one or the other. */
+const resolveBlocks = (field) => field.blockReferences ?? field.blocks ?? [];
+const walkBlock = (block, scope, context) => {
+	const resolved = typeof block === "string" ? context.blocksMap?.[block] : block;
+	if (!resolved || context.openBlocks.has(resolved.slug)) return;
+	context.openBlocks.add(resolved.slug);
+	walkFields(resolved.fields, scope, context);
+	context.openBlocks.delete(resolved.slug);
+};
+const walkFields = (fields, scope, context) => {
+	for (const field of fields) {
+		if (field.type === "ui") continue;
+		if (field.type === "tabs") {
+			const disabled = scope.disabled || isDisabled(field);
+			for (const tab of field.tabs ?? []) walkFields(tab.fields, {
+				disabled: disabled || isDisabled(tab),
+				parent: tab.name ? join(scope.parent, tab.name) : scope.parent
+			}, context);
+			continue;
+		}
+		if (!field.name) {
+			if (field.fields) walkFields(field.fields, {
+				disabled: scope.disabled || isDisabled(field),
+				parent: scope.parent
+			}, context);
+			continue;
+		}
+		const path = join(scope.parent, field.name);
+		record(context, path, {
+			disabled: scope.disabled || isDisabled(field),
+			type: field.type
+		});
+		const childScope = {
+			disabled: false,
+			parent: path
+		};
+		if (field.type === "array" || field.type === "blocks") {
+			const rowScope = {
+				disabled: false,
+				parent: join(path, "*")
+			};
+			if (field.type === "blocks") for (const block of resolveBlocks(field)) walkBlock(block, rowScope, context);
+			if (field.fields) walkFields(field.fields, rowScope, context);
+			continue;
+		}
+		if (field.fields) walkFields(field.fields, childScope, context);
+	}
+};
+/**
+* Flatten `fields` into a pattern map.
+*
+* Pass `blocksMap` (the client config's `blocksMap`) whenever the schema may use
+* slug-based `blockReferences`; without it those blocks are skipped, since their
+* definitions live on the config rather than on the field.
+*/
+const buildFieldSchemaMap = (fields, options = {}) => {
+	const context = {
+		blocksMap: options.blocksMap,
+		map: /* @__PURE__ */ new Map(),
+		openBlocks: /* @__PURE__ */ new Set()
+	};
+	walkFields(fields, {
+		disabled: false,
+		parent: ""
+	}, context);
+	return context.map;
+};
+/**
+* The patterns the history should ignore, from both opt-out sources: fields
+* marked through `admin.custom`, and whole field types the host excluded.
+*
+* Container patterns already cover their subtree (see pathPatterns), so an
+* opted-out group or array needs no entry for its children.
+*/
+const collectIgnorePatterns = (map, ignoreFieldTypes = []) => {
+	const types = new Set(ignoreFieldTypes);
+	const patterns = [];
+	for (const entry of map.values()) if (entry.disabled || entry.types.some((type) => types.has(type))) patterns.push(entry.pattern);
+	return patterns;
+};
+/**
+* The patterns whose field type is *unambiguously* `type`.
+*
+* Ambiguous patterns are left out, the opposite of how `collectIgnorePatterns`
+* resolves them. Over-matching is the safe direction for an opt-out, because
+* the cost is a field the host did not ask to exclude staying out of the
+* history. It is the unsafe direction here: callers use this to decide how to
+* read a *value*, and applying a JSON field's reading to a text field that
+* shares its path pattern in a sibling block would quietly stop that text field
+* from being captured.
+*/
+const collectPatternsOfType = (map, type) => {
+	const patterns = [];
+	for (const entry of map.values()) if (entry.type === type) patterns.push(entry.pattern);
+	return patterns;
+};
+//#endregion
+export { buildFieldSchemaMap, collectIgnorePatterns, collectPatternsOfType };
+
+//# sourceMappingURL=fieldSchema.js.map

package/dist/schema/fieldSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSchema.js","names":[],"sources":["../../src/schema/fieldSchema.ts"],"sourcesContent":["import { UNDO_REDO_FIELD_KEY, type UndoRedoFieldConfig } from './fieldConfig'\n\n/**\n * Walks a Payload field schema and flattens it into the path patterns the\n * history matcher speaks, annotating each with the field's type and whether the\n * host opted it out of undo/redo.\n *\n * This exists because form state carries no type information: `FormField` has a\n * `fieldSchema` member, but only when `buildFormState` is called with\n * `includeSchema: true`, which the document edit view never does. The client\n * config is the only place a mounted component can learn that `layout.0.body`\n * is rich text rather than a plain string.\n *\n * Row indexes collapse to `*`, because a schema describes every row at once:\n * an array `list` containing `title` yields `list.*.title`, which the matcher\n * then tests against the concrete `list.0.title`.\n */\n\n/** Anything that can carry this plugin's per-field opt-out. */\ninterface CustomCarrier {\n\tadmin?: {\n\t\tcustom?: Record<string, unknown>\n\t}\n}\n\n/** The structural shape this walk needs, satisfied by both `Field` and `ClientField`. */\nexport interface WalkableField extends CustomCarrier {\n\ttype: string\n\tname?: string\n\tfields?: WalkableField[]\n\tblocks?: (WalkableBlock | string)[]\n\tblockReferences?: (WalkableBlock | string)[]\n\ttabs?: WalkableTab[]\n}\n\nexport interface WalkableBlock {\n\tslug: string\n\tfields: WalkableField[]\n}\n\nexport interface WalkableTab extends CustomCarrier {\n\tname?: string\n\tfields: WalkableField[]\n}\n\nexport interface FieldSchemaEntry {\n\t/** Form-state path pattern, with `*` standing in for every array or blocks row index. */\n\tpattern: string\n\t/**\n\t * The field's type, or `undefined` when the pattern is ambiguous: two blocks\n\t * in one blocks field can declare the same field name with different types,\n\t * and a form-state path carries no block discriminator to tell them apart.\n\t * Callers must treat `undefined` as \"unknown\" and fall back to inspecting the\n\t * value, never as \"no field here\".\n\t */\n\ttype: string | undefined\n\t/** Every type seen at this pattern, so ambiguity is inspectable rather than silent. */\n\ttypes: string[]\n\t/**\n\t * Whether any contributor marked the field opted out. Ambiguous patterns\n\t * resolve by OR: honouring an opt-out that was meant for a sibling block is\n\t * the safe direction, ignoring one the host asked for is not.\n\t */\n\tdisabled: boolean\n}\n\nexport type FieldSchemaMap = Map<string, FieldSchemaEntry>\n\n/**\n * Guards against a blocks field that reaches itself through a slug reference,\n * which Payload allows and which is the main reason `blockReferences` exists.\n * Recursion is bounded by the set of block slugs already open on the current\n * branch, so a self-referencing block contributes its fields exactly once.\n */\ntype WalkContext = {\n\tblocksMap: Record<string, WalkableBlock> | undefined\n\tmap: FieldSchemaMap\n\topenBlocks: Set<string>\n}\n\n/**\n * Where the walk currently is: the path prefix, and whether an ancestor opted\n * its subtree out *without leaving a pattern behind*.\n *\n * That qualifier is the whole reason the flag exists. A named group or array\n * records a pattern of its own, and a pattern covers its whole subtree, so an\n * opt-out there needs no help travelling downwards. Tabs and unnamed rows,\n * collapsibles and groups contribute no path segment and therefore no pattern,\n * so theirs would be lost unless it is carried to the first descendant that\n * does record one.\n */\ninterface WalkScope {\n\tparent: string\n\tdisabled: boolean\n}\n\nconst readFieldConfig = (field: CustomCarrier): UndoRedoFieldConfig | undefined =>\n\tfield.admin?.custom?.[UNDO_REDO_FIELD_KEY] as UndoRedoFieldConfig | undefined\n\nconst isDisabled = (field: CustomCarrier): boolean => readFieldConfig(field)?.disabled === true\n\nconst record = (\n\tcontext: WalkContext,\n\tpattern: string,\n\tfound: { disabled: boolean; type: string }\n): void => {\n\tconst existing = context.map.get(pattern)\n\tif (!existing) {\n\t\tcontext.map.set(pattern, {\n\t\t\tpattern,\n\t\t\ttype: found.type,\n\t\t\ttypes: [found.type],\n\t\t\tdisabled: found.disabled,\n\t\t})\n\t\treturn\n\t}\n\tif (!existing.types.includes(found.type)) {\n\t\texisting.types.push(found.type)\n\t\texisting.type = undefined\n\t}\n\texisting.disabled ||= found.disabled\n}\n\nconst join = (parent: string, segment: string): string =>\n\tparent === '' ? segment : `${parent}.${segment}`\n\n/** `blockReferences` wins when present: Payload populates one or the other. */\nconst resolveBlocks = (field: WalkableField): (WalkableBlock | string)[] =>\n\tfield.blockReferences ?? field.blocks ?? []\n\nconst walkBlock = (block: WalkableBlock | string, scope: WalkScope, context: WalkContext): void => {\n\tconst resolved = typeof block === 'string' ? context.blocksMap?.[block] : block\n\t// An unresolvable slug means the caller had no blocks map. Skipping keeps the\n\t// rest of the schema usable rather than throwing over one missing definition.\n\tif (!resolved || context.openBlocks.has(resolved.slug)) return\n\tcontext.openBlocks.add(resolved.slug)\n\twalkFields(resolved.fields, scope, context)\n\tcontext.openBlocks.delete(resolved.slug)\n}\n\nconst walkFields = (fields: WalkableField[], scope: WalkScope, context: WalkContext): void => {\n\tfor (const field of fields) {\n\t\t// UI fields never reach the data, so they never appear in form state.\n\t\tif (field.type === 'ui') continue\n\n\t\tif (field.type === 'tabs') {\n\t\t\tconst disabled = scope.disabled || isDisabled(field)\n\t\t\tfor (const tab of field.tabs ?? []) {\n\t\t\t\t// A named tab adds a segment; an unnamed one leaves its children\n\t\t\t\t// where they were, exactly like a row or an unnamed group. Neither\n\t\t\t\t// records a pattern, so an opt-out on the tabs field or on the tab\n\t\t\t\t// itself has to continue downwards.\n\t\t\t\twalkFields(\n\t\t\t\t\ttab.fields,\n\t\t\t\t\t{\n\t\t\t\t\t\tdisabled: disabled || isDisabled(tab),\n\t\t\t\t\t\tparent: tab.name ? join(scope.parent, tab.name) : scope.parent,\n\t\t\t\t\t},\n\t\t\t\t\tcontext\n\t\t\t\t)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\n\t\t// Rows, collapsibles and unnamed groups are presentational: Payload gives\n\t\t// them an `_index-N` path of their own but strips it again for their\n\t\t// children, so they contribute nothing here beyond their opt-out.\n\t\tif (!field.name) {\n\t\t\tif (field.fields) {\n\t\t\t\twalkFields(\n\t\t\t\t\tfield.fields,\n\t\t\t\t\t{ disabled: scope.disabled || isDisabled(field), parent: scope.parent },\n\t\t\t\t\tcontext\n\t\t\t\t)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\n\t\tconst path = join(scope.parent, field.name)\n\t\trecord(context, path, { disabled: scope.disabled || isDisabled(field), type: field.type })\n\t\t// This field now has a pattern of its own, which covers everything below\n\t\t// it, so the inherited flag has done its job and stops here rather than\n\t\t// producing a redundant entry per descendant.\n\t\tconst childScope = { disabled: false, parent: path }\n\n\t\tif (field.type === 'array' || field.type === 'blocks') {\n\t\t\tconst rowScope = { disabled: false, parent: join(path, '*') }\n\t\t\tif (field.type === 'blocks') {\n\t\t\t\tfor (const block of resolveBlocks(field)) {\n\t\t\t\t\twalkBlock(block, rowScope, context)\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (field.fields) walkFields(field.fields, rowScope, context)\n\t\t\tcontinue\n\t\t}\n\n\t\tif (field.fields) walkFields(field.fields, childScope, context)\n\t}\n}\n\n/**\n * Flatten `fields` into a pattern map.\n *\n * Pass `blocksMap` (the client config's `blocksMap`) whenever the schema may use\n * slug-based `blockReferences`; without it those blocks are skipped, since their\n * definitions live on the config rather than on the field.\n */\nexport const buildFieldSchemaMap = (\n\tfields: WalkableField[],\n\toptions: { blocksMap?: Record<string, WalkableBlock> } = {}\n): FieldSchemaMap => {\n\tconst context: WalkContext = {\n\t\tblocksMap: options.blocksMap,\n\t\tmap: new Map(),\n\t\topenBlocks: new Set(),\n\t}\n\twalkFields(fields, { disabled: false, parent: '' }, context)\n\treturn context.map\n}\n\n/**\n * The patterns the history should ignore, from both opt-out sources: fields\n * marked through `admin.custom`, and whole field types the host excluded.\n *\n * Container patterns already cover their subtree (see pathPatterns), so an\n * opted-out group or array needs no entry for its children.\n */\nexport const collectIgnorePatterns = (\n\tmap: FieldSchemaMap,\n\tignoreFieldTypes: readonly string[] = []\n): string[] => {\n\tconst types = new Set(ignoreFieldTypes)\n\tconst patterns: string[] = []\n\tfor (const entry of map.values()) {\n\t\tif (entry.disabled || entry.types.some((type) => types.has(type))) {\n\t\t\tpatterns.push(entry.pattern)\n\t\t}\n\t}\n\treturn patterns\n}\n\n/**\n * The patterns whose field type is *unambiguously* `type`.\n *\n * Ambiguous patterns are left out, the opposite of how `collectIgnorePatterns`\n * resolves them. Over-matching is the safe direction for an opt-out, because\n * the cost is a field the host did not ask to exclude staying out of the\n * history. It is the unsafe direction here: callers use this to decide how to\n * read a *value*, and applying a JSON field's reading to a text field that\n * shares its path pattern in a sibling block would quietly stop that text field\n * from being captured.\n */\nexport const collectPatternsOfType = (map: FieldSchemaMap, type: string): string[] => {\n\tconst patterns: string[] = []\n\tfor (const entry of map.values()) {\n\t\tif (entry.type === type) patterns.push(entry.pattern)\n\t}\n\treturn patterns\n}\n"],"mappings":"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"}

package/dist/translations/de.js

@@ -0,0 +1,19 @@
+import { keys } from "./keys.js";
+//#region src/translations/de.ts
+/** German values, keyed by the typed constants in `keys.ts`. */
+const de = {
+	[keys.undo]: "Rückgängig",
+	[keys.redo]: "Wiederholen",
+	[keys.debug]: "Rückgängig-Verlauf",
+	[keys.debugTooltip]: "Rückgängig-Verlauf untersuchen",
+	[keys.debugTitle]: "Rückgängig-Verlauf",
+	[keys.debugEmpty]: "Noch kein Verlauf erfasst.",
+	[keys.debugClose]: "Schließen",
+	[keys.debugPending]: "Ausstehend (nicht erfasst)",
+	[keys.debugOriginal]: "Ursprungszustand",
+	[keys.debugCopy]: "JSON kopieren"
+};
+//#endregion
+export { de };
+
+//# sourceMappingURL=de.js.map

package/dist/translations/de.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"de.js","names":[],"sources":["../../src/translations/de.ts"],"sourcesContent":["import { keys, type TranslationKey } from './keys'\n\n/** German values, keyed by the typed constants in `keys.ts`. */\nexport const de: Record<TranslationKey, string> = {\n\t[keys.undo]: 'Rückgängig',\n\t[keys.redo]: 'Wiederholen',\n\t[keys.debug]: 'Rückgängig-Verlauf',\n\t[keys.debugTooltip]: 'Rückgängig-Verlauf untersuchen',\n\t[keys.debugTitle]: 'Rückgängig-Verlauf',\n\t[keys.debugEmpty]: 'Noch kein Verlauf erfasst.',\n\t[keys.debugClose]: 'Schließen',\n\t[keys.debugPending]: 'Ausstehend (nicht erfasst)',\n\t[keys.debugOriginal]: 'Ursprungszustand',\n\t[keys.debugCopy]: 'JSON kopieren',\n}\n"],"mappings":";;;AAGA,MAAa,KAAqC;EAChD,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,QAAQ;EACb,KAAK,eAAe;EACpB,KAAK,aAAa;EAClB,KAAK,aAAa;EAClB,KAAK,aAAa;EAClB,KAAK,eAAe;EACpB,KAAK,gBAAgB;EACrB,KAAK,YAAY;AACnB"}