@forumone/throughline 0.0.0-stage → 1.0.0-next.0

package/dist/fields/CharacterCountField.js

@@ -0,0 +1,94 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { TextareaInput, TextInput, useField } from '@payloadcms/ui';
+import { mergeFieldStyles } from '@payloadcms/ui/shared';
+import { useCallback, useEffect, useRef, useState } from 'react';
+/*
+A capped text field that says how much room is left, and does not let an editor
+past the cap. From forumone-2026's `fields/characterCount/CharacterCount.tsx`.
+`characterCountPlugin` puts it on every capped field.
+
+**The counter appears late on purpose.** Below `SHOW_FROM` of the cap there is
+none: a number under every field turns a page of fields into a page of numbers.
+
+**The cap is enforced here, not by the browser.** `TextInput` and
+`TextareaInput` take a fixed prop list without `maxLength`, so the value is cut
+in `onChange`, which also catches a paste, the only way most people exceed a
+limit they can see. A paste that is cut short says so.
+
+**Content already over the cap is left alone.** It shows in full and can be
+edited down; the cap only refuses additions. Payload still refuses to save it.
+
+**The field's own styles are passed through** (`mergeFieldStyles`), or a capped
+field inside a row would draw at its content's width whatever `admin.width` said.
+*/
+/** Fraction of the cap at which the counter appears. */
+const SHOW_FROM = 0.8;
+/** How long "trimmed" stays up after a paste was cut. */
+const TRIMMED_MS = 4000;
+/*
+In Payload's tokens, so it follows the admin's themes. Rendered as a React 19
+`<style href precedence>`, hoisted and de-duplicated however many fields show it.
+*/
+const CSS = `
+.tl-count {
+  display: flex;
+  gap: var(--base, 20px);
+  align-items: baseline;
+  justify-content: space-between;
+  margin-top: calc(var(--base, 20px) * 0.25);
+  font-size: 0.8rem;
+  line-height: 1.3;
+  color: var(--theme-elevation-500);
+}
+.tl-count--full,
+.tl-count__trimmed {
+  color: var(--theme-warning-600, var(--theme-elevation-800));
+}
+.tl-count--full {
+  font-weight: 600;
+}
+`;
+function useCappedValue(path, maxLength) {
+    const { customComponents, setValue, value } = useField({ path });
+    const [trimmed, setTrimmed] = useState(false);
+    const timer = useRef(undefined);
+    useEffect(() => () => clearTimeout(timer.current), []);
+    const onChange = useCallback((event) => {
+        const next = event.target.value;
+        if (next.length > maxLength) {
+            setValue(next.slice(0, maxLength));
+            setTrimmed(true);
+            clearTimeout(timer.current);
+            timer.current = setTimeout(() => setTrimmed(false), TRIMMED_MS);
+            return;
+        }
+        setValue(next);
+    }, [maxLength, setValue]);
+    return {
+        // A configured `afterInput`, which replacing Payload's own control would otherwise drop.
+        afterInput: customComponents?.AfterInput,
+        onChange,
+        trimmed,
+        value: typeof value === 'string' ? value : '',
+    };
+}
+function Counter({ length, maxLength, trimmed, }) {
+    if (length < Math.floor(maxLength * SHOW_FROM))
+        return null;
+    const remaining = maxLength - length;
+    return (_jsxs("div", { className: `tl-count${remaining <= 0 ? ' tl-count--full' : ''}`, children: [_jsx("style", { href: "throughline-character-count", precedence: "default", children: CSS }), _jsx("span", { "aria-live": "polite", children: remaining > 0
+                    ? `${remaining} character${remaining === 1 ? '' : 's'} left`
+                    : `At the ${maxLength}-character limit` }), trimmed && (_jsx("span", { className: "tl-count__trimmed", role: "status", children: "Trimmed to fit" }))] }));
+}
+export const CharacterCountText = ({ field, path }) => {
+    const maxLength = field.maxLength ?? 0;
+    const { afterInput, onChange, trimmed, value } = useCappedValue(path, maxLength);
+    return (_jsx(TextInput, { AfterInput: _jsxs(_Fragment, { children: [afterInput, _jsx(Counter, { length: value.length, maxLength: maxLength, trimmed: trimmed })] }), ...(field.admin?.description ? { description: field.admin.description } : {}), ...(field.label ? { label: field.label } : {}), onChange: onChange, path: path, required: field.required ?? false, style: mergeFieldStyles(field), value: value }));
+};
+export const CharacterCountTextarea = ({ field, path }) => {
+    const maxLength = field.maxLength ?? 0;
+    const { afterInput, onChange, trimmed, value } = useCappedValue(path, maxLength);
+    return (_jsx(TextareaInput, { AfterInput: _jsxs(_Fragment, { children: [afterInput, _jsx(Counter, { length: value.length, maxLength: maxLength, trimmed: trimmed })] }), ...(field.admin?.description ? { description: field.admin.description } : {}), ...(field.label ? { label: field.label } : {}), onChange: onChange, path: path, required: field.required ?? false, style: mergeFieldStyles(field), value: value }));
+};
+//# sourceMappingURL=CharacterCountField.js.map

