@jini-ai/admin 0.4.2 → 0.4.4

package/dist/comments/react/index.d.ts

@@ -0,0 +1,316 @@
+import { type CommentsTranslator } from '../messages.en.js';
+export type { CommentsProps } from './pages/CommentsPage.js';
+export type { QueueSectionProps } from './components/QueueSection.js';
+export type { SettingsSectionProps } from './components/SettingsSection.js';
+export { useComments, useWiredComments } from './hooks/use-comments.hooks.js';
+export { useCommentQueue, useWiredCommentQueue } from './hooks/use-comment-queue.hooks.js';
+export { useCommentSettings, useWiredCommentSettings } from './hooks/use-comment-settings.hooks.js';
+export { useCommentsPorts } from './hooks/CommentsPorts.hooks.js';
+/** One comments module per admin scope. Host translation is scoped without adding rendered DOM.
+ * The queue page is loaded lazily; its two sections retain their current single-page composition.
+ */
+export declare function comments(_required: Record<string, never>, { t }?: {
+    t?: CommentsTranslator;
+}): {
+    id: "comments";
+    requires: {
+        readonly commentsApi: import("../../core/module/token.js").AdminPortToken<import("../index.js").AdminCommentsPort, "admin.comments.api">;
+        readonly commentsSession: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsSessionPort, "admin.comments.session">;
+    };
+    optional: {
+        readonly commentsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsEventsPort, "admin.comments.events">;
+    };
+    messages: {
+        readonly Status: "Status";
+        readonly "Actions for the comment by \"{author}\"": "Actions for the comment by \"{author}\"";
+        readonly Author: "Author";
+        readonly Comment: "Comment";
+        readonly Depth: "Depth";
+        readonly Created: "Created";
+        readonly More: "More";
+        readonly "Loading\u2026": "Loading…";
+        readonly "Load more": "Load more";
+        readonly "Loading comments\u2026": "Loading comments…";
+        readonly "No {status} comments.": "No {status} comments.";
+        readonly "Permanently delete this comment?": "Permanently delete this comment?";
+        readonly "Permanently delete this comment by \"{author}\"? This cannot be undone.": "Permanently delete this comment by \"{author}\"? This cannot be undone.";
+        readonly "Permanently delete": "Permanently delete";
+        readonly "Loading Comments settings\u2026": "Loading Comments settings…";
+        readonly Settings: "Settings";
+        readonly "Comments enabled": "Comments enabled";
+        readonly "Require moderation (new comments start pending)": "Require moderation (new comments start pending)";
+        readonly "Max thread depth": "Max thread depth";
+        readonly "Close submissions after (days, blank = never)": "Close submissions after (days, blank = never)";
+        readonly "Spam auto-reject score (0\u20131)": "Spam auto-reject score (0–1)";
+        readonly "Max submissions per IP per hour": "Max submissions per IP per hour";
+        readonly "Saving\u2026": "Saving…";
+        readonly "Save settings": "Save settings";
+        readonly "Loading Comments\u2026": "Loading Comments…";
+        readonly People: "People";
+        readonly Comments: "Comments";
+        readonly "Moderate incoming comments and configure workspace-wide comment behavior.": "Moderate incoming comments and configure workspace-wide comment behavior.";
+        readonly "You do not have permission to view the moderation queue.": "You do not have permission to view the moderation queue.";
+        readonly "This comment changed since you loaded it (current version {currentVersion}) \u2014 refresh and try again.": "This comment changed since you loaded it (current version {currentVersion}) — refresh and try again.";
+        readonly "This comment changed since you loaded it \u2014 refresh and try again.": "This comment changed since you loaded it — refresh and try again.";
+        readonly "Failed to update comment.": "Failed to update comment.";
+        readonly Approve: "Approve";
+        readonly Spam: "Spam";
+        readonly Trash: "Trash";
+        readonly Restore: "Restore";
+        readonly Purge: "Purge";
+        readonly "Spam auto-reject score must be between 0 and 1.": "Spam auto-reject score must be between 0 and 1.";
+        readonly "failed to load the moderation queue": "failed to load the moderation queue";
+        readonly "Failed to purge comment.": "Failed to purge comment.";
+        readonly "Saved.": "Saved.";
+        readonly "failed to save Comments settings": "failed to save Comments settings";
+        readonly "failed to load Comments settings": "failed to load Comments settings";
+        readonly pending: "Pending";
+        readonly approved: "Approved";
+        readonly spam: "Spam";
+        readonly trash: "Trash";
+    };
+    pages: {
+        readonly queue: {
+            readonly path: "/comments";
+            readonly label: "Comments";
+            readonly permissions: readonly ["comments.read"];
+            readonly agentReachable: true;
+            readonly nav: {
+                readonly group: "people";
+                readonly icon: "message-circle";
+            };
+            readonly tabs: {};
+        };
+    };
+} & {
+    react: {
+        Provider: ({ admin, children, t: currentTranslation }: Parameters<({ admin, children }: {
+            admin: import("../../core/module/types.js").AdminInstance;
+            children: import("react").ReactNode;
+        }, _optional?: Record<string, never>) => import("react").FunctionComponentElement<import("react").ProviderProps<import("../../core/module/types.js").ScopedPorts<{
+            id: "comments";
+            requires: {
+                readonly commentsApi: import("../../core/module/token.js").AdminPortToken<import("../index.js").AdminCommentsPort, "admin.comments.api">;
+                readonly commentsSession: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsSessionPort, "admin.comments.session">;
+            };
+            optional: {
+                readonly commentsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsEventsPort, "admin.comments.events">;
+            };
+            messages: {
+                readonly Status: "Status";
+                readonly "Actions for the comment by \"{author}\"": "Actions for the comment by \"{author}\"";
+                readonly Author: "Author";
+                readonly Comment: "Comment";
+                readonly Depth: "Depth";
+                readonly Created: "Created";
+                readonly More: "More";
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load more": "Load more";
+                readonly "Loading comments\u2026": "Loading comments…";
+                readonly "No {status} comments.": "No {status} comments.";
+                readonly "Permanently delete this comment?": "Permanently delete this comment?";
+                readonly "Permanently delete this comment by \"{author}\"? This cannot be undone.": "Permanently delete this comment by \"{author}\"? This cannot be undone.";
+                readonly "Permanently delete": "Permanently delete";
+                readonly "Loading Comments settings\u2026": "Loading Comments settings…";
+                readonly Settings: "Settings";
+                readonly "Comments enabled": "Comments enabled";
+                readonly "Require moderation (new comments start pending)": "Require moderation (new comments start pending)";
+                readonly "Max thread depth": "Max thread depth";
+                readonly "Close submissions after (days, blank = never)": "Close submissions after (days, blank = never)";
+                readonly "Spam auto-reject score (0\u20131)": "Spam auto-reject score (0–1)";
+                readonly "Max submissions per IP per hour": "Max submissions per IP per hour";
+                readonly "Saving\u2026": "Saving…";
+                readonly "Save settings": "Save settings";
+                readonly "Loading Comments\u2026": "Loading Comments…";
+                readonly People: "People";
+                readonly Comments: "Comments";
+                readonly "Moderate incoming comments and configure workspace-wide comment behavior.": "Moderate incoming comments and configure workspace-wide comment behavior.";
+                readonly "You do not have permission to view the moderation queue.": "You do not have permission to view the moderation queue.";
+                readonly "This comment changed since you loaded it (current version {currentVersion}) \u2014 refresh and try again.": "This comment changed since you loaded it (current version {currentVersion}) — refresh and try again.";
+                readonly "This comment changed since you loaded it \u2014 refresh and try again.": "This comment changed since you loaded it — refresh and try again.";
+                readonly "Failed to update comment.": "Failed to update comment.";
+                readonly Approve: "Approve";
+                readonly Spam: "Spam";
+                readonly Trash: "Trash";
+                readonly Restore: "Restore";
+                readonly Purge: "Purge";
+                readonly "Spam auto-reject score must be between 0 and 1.": "Spam auto-reject score must be between 0 and 1.";
+                readonly "failed to load the moderation queue": "failed to load the moderation queue";
+                readonly "Failed to purge comment.": "Failed to purge comment.";
+                readonly "Saved.": "Saved.";
+                readonly "failed to save Comments settings": "failed to save Comments settings";
+                readonly "failed to load Comments settings": "failed to load Comments settings";
+                readonly pending: "Pending";
+                readonly approved: "Approved";
+                readonly spam: "Spam";
+                readonly trash: "Trash";
+            };
+            pages: {
+                readonly queue: {
+                    readonly path: "/comments";
+                    readonly label: "Comments";
+                    readonly permissions: readonly ["comments.read"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "people";
+                        readonly icon: "message-circle";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        }> | null>>>[0] & {
+            t?: CommentsTranslator;
+        }) => import("react").FunctionComponentElement<import("react").ProviderProps<CommentsTranslator>>;
+        module: {
+            id: "comments";
+            requires: {
+                readonly commentsApi: import("../../core/module/token.js").AdminPortToken<import("../index.js").AdminCommentsPort, "admin.comments.api">;
+                readonly commentsSession: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsSessionPort, "admin.comments.session">;
+            };
+            optional: {
+                readonly commentsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsEventsPort, "admin.comments.events">;
+            };
+            messages: {
+                readonly Status: "Status";
+                readonly "Actions for the comment by \"{author}\"": "Actions for the comment by \"{author}\"";
+                readonly Author: "Author";
+                readonly Comment: "Comment";
+                readonly Depth: "Depth";
+                readonly Created: "Created";
+                readonly More: "More";
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load more": "Load more";
+                readonly "Loading comments\u2026": "Loading comments…";
+                readonly "No {status} comments.": "No {status} comments.";
+                readonly "Permanently delete this comment?": "Permanently delete this comment?";
+                readonly "Permanently delete this comment by \"{author}\"? This cannot be undone.": "Permanently delete this comment by \"{author}\"? This cannot be undone.";
+                readonly "Permanently delete": "Permanently delete";
+                readonly "Loading Comments settings\u2026": "Loading Comments settings…";
+                readonly Settings: "Settings";
+                readonly "Comments enabled": "Comments enabled";
+                readonly "Require moderation (new comments start pending)": "Require moderation (new comments start pending)";
+                readonly "Max thread depth": "Max thread depth";
+                readonly "Close submissions after (days, blank = never)": "Close submissions after (days, blank = never)";
+                readonly "Spam auto-reject score (0\u20131)": "Spam auto-reject score (0–1)";
+                readonly "Max submissions per IP per hour": "Max submissions per IP per hour";
+                readonly "Saving\u2026": "Saving…";
+                readonly "Save settings": "Save settings";
+                readonly "Loading Comments\u2026": "Loading Comments…";
+                readonly People: "People";
+                readonly Comments: "Comments";
+                readonly "Moderate incoming comments and configure workspace-wide comment behavior.": "Moderate incoming comments and configure workspace-wide comment behavior.";
+                readonly "You do not have permission to view the moderation queue.": "You do not have permission to view the moderation queue.";
+                readonly "This comment changed since you loaded it (current version {currentVersion}) \u2014 refresh and try again.": "This comment changed since you loaded it (current version {currentVersion}) — refresh and try again.";
+                readonly "This comment changed since you loaded it \u2014 refresh and try again.": "This comment changed since you loaded it — refresh and try again.";
+                readonly "Failed to update comment.": "Failed to update comment.";
+                readonly Approve: "Approve";
+                readonly Spam: "Spam";
+                readonly Trash: "Trash";
+                readonly Restore: "Restore";
+                readonly Purge: "Purge";
+                readonly "Spam auto-reject score must be between 0 and 1.": "Spam auto-reject score must be between 0 and 1.";
+                readonly "failed to load the moderation queue": "failed to load the moderation queue";
+                readonly "Failed to purge comment.": "Failed to purge comment.";
+                readonly "Saved.": "Saved.";
+                readonly "failed to save Comments settings": "failed to save Comments settings";
+                readonly "failed to load Comments settings": "failed to load Comments settings";
+                readonly pending: "Pending";
+                readonly approved: "Approved";
+                readonly spam: "Spam";
+                readonly trash: "Trash";
+            };
+            pages: {
+                readonly queue: {
+                    readonly path: "/comments";
+                    readonly label: "Comments";
+                    readonly permissions: readonly ["comments.read"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "people";
+                        readonly icon: "message-circle";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        };
+        pages: {
+            readonly queue: {
+                Page: import("react").LazyExoticComponent<import("react").ComponentType<import("../../react/bind-react.js").ModulePageProps>>;
+                tabs: {};
+            };
+        };
+        usePorts: (_required?: Record<string, never>, _optional?: Record<string, never>) => import("../../core/module/types.js").ScopedPorts<{
+            id: "comments";
+            requires: {
+                readonly commentsApi: import("../../core/module/token.js").AdminPortToken<import("../index.js").AdminCommentsPort, "admin.comments.api">;
+                readonly commentsSession: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsSessionPort, "admin.comments.session">;
+            };
+            optional: {
+                readonly commentsEvents: import("../../core/module/token.js").AdminPortToken<import("../ports.js").CommentsEventsPort, "admin.comments.events">;
+            };
+            messages: {
+                readonly Status: "Status";
+                readonly "Actions for the comment by \"{author}\"": "Actions for the comment by \"{author}\"";
+                readonly Author: "Author";
+                readonly Comment: "Comment";
+                readonly Depth: "Depth";
+                readonly Created: "Created";
+                readonly More: "More";
+                readonly "Loading\u2026": "Loading…";
+                readonly "Load more": "Load more";
+                readonly "Loading comments\u2026": "Loading comments…";
+                readonly "No {status} comments.": "No {status} comments.";
+                readonly "Permanently delete this comment?": "Permanently delete this comment?";
+                readonly "Permanently delete this comment by \"{author}\"? This cannot be undone.": "Permanently delete this comment by \"{author}\"? This cannot be undone.";
+                readonly "Permanently delete": "Permanently delete";
+                readonly "Loading Comments settings\u2026": "Loading Comments settings…";
+                readonly Settings: "Settings";
+                readonly "Comments enabled": "Comments enabled";
+                readonly "Require moderation (new comments start pending)": "Require moderation (new comments start pending)";
+                readonly "Max thread depth": "Max thread depth";
+                readonly "Close submissions after (days, blank = never)": "Close submissions after (days, blank = never)";
+                readonly "Spam auto-reject score (0\u20131)": "Spam auto-reject score (0–1)";
+                readonly "Max submissions per IP per hour": "Max submissions per IP per hour";
+                readonly "Saving\u2026": "Saving…";
+                readonly "Save settings": "Save settings";
+                readonly "Loading Comments\u2026": "Loading Comments…";
+                readonly People: "People";
+                readonly Comments: "Comments";
+                readonly "Moderate incoming comments and configure workspace-wide comment behavior.": "Moderate incoming comments and configure workspace-wide comment behavior.";
+                readonly "You do not have permission to view the moderation queue.": "You do not have permission to view the moderation queue.";
+                readonly "This comment changed since you loaded it (current version {currentVersion}) \u2014 refresh and try again.": "This comment changed since you loaded it (current version {currentVersion}) — refresh and try again.";
+                readonly "This comment changed since you loaded it \u2014 refresh and try again.": "This comment changed since you loaded it — refresh and try again.";
+                readonly "Failed to update comment.": "Failed to update comment.";
+                readonly Approve: "Approve";
+                readonly Spam: "Spam";
+                readonly Trash: "Trash";
+                readonly Restore: "Restore";
+                readonly Purge: "Purge";
+                readonly "Spam auto-reject score must be between 0 and 1.": "Spam auto-reject score must be between 0 and 1.";
+                readonly "failed to load the moderation queue": "failed to load the moderation queue";
+                readonly "Failed to purge comment.": "Failed to purge comment.";
+                readonly "Saved.": "Saved.";
+                readonly "failed to save Comments settings": "failed to save Comments settings";
+                readonly "failed to load Comments settings": "failed to load Comments settings";
+                readonly pending: "Pending";
+                readonly approved: "Approved";
+                readonly spam: "Spam";
+                readonly trash: "Trash";
+            };
+            pages: {
+                readonly queue: {
+                    readonly path: "/comments";
+                    readonly label: "Comments";
+                    readonly permissions: readonly ["comments.read"];
+                    readonly agentReachable: true;
+                    readonly nav: {
+                        readonly group: "people";
+                        readonly icon: "message-circle";
+                    };
+                    readonly tabs: {};
+                };
+            };
+        }>;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/comments/react/index.js

@@ -0,0 +1,35 @@
+import { createElement } from 'react';
+import { bindReact } from '../../core/react/bind-react.js';
+import { commentsModule } from '../comments.module.js';
+import { englishComments } from '../messages.en.js';
+import { CommentsPortsContext, CommentsTranslationContext } from './hooks/CommentsPorts.hooks.js';
+export { useComments, useWiredComments } from './hooks/use-comments.hooks.js';
+export { useCommentQueue, useWiredCommentQueue } from './hooks/use-comment-queue.hooks.js';
+export { useCommentSettings, useWiredCommentSettings } from './hooks/use-comment-settings.hooks.js';
+export { useCommentsPorts } from './hooks/CommentsPorts.hooks.js';
+/** One comments module per admin scope. Host translation is scoped without adding rendered DOM.
+ * The queue page is loaded lazily; its two sections retain their current single-page composition.
+ */
+export function comments(_required, { t = englishComments } = {}) {
+    // Scope membership uses object identity, so bind and return this same per-admin module.
+    const module = { ...commentsModule };
+    const react = bindReact({ module, views: {
+            queue: {
+                page: async () => {
+                    const { CommentsPage } = await import('./pages/CommentsPage.js');
+                    return { default: (_props) => createElement(CommentsPage, {}) };
+                },
+                tabs: {},
+            },
+        } }, { context: CommentsPortsContext });
+    const ScopeProvider = react.Provider;
+    /** A live translator override keeps locale changes inside the existing scope: rebuilding
+     * the module would remount the queue and discard the uncontrolled settings form.
+     * @example createElement(feature.react.Provider, { admin, t: hostTranslator, children })
+     */
+    function Provider({ admin, children, t: currentTranslation = t }) {
+        return createElement(CommentsTranslationContext.Provider, { value: currentTranslation }, createElement(ScopeProvider, { admin, children }));
+    }
+    return Object.assign(module, { react: { ...react, Provider } });
+}
+//# sourceMappingURL=index.js.map

package/dist/comments/react/pages/CommentsPage.d.ts

@@ -0,0 +1,12 @@
+import { useWiredComments } from '../hooks/use-comments.hooks.js';
+export interface CommentsProps {
+    /**
+     * Dependency injection seam for tests — the same convention `@jini-ai/ui`'s `CustomSelect` uses
+     * for `useCustomSelect`. Defaulted to the real hook, so production callers (`panels.tsx`) pass
+     * nothing and behave exactly as before.
+     */
+    useCommentsHook?: typeof useWiredComments;
+}
+export declare function CommentsPage(props?: CommentsProps): import("react").JSX.Element;
+export default CommentsPage;
+//# sourceMappingURL=CommentsPage.d.ts.map

package/dist/comments/react/pages/CommentsPage.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { QueueSection } from '../components/QueueSection.js';
+import { SettingsSection } from '../components/SettingsSection.js';
+import { useWiredComments } from '../hooks/use-comments.hooks.js';
+import { useCommentsPage } from '../hooks/CommentsPage.hooks.js';
+export function CommentsPage(props = {}) {
+    const { permissions, error, t, canRead, canConfigure } = useCommentsPage(props);
+    if (error)
+        return _jsx("div", { className: "notice error", children: error });
+    if (!permissions)
+        return _jsx("div", { className: "notice", children: t("Loading Comments…") });
+    return (_jsxs("div", { className: "page", children: [_jsx("div", { className: "page-header", children: _jsxs("div", { className: "page-header-text", children: [_jsx("p", { className: "page-kicker", children: t("People") }), _jsx("h1", { className: "page-title", children: t("Comments") }), _jsx("p", { className: "page-description", children: t("Moderate incoming comments and configure workspace-wide comment behavior.") })] }) }), canRead ? (_jsx(QueueSection, { permissions: permissions, t: t })) : (_jsx("div", { className: "notice", children: t("You do not have permission to view the moderation queue.") })), _jsx(SettingsSection, { canConfigure: canConfigure, t: t })] }));
+}
+export default CommentsPage;
+//# sourceMappingURL=CommentsPage.js.map

package/dist/comments/rules.d.ts

@@ -0,0 +1,140 @@
+import type { AdminComment, CommentModerationAction, CommentsSettings, CommentStatus } from '../core/ports/comments.js';
+import type { RowMenuItem } from '../react/components/RowMenu/RowMenu.js';
+import { type CommentsTranslator } from './messages.en.js';
+/**
+ * @file Pure logic for the `comments` feature — everything that computes a value rather than
+ * rendering one. Follows the `posts/rules.ts` convention: no React import, no hooks, directly
+ * testable.
+ *
+ * Moved here from `react/pages/CommentsPage.tsx`: `RowActionState`/`emptyRowState` and `describeModerationError`/
+ * `truncate` (already module-scope free functions in the original, just not exported), the
+ * moderation-queue row-menu item builder (a permission-and-status branch per action), and the
+ * Comments-settings patch builder plus its validation (REQ-08/09/10).
+ *
+ * `KEYS` (fetch-query migration, 2026-08-12): three independent resources this feature's three
+ * hooks each own — the operator's own effective permissions, the moderation queue (one cache
+ * identity PER status filter, `queue(status)`), and the settings form. `queueRoot` is the
+ * INVALIDATION target for a moderation action succeeding, not a read key of its own: a moderate/
+ * purge action always moves a comment to a DIFFERENT status than the one currently filtered, so the
+ * pre-migration `reloadFirstPage()` only ever refreshed the CURRENT filter's page — leaving a
+ * previously-visited OTHER status tab's cache stale (missing the comment) until the operator
+ * happened to force a reload. Invalidating the shared `["comments","queue"]` prefix instead
+ * refreshes every status tab's cache at once (matching by prefix — see `@jini-ai/ui/fetch-query`'s
+ * `QueryKey` doc), closing that gap; see `react/hooks/use-comment-queue.hooks.ts`'s own doc comment.
+ */
+export declare const KEYS: {
+    permissions: readonly ["comments", "permissions"];
+    queueRoot: readonly ["comments", "queue"];
+    queue: (status: CommentStatus) => readonly string[];
+    settings: readonly ["comments", "settings"];
+};
+/** The moderation queue's name on `lib/content-refresh-bus.ts` — see `taxonomy/rules.ts`'s
+ *  `TAXONOMY_RESOURCE` for why this is a plain colocated constant rather than a shared registry.
+ *  Agent-writable via `comments_approve_comment`/`comments_mark_comment_spam`/
+ *  `comments_trash_comment`/`comments_restore_comment` (`apps/website/src/features/comments/
+ *  agent-tools.ts`), all of which move a comment between statuses this queue lists.
+ *
+ *  There is deliberately NO sibling `COMMENTS_SETTINGS_RESOURCE`: `react/hooks/use-comment-settings.hooks.ts`'s
+ *  own header records a real, already-fixed lost-update bug (TM-TOVU-2026-08-12-A) whose fix is a
+ *  ONE-SHOT seed guard that refuses to re-seed `settings` from any later successful load, including
+ *  this bus's own out-of-band notification. Wiring that hook to the bus would either do nothing
+ *  (the guard blocks it) or, if the guard were bypassed instead, reintroduce the exact silent
+ *  revert the guard exists to prevent — so `comments_update_settings` stays unwired to this bus on
+ *  purpose. See that hook's own file header for the full incident record. */
+export declare const COMMENTS_QUEUE_RESOURCE = "comments-queue";
+/** Per-row moderation-action state (Approve/Spam/Trash/Restore/Purge share one `busy` flag — only
+ *  one action per row at a time). */
+export interface RowActionState {
+    busy: boolean;
+    error: string | null;
+}
+export declare function emptyRowState(_required?: Record<string, never>, _optional?: Record<string, never>): RowActionState;
+/** REQ-07: a 409 (stale `expectedVersion`) gets its own message instead of the generic fallback,
+ * using the route's own `{error, currentVersion}` body when present. */
+export declare function describeModerationError({ e }: {
+    e: unknown;
+}, { t }?: {
+    t?: CommentsTranslator;
+}): string;
+export declare function truncate({ text, max }: {
+    text: string;
+    max: number;
+}, _optional?: Record<string, never>): string;
+/** The callbacks a row menu needs. Passed in rather than imported, so this module stays free of
+ *  state (same convention as `posts/rules.ts`'s `PostRowMenuHandlers`). */
+export interface CommentRowMenuHandlers {
+    onModerate: (comment: AdminComment, action: CommentModerationAction) => void;
+    /** Opens the confirm dialog; only offered under the trash filter for an already-trashed
+     *  comment, and only with `comments.delete.force`. */
+    onRequestPurge: (comment: AdminComment) => void;
+}
+/** At-rest row actions for `RowMenu` — every condition here is copied verbatim from the inline
+ *  buttons this replaces, so a permission/status combination that used to hide a button still
+ *  omits the matching menu item rather than rendering a guaranteed-failing click. Each candidate
+ *  item is its own single-condition pure function above; this just resolves permissions once and
+ *  filters out the misses.
+ *
+ * @complexity Time: O(p) for three permission scans, p = effective grant count; output space is
+ * constant, with at most five menu entries. Permission ownership stays in the core helper.
+ */
+export declare function commentRowMenuItems({ comment, context, handlers }: {
+    comment: AdminComment;
+    context: {
+        permissions: readonly string[];
+        currentFilterStatus: CommentStatus;
+    };
+    handlers: CommentRowMenuHandlers;
+}, { t }?: {
+    t?: CommentsTranslator;
+}): RowMenuItem[];
+/** A blank or non-numeric raw value means "no opinion" — the field is left out of the patch
+ *  rather than coerced to `0`/`NaN`. Shared by every numeric settings field except
+ *  `closeAfterDays`, whose blank case means something else (see {@link parseCloseAfterDays}). */
+export declare function parseOptionalNumber({ raw }: {
+    raw: string;
+}, _optional?: Record<string, never>): number | undefined;
+/** REQ-10: blank means "never closes" -> `null` on the wire; the UI never sends the backend's own
+ *  `-1` sentinel, only `null` or a positive number. A non-numeric raw value is "no opinion"
+ *  (`undefined`), same as the other numeric fields. */
+export declare function parseCloseAfterDays({ raw }: {
+    raw: string;
+}, _optional?: Record<string, never>): number | null | undefined;
+/** REQ-08/09/10: builds a partial patch containing only the fields the operator actually changed
+ * (the backend's `setCommentsSettings` is a partial-patch contract — REQ-08 asks the client to
+ * mirror that instead of always sending the full object, as `Seo.tsx`'s form does). Each field's
+ * diff logic is a standalone pure helper above so it can be tested (and reasoned about) on its
+ * own; this function is just the merge. */
+export declare function buildSettingsPatch(required: {
+    form: FormData;
+    current: CommentsSettings;
+}, _optional?: Record<string, never>): Partial<CommentsSettings>;
+/** REQ-09: client-side validates `spamAutoRejectScore` before the network call — mirrors the
+ * backend's own `validateCommentsSettingsPatch` bound (`src/comments/settings.ts`). Returns the
+ * error message to show, or `null` when the patch is valid. Split out of `save`'s body (originally
+ * an inline `if`) because it is the one piece of that flow that computes a value rather than
+ * performing an effect. */
+export declare function validateSettingsPatch({ patch }: {
+    patch: Partial<CommentsSettings>;
+}, { t }?: {
+    t?: CommentsTranslator;
+}): string | null;
+/**
+ * `useCommentSettings`'s error banner, extracted out of that hook (`refactor/fetch-query`
+ * complexity pass, 2026-08-12 — same reason `redirects/rules.ts`'s `visibleRedirectsError` was
+ * extracted). Precedence, highest first: a client-side validation failure (the operator hasn't even
+ * submitted a valid patch yet — a stale write/list error underneath it would be a confusing second
+ * message), then the save write's own failure, then — only before `settings` has ever loaded — the
+ * list-read failure, matching every other migrated feature's "a later background failure must not
+ * blank an already-rendered screen" guard.
+ *
+ * @complexity Time/space: O(1) — four fixed checks, no iteration.
+ */
+export declare function visibleCommentSettingsError(params: {
+    validationError: string | null;
+    saveError: Error | null;
+    saveFallback: string;
+    listError: Error | null;
+    listFallback: string;
+    hasSettings: boolean;
+}, _optional?: Record<string, never>): string | null;
+//# sourceMappingURL=rules.d.ts.map