package/dist/fields/CharacterCountField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CharacterCountField.js","sourceRoot":"","sources":["../../src/fields/CharacterCountField.tsx"],"names":[],"mappings":"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"}

package/dist/fields/characterCount.d.ts

@@ -0,0 +1,15 @@
+import type { Field, Plugin } from 'payload';
+/** Where Payload finds the replacement controls. */
+export declare const CHARACTER_COUNT_TEXT_PATH = "@forumone/throughline/client#CharacterCountText";
+export declare const CHARACTER_COUNT_TEXTAREA_PATH = "@forumone/throughline/client#CharacterCountTextarea";
+/** The component for this field, or `undefined` when it should be left alone. */
+export declare function counterFor(field: Field): string | undefined;
+/** Every capped text field in a tree, given the counter. */
+export declare const addCounters: (fields: Field[]) => Field[];
+/**
+ * The pass. Covers collections, globals and `config.blocks`, the last being
+ * where blocks referenced by slug (a rich-text editor's blocks, say) are
+ * registered, which a walk over collections alone would not reach.
+ */
+export declare const characterCountPlugin: () => Plugin;
+//# sourceMappingURL=characterCount.d.ts.map

package/dist/fields/characterCount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterCount.d.ts","sourceRoot":"","sources":["../../src/fields/characterCount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAU,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAgCpD,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,oDAAoD,CAAA;AAC1F,eAAO,MAAM,6BAA6B,wDAAwD,CAAA;AAElG,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAa3D;AAkBD,4DAA4D;AAC5D,eAAO,MAAM,WAAW,GAAI,QAAQ,KAAK,EAAE,KAAG,KAAK,EAAoC,CAAA;AAEvF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAC3B,MAyBH,CAAA"}

package/dist/fields/characterCount.js

@@ -0,0 +1,92 @@
+import { mapFields } from './mapFields.js';
+/*
+Every capped text field gets a counter, and a cap it cannot be typed past. From
+forumone-2026's `fields/characterCount`.
+
+`maxLength` is enforced by Payload at save, so the limit was invisible right up
+to the moment it cost somebody what they had just written: fill a 160-character
+heading with four hundred words, press Publish, and read "The following field is
+invalid". This moves the limit to where the typing happens.
+
+## A pass over the built config, and last
+
+There can be hundreds of capped fields once a design system's blocks are
+generated from their contracts, so hand-editing them would be out of date the
+next time a contract changes. One rule instead, applied to whatever is there:
+a `text` or `textarea` field with a `maxLength` gets the control.
+
+Register it **after** every plugin that adds capped fields. `@payloadcms/plugin-seo`
+contributes `meta.title` and `meta.description`; running before it would miss
+both. (Those two are then skipped anyway, because the SEO plugin ships its own
+counted controls.)
+
+## What it leaves alone
+
+- A field that already has a custom `Field` component: replacing it would trade a
+  purpose-built control for a generic one.
+- `hasMany` text, which Payload renders as a multi-value select.
+- Anything with no `maxLength`: a counter with no denominator is noise.
+*/
+/** Where Payload finds the replacement controls. */
+export const CHARACTER_COUNT_TEXT_PATH = '@forumone/throughline/client#CharacterCountText';
+export const CHARACTER_COUNT_TEXTAREA_PATH = '@forumone/throughline/client#CharacterCountTextarea';
+/** The component for this field, or `undefined` when it should be left alone. */
+export function counterFor(field) {
+    if (field.type !== 'text' && field.type !== 'textarea')
+        return undefined;
+    if (typeof field.maxLength !== 'number' || field.maxLength <= 0)
+        return undefined;
+    // Already has a control chosen deliberately. Do not overrule it.
+    if (field.admin?.components?.Field)
+        return undefined;
+    if (field.type === 'text') {
+        if (field.hasMany)
+            return undefined;
+        return CHARACTER_COUNT_TEXT_PATH;
+    }
+    return CHARACTER_COUNT_TEXTAREA_PATH;
+}
+function withCounter(field) {
+    const component = counterFor(field);
+    if (!component)
+        return field;
+    return {
+        ...field,
+        admin: {
+            ...('admin' in field ? field.admin : {}),
+            components: {
+                ...('admin' in field ? field.admin?.components : {}),
+                Field: component,
+            },
+        },
+    };
+}
+/** Every capped text field in a tree, given the counter. */
+export const addCounters = (fields) => mapFields(fields, withCounter);
+/**
+ * The pass. Covers collections, globals and `config.blocks`, the last being
+ * where blocks referenced by slug (a rich-text editor's blocks, say) are
+ * registered, which a walk over collections alone would not reach.
+ */
+export const characterCountPlugin = () => (config) => {
+    // Each key is reattached only when it was there to begin with:
+    // `exactOptionalPropertyTypes` tells an `undefined` key from a missing one.
+    const next = { ...config };
+    if (config.blocks) {
+        next.blocks = config.blocks.map((block) => ({ ...block, fields: addCounters(block.fields) }));
+    }
+    if (config.collections) {
+        next.collections = config.collections.map((collection) => ({
+            ...collection,
+            fields: addCounters(collection.fields),
+        }));
+    }
+    if (config.globals) {
+        next.globals = config.globals.map((global) => ({
+            ...global,
+            fields: addCounters(global.fields),
+        }));
+    }
+    return next;
+};
+//# sourceMappingURL=characterCount.js.map

package/dist/fields/characterCount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterCount.js","sourceRoot":"","sources":["../../src/fields/characterCount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BE;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAAG,iDAAiD,CAAA;AAC1F,MAAM,CAAC,MAAM,6BAA6B,GAAG,qDAAqD,CAAA;AAElG,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,KAAY;IACrC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IACxE,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IAEjF,iEAAiE;IACjE,IAAI,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK;QAAE,OAAO,SAAS,CAAA;IAEpD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,SAAS,CAAA;QACnC,OAAO,yBAAyB,CAAA;IAClC,CAAC;IAED,OAAO,6BAA6B,CAAA;AACtC,CAAC;AAED,SAAS,WAAW,CAAC,KAAY;IAC/B,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;IACnC,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA;IAE5B,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE;YACL,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,UAAU,EAAE;gBACV,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,KAAK,EAAE,SAAS;aACjB;SACF;KACO,CAAA;AACZ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAe,EAAW,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;AAEvF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B,GAAW,EAAE,CACb,CAAC,MAAc,EAAU,EAAE;IACzB,+DAA+D;IAC/D,4EAA4E;IAC5E,MAAM,IAAI,GAAW,EAAE,GAAG,MAAM,EAAE,CAAA;IAElC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/F,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACzD,GAAG,UAAU;YACb,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC;SACvC,CAAC,CAAC,CAAA;IACL,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC7C,GAAG,MAAM;YACT,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;SACnC,CAAC,CAAC,CAAA;IACL,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/fields/checkSlug.d.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import type { CollectionSlug, Field, Payload, Plugin } from 'payload';
+import type { McpToolContext, McpToolDefinition } from '../plugin-contract/index.js';
+import type { McpToolCollector, McpToolDescriptor } from '../mcp/collector.js';
+export declare const FIELD_TOOLS: {
+    readonly checkSlug: {
+        readonly name: "check_slug";
+        readonly description: "Whether a URL slug is free in a collection, before creating or renaming a document. Normalises it the way the slug field will (lowercase, hyphens, no accents), and if it is taken says by which document, including one in the trash, and suggests the first free alternative.";
+    };
+};
+export declare const FIELD_TOOL_DESCRIPTORS: readonly McpToolDescriptor[];
+declare const inputSchema: z.ZodObject<{
+    collection: z.ZodString;
+    slug: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    collection: string;
+    slug: string;
+}, {
+    collection: string;
+    slug: string;
+}>;
+/** Whether a field tree has a top-level `slug` field, looking through unnamed wrappers. */
+export declare function hasSlugField(fields: readonly Field[]): boolean;
+/** The answer, for the tool and for a host that wants it directly. */
+export declare function checkSlug(payload: Payload, collection: CollectionSlug, input: string): Promise<{
+    collection: string;
+    slug: string;
+    available: boolean;
+    reason: string;
+} | {
+    collection: string;
+    slug: string;
+    available: boolean;
+    reason?: never;
+} | {
+    suggestion?: string;
+    collection: string;
+    slug: string;
+    available: boolean;
+    takenBy: {
+        id: number | string;
+        title: string;
+        trashed: boolean;
+    };
+    reason?: never;
+}>;
+export declare function createCheckSlugTool(deps: {
+    payload: Payload;
+    canUse?: (ctx: McpToolContext) => boolean;
+}): McpToolDefinition<typeof inputSchema>;
+/**
+ * The field kit's MCP tool. The fields themselves are plain functions a
+ * collection calls, and the character counter is `characterCountPlugin`, which
+ * has to run last; this only binds `check_slug`, and like every tool-bearing
+ * plugin must come before `mcpPlugin`.
+ */
+export declare function fieldsPlugin(options: {
+    mcpTools?: McpToolCollector;
+    canUse?: (ctx: McpToolContext) => boolean;
+}): Plugin;
+export {};
+//# sourceMappingURL=checkSlug.d.ts.map

package/dist/fields/checkSlug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSlug.d.ts","sourceRoot":"","sources":["../../src/fields/checkSlug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAY9E,eAAO,MAAM,WAAW;;;;;CAM8B,CAAA;AAEtD,eAAO,MAAM,sBAAsB,EAAE,SAAS,iBAAiB,EAA+B,CAAA;AAE9F,QAAA,MAAM,WAAW;;;;;;;;;EAGf,CAAA;AAEF,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,OAAO,CAe9D;AAwBD,sEAAsE;AACtE,wBAAsB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;YAoBjE,MAAM,GAAG,MAAM;;;;;GAMxC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;CAC1C,GAAG,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAaxC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAA;CAC1C,GAAG,MAAM,CAgBT"}

package/dist/fields/checkSlug.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { deniedEnvelope } from '../mcp/envelope.js';
+import { slugify, titleOf } from './slug.js';
+/*
+`check_slug`: the question an agent should ask before creating a document, and
+the one `refuseSlugHeldInTrash` answers too late, at save. A slug is unique
+across the whole collection, the trash included, so this reads past access
+control: a draft the caller cannot see still holds its address. Only admins and
+editors may ask by default, since the answer names the holder.
+*/
+export const FIELD_TOOLS = {
+    checkSlug: {
+        name: 'check_slug',
+        description: 'Whether a URL slug is free in a collection, before creating or renaming a document. Normalises it the way the slug field will (lowercase, hyphens, no accents), and if it is taken says by which document, including one in the trash, and suggests the first free alternative.',
+    },
+};
+export const FIELD_TOOL_DESCRIPTORS = Object.values(FIELD_TOOLS);
+const inputSchema = z.object({
+    collection: z.string().describe('The collection slug, e.g. "pages".'),
+    slug: z.string().min(1).describe('The slug, or a title to make one from.'),
+});
+/** Whether a field tree has a top-level `slug` field, looking through unnamed wrappers. */
+export function hasSlugField(fields) {
+    for (const field of fields) {
+        if ('name' in field && field.name === 'slug')
+            return true;
+        if (!('name' in field) || typeof field.name !== 'string') {
+            if (field.type === 'tabs' &&
+                field.tabs.some((tab) => !('name' in tab) && hasSlugField(tab.fields))) {
+                return true;
+            }
+            if ('fields' in field && Array.isArray(field.fields) && hasSlugField(field.fields))
+                return true;
+        }
+    }
+    return false;
+}
+function defaultCanUse(ctx) {
+    const roles = ctx.user?.roles ?? [];
+    return roles.includes('admin') || roles.includes('editor');
+}
+async function holderOf(payload, collection, slug, trash) {
+    const { docs } = await payload.find({
+        collection,
+        where: { slug: { equals: slug } },
+        depth: 0,
+        limit: 1,
+        overrideAccess: true,
+        ...(trash ? { trash: true } : {}),
+    });
+    return docs[0];
+}
+/** The answer, for the tool and for a host that wants it directly. */
+export async function checkSlug(payload, collection, input) {
+    const config = payload.collections[collection]?.config;
+    const trash = Boolean(config && 'trash' in config && config.trash);
+    const slug = slugify(input);
+    if (slug === '')
+        return { collection, slug, available: false, reason: 'Nothing is left once it is a slug.' };
+    const holder = await holderOf(payload, collection, slug, trash);
+    if (!holder)
+        return { collection, slug, available: true };
+    let suggestion;
+    for (let n = 2; n <= 20 && !suggestion; n += 1) {
+        const candidate = `${slug}-${n}`;
+        if (!(await holderOf(payload, collection, candidate, trash)))
+            suggestion = candidate;
+    }
+    return {
+        collection,
+        slug,
+        available: false,
+        takenBy: {
+            id: holder['id'],
+            title: titleOf(holder),
+            trashed: Boolean(holder['deletedAt']),
+        },
+        ...(suggestion ? { suggestion } : {}),
+    };
+}
+export function createCheckSlugTool(deps) {
+    const canUse = deps.canUse ?? defaultCanUse;
+    return {
+        ...FIELD_TOOLS.checkSlug,
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!canUse(ctx))
+                return deniedEnvelope('Only admins and editors can check slugs.');
+            const config = deps.payload.collections[input.collection]?.config;
+            if (!config)
+                return { error: `There is no collection "${input.collection}".` };
+            if (!hasSlugField(config.fields))
+                return { error: `"${input.collection}" has no slug field.` };
+            return checkSlug(deps.payload, input.collection, input.slug);
+        },
+    };
+}
+/**
+ * The field kit's MCP tool. The fields themselves are plain functions a
+ * collection calls, and the character counter is `characterCountPlugin`, which
+ * has to run last; this only binds `check_slug`, and like every tool-bearing
+ * plugin must come before `mcpPlugin`.
+ */
+export function fieldsPlugin(options) {
+    return (incoming) => {
+        options.mcpTools?.declare(FIELD_TOOL_DESCRIPTORS, { serverName: 'fields' });
+        return {
+            ...incoming,
+            onInit: async (payload) => {
+                if (incoming.onInit)
+                    await incoming.onInit(payload);
+                options.mcpTools?.add([
+                    createCheckSlugTool({ payload, ...(options.canUse ? { canUse: options.canUse } : {}) }),
+                ], { serverName: 'fields' });
+            },
+        };
+    };
+}
+//# sourceMappingURL=checkSlug.js.map

package/dist/fields/checkSlug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkSlug.js","sourceRoot":"","sources":["../../src/fields/checkSlug.ts"],"names":[],"mappings":"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"}

package/dist/fields/index.d.ts

@@ -0,0 +1,9 @@
+export { mapFields } from './mapFields.js';
+export { heldInTrash, refuseSlugHeldInTrash, slugField, slugify, titleOf } from './slug.js';
+export { LISTED, unlistedField } from './unlisted.js';
+export { usedBy } from './usedBy.js';
+export { contentRevisedAt, revisedAtField } from './revisedAt.js';
+export { keepOrStampPublishedAt, publishedAtField, publishingFields, scheduledPublishField, } from './publishing.js';
+export { CHARACTER_COUNT_TEXTAREA_PATH, CHARACTER_COUNT_TEXT_PATH, addCounters, characterCountPlugin, counterFor, } from './characterCount.js';
+export { FIELD_TOOLS, FIELD_TOOL_DESCRIPTORS, checkSlug, createCheckSlugTool, fieldsPlugin, hasSlugField, } from './checkSlug.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fields/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,WAAW,EACX,oBAAoB,EACpB,UAAU,GACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAA"}

package/dist/fields/index.js

@@ -0,0 +1,9 @@
+export { mapFields } from './mapFields.js';
+export { heldInTrash, refuseSlugHeldInTrash, slugField, slugify, titleOf } from './slug.js';
+export { LISTED, unlistedField } from './unlisted.js';
+export { usedBy } from './usedBy.js';
+export { contentRevisedAt, revisedAtField } from './revisedAt.js';
+export { keepOrStampPublishedAt, publishedAtField, publishingFields, scheduledPublishField, } from './publishing.js';
+export { CHARACTER_COUNT_TEXTAREA_PATH, CHARACTER_COUNT_TEXT_PATH, addCounters, characterCountPlugin, counterFor, } from './characterCount.js';
+export { FIELD_TOOLS, FIELD_TOOL_DESCRIPTORS, checkSlug, createCheckSlugTool, fieldsPlugin, hasSlugField, } from './checkSlug.js';
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACjE,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,6BAA6B,EAC7B,yBAAyB,EACzB,WAAW,EACX,oBAAoB,EACpB,UAAU,GACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,YAAY,GACb,MAAM,gBAAgB,CAAA"}

package/dist/fields/mapFields.d.ts

@@ -0,0 +1,13 @@
+import type { Field } from 'payload';
+/**
+ * Apply `fn` to every field in the tree, including those nested in arrays,
+ * groups, rows, collapsibles, tabs and inline blocks. From forumone-2026's
+ * `fields/mapFields.ts`.
+ *
+ * Shared because several passes need it (the character counter, an icon
+ * picker), and a second implementation would be a second chance to miss a
+ * nesting case. A block given by slug (`blockReferences`) is left as it is: it
+ * lives in the config's `blocks`, which a pass maps separately.
+ */
+export declare function mapFields(fields: Field[], fn: (field: Field) => Field): Field[];
+//# sourceMappingURL=mapFields.d.ts.map

package/dist/fields/mapFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFields.d.ts","sourceRoot":"","sources":["../../src/fields/mapFields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,GAAG,KAAK,EAAE,CA0B/E"}

package/dist/fields/mapFields.js

@@ -0,0 +1,32 @@
+/**
+ * Apply `fn` to every field in the tree, including those nested in arrays,
+ * groups, rows, collapsibles, tabs and inline blocks. From forumone-2026's
+ * `fields/mapFields.ts`.
+ *
+ * Shared because several passes need it (the character counter, an icon
+ * picker), and a second implementation would be a second chance to miss a
+ * nesting case. A block given by slug (`blockReferences`) is left as it is: it
+ * lives in the config's `blocks`, which a pass maps separately.
+ */
+export function mapFields(fields, fn) {
+    return fields.map((field) => {
+        const mapped = fn(field);
+        if ('fields' in mapped && Array.isArray(mapped.fields)) {
+            return { ...mapped, fields: mapFields(mapped.fields, fn) };
+        }
+        if (mapped.type === 'tabs') {
+            return {
+                ...mapped,
+                tabs: mapped.tabs.map((tab) => ({ ...tab, fields: mapFields(tab.fields, fn) })),
+            };
+        }
+        if (mapped.type === 'blocks' && Array.isArray(mapped.blocks)) {
+            return {
+                ...mapped,
+                blocks: mapped.blocks.map((block) => typeof block === 'string' ? block : { ...block, fields: mapFields(block.fields, fn) }),
+            };
+        }
+        return mapped;
+    });
+}
+//# sourceMappingURL=mapFields.js.map

package/dist/fields/mapFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapFields.js","sourceRoot":"","sources":["../../src/fields/mapFields.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,MAAe,EAAE,EAA2B;IACpE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,QAAQ,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAW,CAAA;QACrE,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,OAAO;gBACL,GAAG,MAAM;gBACT,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;aAChF,CAAA;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,OAAO;gBACL,GAAG,MAAM;gBACT,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAClC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CACtF;aACF,CAAA;QACH,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/fields/publishing.d.ts

@@ -0,0 +1,33 @@
+import type { Field, FieldHook } from 'payload';
+/**
+ * The `beforeChange` behind `publishedAtField`.
+ *
+ * Stamps the moment of the first publish when the field is empty, and leaves a
+ * date somebody entered alone (a migrated post's original date is the reason
+ * the field is editable at all). A write with no user counts: a scheduled
+ * publish went live at that moment as much as one a person published.
+ *
+ * **An empty value is not proof of a first publish.** The edit form keeps the
+ * value it loaded with, so a page first published from an open editor sends
+ * `null` again on its next save, and a hook reading only the incoming value
+ * would move the page's date on every publish. So with nothing incoming, the
+ * date the *published* document already carries wins.
+ */
+export declare const keepOrStampPublishedAt: FieldHook;
+/** `publishedAt`, which fills itself on the first publish. */
+export declare function publishedAtField(description: string, options?: {
+    index?: boolean;
+}): Field;
+/**
+ * A scheduled publish. `publishingPlugin` renders it as its Schedule control:
+ * picking a time runs the publish checks at once, stores the time with a draft
+ * save, and wakes the job that publishes at it. A publish or an unpublish
+ * clears it.
+ */
+export declare function scheduledPublishField(): Field;
+/** `publishedAt` and `scheduledPublishAt`, for every content type. */
+export declare function publishingFields(options?: {
+    publishedAtDescription?: string;
+    index?: boolean;
+}): Field[];
+//# sourceMappingURL=publishing.d.ts.map

package/dist/fields/publishing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishing.d.ts","sourceRoot":"","sources":["../../src/fields/publishing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAO/C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA+BpC,CAAA;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,KAAK,CAS9F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,KAAK,CAW7C;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE;IAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GACjE,KAAK,EAAE,CAST"}

package/dist/fields/publishing.js

@@ -0,0 +1,81 @@
+/*
+The sidebar dates a published document carries. From forumone-2026's
+`fields/publishing.ts`.
+*/
+/**
+ * The `beforeChange` behind `publishedAtField`.
+ *
+ * Stamps the moment of the first publish when the field is empty, and leaves a
+ * date somebody entered alone (a migrated post's original date is the reason
+ * the field is editable at all). A write with no user counts: a scheduled
+ * publish went live at that moment as much as one a person published.
+ *
+ * **An empty value is not proof of a first publish.** The edit form keeps the
+ * value it loaded with, so a page first published from an open editor sends
+ * `null` again on its next save, and a hook reading only the incoming value
+ * would move the page's date on every publish. So with nothing incoming, the
+ * date the *published* document already carries wins.
+ */
+export const keepOrStampPublishedAt = async ({ value, data, originalDoc, collection, req, }) => {
+    const incoming = value;
+    if (incoming)
+        return incoming;
+    const publishing = data?._status === 'published';
+    if (!publishing)
+        return incoming;
+    const id = originalDoc?.id;
+    if (id !== undefined && collection) {
+        const published = await req.payload
+            .findByID({
+            collection: collection.slug,
+            id,
+            depth: 0,
+            draft: false,
+            overrideAccess: true,
+            req,
+            disableErrors: true,
+        })
+            .catch(() => null);
+        const existing = published?.publishedAt;
+        if (typeof existing === 'string' && existing !== '')
+            return existing;
+    }
+    return new Date().toISOString();
+};
+/** `publishedAt`, which fills itself on the first publish. */
+export function publishedAtField(description, options = {}) {
+    return {
+        name: 'publishedAt',
+        type: 'date',
+        // Indexed where listings sort on it.
+        ...(options.index === false ? {} : { index: true }),
+        admin: { position: 'sidebar', description },
+        hooks: { beforeChange: [keepOrStampPublishedAt] },
+    };
+}
+/**
+ * A scheduled publish. `publishingPlugin` renders it as its Schedule control:
+ * picking a time runs the publish checks at once, stores the time with a draft
+ * save, and wakes the job that publishes at it. A publish or an unpublish
+ * clears it.
+ */
+export function scheduledPublishField() {
+    return {
+        name: 'scheduledPublishAt',
+        type: 'date',
+        admin: {
+            position: 'sidebar',
+            date: { pickerAppearance: 'dayAndTime' },
+            description: 'Publishes automatically at this time, after the same checks as publishing by hand. Set with the Schedule control; cleared when the document is published or unpublished.',
+        },
+    };
+}
+/** `publishedAt` and `scheduledPublishAt`, for every content type. */
+export function publishingFields(options = {}) {
+    return [
+        publishedAtField(options.publishedAtDescription ??
+            'The date shown on the page and used to sort listings. Leave it empty and it is set when this is first published; for a migrated post, enter the original date.', options.index === false ? { index: false } : {}),
+        scheduledPublishField(),
+    ];
+}
+//# sourceMappingURL=publishing.js.map

package/dist/fields/publishing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publishing.js","sourceRoot":"","sources":["../../src/fields/publishing.ts"],"names":[],"mappings":"AAEA;;;EAGE;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAc,KAAK,EAAE,EACtD,KAAK,EACL,IAAI,EACJ,WAAW,EACX,UAAU,EACV,GAAG,GACJ,EAAE,EAAE;IACH,MAAM,QAAQ,GAAY,KAAK,CAAA;IAC/B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAE7B,MAAM,UAAU,GAAI,IAA0C,EAAE,OAAO,KAAK,WAAW,CAAA;IACvF,IAAI,CAAC,UAAU;QAAE,OAAO,QAAQ,CAAA;IAEhC,MAAM,EAAE,GAAI,WAAoD,EAAE,EAAE,CAAA;IACpE,IAAI,EAAE,KAAK,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,OAAO;aAChC,QAAQ,CAAC;YACR,UAAU,EAAE,UAAU,CAAC,IAAI;YAC3B,EAAE;YACF,KAAK,EAAE,CAAC;YACR,KAAK,EAAE,KAAK;YACZ,cAAc,EAAE,IAAI;YACpB,GAAG;YACH,aAAa,EAAE,IAAI;SACpB,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QACpB,MAAM,QAAQ,GAAI,SAA8C,EAAE,WAAW,CAAA;QAC7E,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE;YAAE,OAAO,QAAQ,CAAA;IACtE,CAAC;IAED,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC,CAAA;AAED,8DAA8D;AAC9D,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,UAA+B,EAAE;IACrF,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,MAAM;QACZ,qCAAqC;QACrC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACnD,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE;QAC3C,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,sBAAsB,CAAC,EAAE;KAClD,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,oBAAoB;QAC1B,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE;YACL,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,EAAE,gBAAgB,EAAE,YAAY,EAAE;YACxC,WAAW,EACT,0KAA0K;SAC7K;KACF,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAC9B,UAAgE,EAAE;IAElE,OAAO;QACL,gBAAgB,CACd,OAAO,CAAC,sBAAsB;YAC5B,gKAAgK,EAClK,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAChD;QACD,qBAAqB,EAAE;KACxB,CAAA;AACH,CAAC"}