@riverbankcms/sdk 0.78.0 → 0.78.2

package/dist/_dts/api/src/siteRuntimeEndpoints.d.ts

@@ -5,7 +5,7 @@ import type { PageDesignEditorReadModel, PageDesignIntent, AppearancePresetId, B
 import type { ButtonPersonalityId } from '../../theme-core/src/buttons/index';
 import type { PaletteOverrides, PaletteVariantId } from '../../theme-core/src/palette/index';
 import type { APIEndpoint } from './apiEndpointTypes';
-import type { AnalyticsReportFilters, AnalyticsReportResponse } from './analytics';
+import type { AnalyticsReportQuery, AnalyticsReportResponse } from './analytics';
 import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
 import type { MediaUsageCheckResponse } from './shared-contracts';
 import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkTemplate, SiteBySlugResponse, ThemeGenerationTurn, ThemePreferencesRecord, ThemeRow } from './contentRuntime';
@@ -181,7 +181,7 @@ export type SiteRuntimeAPIEndpoints = {
         type: string;
         limit?: string;
         offset?: string;
-        order?: 'published_at.asc' | 'published_at.desc' | 'title.asc' | 'title.desc' | 'updated_at.asc' | 'updated_at.desc';
+        order?: 'published_at.asc' | 'published_at.desc' | 'title.asc' | 'title.desc' | 'manual.asc' | 'updated_at.asc' | 'updated_at.desc';
         stage?: ContentEntryListStage;
         meta?: string;
         mode?: 'manual';
@@ -337,26 +337,24 @@ export type SiteRuntimeAPIEndpoints = {
         }>;
     }>;
     createInstagramZipUploadUrl: APIEndpoint<CreateInstagramZipUploadUrlRequest, never, CreateInstagramZipUploadUrlResponse>;
-    getAnalyticsReport: APIEndpoint<AnalyticsReportFilters, {
-        siteId: string;
-    } & AnalyticsReportFilters, AnalyticsReportResponse>;
+    getAnalyticsReport: APIEndpoint<never, AnalyticsReportQuery, AnalyticsReportResponse>;
     createMediaAsset: APIEndpoint<CreateMediaAssetBody, undefined, MediaAssetResponse>;
-    mediaList: APIEndpoint<{
+    mediaList: APIEndpoint<never, {
         siteId: string;
         q?: string;
         limit?: number;
         offset?: number;
         labels?: string;
         fileFilter?: MediaAssetFileFilterContract;
-    }, never, ListMediaAssetsResult>;
-    mediaProductFileList: APIEndpoint<{
+    }, ListMediaAssetsResult>;
+    mediaProductFileList: APIEndpoint<never, {
         siteId: string;
         q?: string;
         limit?: number;
         offset?: number;
         labels?: string;
         fileFilter?: MediaAssetFileFilterContract;
-    }, never, ListMediaAssetsResult>;
+    }, ListMediaAssetsResult>;
     mediaGet: APIEndpoint<never, {
         assetId: string;
     }, MediaAssetWithLabels>;
@@ -544,17 +542,15 @@ export type SiteRuntimeAPIEndpoints = {
         siteId: string;
         pageId: string;
     }, ApplyPageDesignEditorActionResponse>;
-    getContentByPath: APIEndpoint<{
+    getContentByPath: APIEndpoint<never, {
+        siteId: string;
         path: string;
         preview?: boolean;
-    }, {
-        siteId: string;
     }, SdkRuntimeContentByPathResponse>;
-    getPageByPath: APIEndpoint<{
+    getPageByPath: APIEndpoint<never, {
+        siteId: string;
         path: string;
         preview?: boolean;
-    }, {
-        siteId: string;
     }, SdkRuntimeContentByPathResponse>;
     initSiteContent: APIEndpoint<{}, {
         siteId: string;
@@ -563,9 +559,9 @@ export type SiteRuntimeAPIEndpoints = {
         created: number;
         totalBlocks: number;
     }>;
-    getMediaLabels: APIEndpoint<{
+    getMediaLabels: APIEndpoint<never, {
         siteId: string;
-    }, never, {
+    }, {
         items: MediaLabelSummary[];
     }>;
     getMediaSettings: APIEndpoint<never, {
@@ -643,11 +639,11 @@ export type SiteRuntimeAPIEndpoints = {
             summary?: MediaJobSummaryResponse;
         }>;
     }>;
-    mediaJobsStatus: APIEndpoint<{
+    mediaJobsStatus: APIEndpoint<never, {
         siteId: string;
         limit?: number;
         statuses?: string;
-    }, never, {
+    }, {
         jobs: MediaClassifyJobResponse[];
     }>;
     devToolsImpersonateAdmin: APIEndpoint<undefined, never, DevToolsImpersonationResponse>;

package/dist/_dts/api/src/types.d.ts

@@ -1,4 +1,5 @@
 import type { CamelizeKeys, DbDatabase, DbRow } from "../../db/src/index";
+import type { APIEndpoint } from "./apiEndpointTypes";
 export type { AccessPolicyContract, AccessPolicyTag, CreateMediaAssetBody, EntitledCustomerAccessScopeContract, FileKindContract, FileKindTag, FileUseContract, FileUseTag, ImageFileFormat, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteAssetFailure, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse, RenderableFileKindTag, StorageClass, UploadIntentContract, UploadIntentTag, } from "./media";
 export type { AnalyticsPreset, AnalyticsReferrer, AnalyticsReportFilters, AnalyticsReportQuery, AnalyticsReportResponse, AnalyticsSeriesPoint, AnalyticsTopPage, AnalyticsTotals, } from "./analytics";
 export type { AIChatMessage, AiBriefTurn, JsonPrimitive, JsonValue, MediaUsageCheckItem, MediaUsageCheckResponse, MediaUsageLocation, } from "./shared-contracts";
@@ -121,48 +122,32 @@ type EndpointPath<E extends keyof APIEndpoints> = E extends keyof typeof API_END
 type PathParams<E extends keyof APIEndpoints> = ExtractPathParamNames<EndpointPath<E>> extends infer TParam ? [TParam] extends [never] ? {} : {
     [K in Extract<TParam, string>]: string;
 } : {};
-type QueryParams<E extends keyof APIEndpoints> = IsNonEmptyQuery<APIEndpoints[E]["query"]> extends false ? {} : QueryToStringParams<APIEndpoints[E]["query"]>;
+type EndpointQuery<E extends keyof APIEndpoints> = APIEndpoints[E] extends APIEndpoint<unknown, infer TQuery, unknown> ? TQuery : never;
+type QueryParams<E extends keyof APIEndpoints> = IsNonEmptyQuery<EndpointQuery<E>> extends false ? {} : QueryToStringParams<EndpointQuery<E>>;
 type HasPathParams<E extends keyof APIEndpoints> = keyof PathParams<E> extends never ? false : true;
 type ParamsPart<E extends keyof APIEndpoints> = HasPathParams<E> extends true ? {
     params: PathParams<E> & QueryParams<E>;
-} : IsNonEmptyQuery<APIEndpoints[E]["query"]> extends false ? {
+} : IsNonEmptyQuery<EndpointQuery<E>> extends false ? {
     params?: Record<string, string>;
-} : HasRequiredKeys<APIEndpoints[E]["query"]> extends true ? {
+} : HasRequiredKeys<EndpointQuery<E>> extends true ? {
     params: QueryParams<E>;
 } : {
     params?: QueryParams<E>;
 };
-export type APICallParams<E extends keyof APIEndpoints> = APIEndpoints[E] extends {
-    method: "GET";
-} ? {
-    endpoint: E;
-    body?: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E> : APIEndpoints[E] extends {
-    method: "POST" | "PUT" | "PATCH";
-} ? {
-    endpoint: E;
-    body: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E> : {
-    endpoint: E;
-    body?: APIEndpoints[E]["body"];
-    options?: RequestInit;
-} & ParamsPart<E>;
 type EndpointMethod<E extends keyof APIEndpoints> = E extends keyof typeof API_ENDPOINTS ? (typeof API_ENDPOINTS)[E]["method"] : HTTPMethod;
-type EndpointBody<E extends keyof APIEndpoints> = APIEndpoints[E]["body"];
+type EndpointBody<E extends keyof APIEndpoints> = APIEndpoints[E] extends APIEndpoint<infer TBody, unknown, unknown> ? TBody : never;
 type StrictBodyPart<E extends keyof APIEndpoints> = EndpointMethod<E> extends "GET" ? {
     body?: never;
 } : [EndpointBody<E>] extends [never | undefined] ? {
     body?: never;
+} : undefined extends EndpointBody<E> ? {
+    body?: Exclude<EndpointBody<E>, undefined>;
 } : {
-    body: NonNullable<EndpointBody<E>>;
+    body: EndpointBody<E>;
 };
 /**
- * Strict variant of APICallParams that uses endpoint metadata (method + body type)
- * to enforce whether `body` is required/forbidden.
- *
- * Intended for new code. Existing code can continue using APICallParams until migrated.
+ * API call parameters derived from endpoint metadata.
+ * Enforces whether `body` is required, optional, or forbidden for each endpoint.
  */
 export type APICallParamsStrict<E extends keyof APIEndpoints> = {
     endpoint: E;

package/dist/_dts/block-form/src/fields/types.d.ts

@@ -170,6 +170,12 @@ export type RepeaterFieldConfig = BaseFieldConfig & ({
      * Useful for complex constraints that aren't expressible via field-level config.
      */
     validation?: ZodTypeAny;
+    /** Whether compact row summaries should be rendered. Defaults to true. */
+    showSummary?: boolean;
+    /** Optional ordered field IDs to use for compact row summaries. */
+    summaryFields?: string[];
+    /** Optional positive max character count for compact row summaries. */
+    summaryMaxChars?: number;
 } & ({
     type: 'repeater';
     itemLabel?: string;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterList.d.ts

@@ -1,7 +1,7 @@
 /**
  * Repeater list - DnD context wrapper for sortable items
  */
-import type { ReactNode } from 'react';
+import { type ReactNode, type RefObject } from 'react';
 import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
 export interface RepeaterListProps {
@@ -15,5 +15,6 @@ export interface RepeaterListProps {
     onMove: (from: number, to: number) => void;
     onRemove: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
+    focusFallbackRef?: RefObject<HTMLButtonElement | null>;
 }
-export declare function RepeaterList({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, }: RepeaterListProps): ReactNode;
+export declare function RepeaterList({ config, backend, basePath, items, minItems, onMove, onRemove, renderChild, focusFallbackRef, }: RepeaterListProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRow.d.ts

@@ -4,9 +4,10 @@
  *
  * Routes non-content item fields into a settings modal in the row header.
  */
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 import type { RepeaterFieldConfig, FieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+import type { RepeaterRowActionFocusTarget } from './RepeaterRowActions';
 export interface RepeaterRowProps {
     id: string;
     index: number;
@@ -15,9 +16,11 @@ export interface RepeaterRowProps {
     basePath: string;
     itemsLength: number;
     minItems: number;
-    onMove: (from: number, to: number) => void;
+    containerWidth: number;
+    onMove: (from: number, to: number, focusTarget: RepeaterRowActionFocusTarget) => void;
     onRemove: (index: number) => void;
     renderChild: (field: FieldConfig, path: string) => ReactNode;
     canDrag: boolean;
+    actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
 }
-export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, onMove, onRemove, renderChild, canDrag, }: RepeaterRowProps): ReactNode;
+export declare function RepeaterRow({ id, index, config, backend, basePath, itemsLength, minItems, containerWidth, onMove, onRemove, renderChild, canDrag, actionControlRefs, }: RepeaterRowProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/components/RepeaterRowActions.d.ts

@@ -1,16 +1,21 @@
 /**
- * Repeater row action buttons - move up/down, delete
+ * Repeater row action controls - direct reorder buttons plus compact menu.
  */
-import type { ReactNode } from 'react';
+import type { ReactNode, Ref } from 'react';
 export interface RepeaterRowActionsProps {
     index: number;
     itemsLength: number;
     minItems: number;
+    containerWidth?: number;
+    actionPresentation?: 'auto' | 'wide' | 'compact';
+    itemLabel: string;
     onMoveUp: () => void;
     onMoveDown: () => void;
     onRemove: () => void;
+    actionControlRefs?: Partial<Record<RepeaterRowActionFocusTarget, Ref<HTMLButtonElement>>>;
     showReorderActions?: boolean;
     disableMoveUp?: boolean;
     disableMoveDown?: boolean;
 }
-export declare function RepeaterRowActions({ index, itemsLength, minItems, onMoveUp, onMoveDown, onRemove, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): ReactNode;
+export type RepeaterRowActionFocusTarget = 'moveEarlier' | 'moveLater' | 'menu';
+export declare function RepeaterRowActions({ index, itemsLength, minItems, containerWidth, actionPresentation, itemLabel, onMoveUp, onMoveDown, onRemove, actionControlRefs, showReorderActions, disableMoveUp, disableMoveDown, }: RepeaterRowActionsProps): ReactNode;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/index.d.ts

@@ -1,6 +1,6 @@
 export { useRepeaterVisibility } from './useRepeaterVisibility';
 export { useRepeaterRowErrors, type RowFieldError } from './useRepeaterRowErrors';
-export { useResolvedItemLabel } from './useResolvedItemLabel';
+export { useResolvedItemLabel, useResolvedRepeaterItemLabel, type ResolvedRepeaterItemLabel, } from './useResolvedItemLabel';
 export { useLayoutGridCapacity } from './useLayoutGridCapacity';
 export { useLinearRepeaterDnd, type LinearRepeaterSortingStrategyKind } from './useLinearRepeaterDnd';
 export { useRepeaterPointerDragCapability } from './useRepeaterPointerDragCapability';

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useLinearRepeaterDnd.d.ts

@@ -10,6 +10,7 @@ interface UseLinearRepeaterDndInput {
 }
 export interface UseLinearRepeaterDndResult {
     containerRef: ReturnType<typeof useRepeaterPointerDragCapability>['containerRef'];
+    containerWidth: ReturnType<typeof useRepeaterPointerDragCapability>['containerWidth'];
     breakpoint: ReturnType<typeof useRepeaterPointerDragCapability>['breakpoint'];
     pointerDragCapability: ReturnType<typeof useRepeaterPointerDragCapability>['pointerDragCapability'];
     canUsePointerDrag: boolean;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useRepeaterPointerDragCapability.d.ts

@@ -3,6 +3,7 @@ import { resolveRepeaterGridBreakpointForWidth } from '../../../../../blocks/src
 import { type RepeaterPointerDragCapability } from '../utils';
 export interface UseRepeaterPointerDragCapabilityResult {
     containerRef: RefObject<HTMLDivElement | null>;
+    containerWidth: number;
     breakpoint: ReturnType<typeof resolveRepeaterGridBreakpointForWidth>;
     pointerDragCapability: RepeaterPointerDragCapability;
     canUsePointerDrag: boolean;

package/dist/_dts/block-form/src/widgets/RepeaterField/hooks/useResolvedItemLabel.d.ts

@@ -1,5 +1,11 @@
 import type { RepeaterFieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+import { type RepeaterLabelSource } from '../utils';
+export type ResolvedRepeaterItemLabel = {
+    label: string;
+    sourceFieldId?: string;
+    labelSource: RepeaterLabelSource;
+};
 /**
  * Resolves a display label for a repeater item.
  *
@@ -10,3 +16,4 @@ import type { FormBackend } from '../../../backend/types';
  * is returned.
  */
 export declare function useResolvedItemLabel(config: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;
+export declare function useResolvedRepeaterItemLabel(config: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): ResolvedRepeaterItemLabel;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/buildSummary.d.ts

@@ -4,4 +4,5 @@
  */
 import type { RepeaterFieldConfig } from '../../../fields/types';
 import type { FormBackend } from '../../../backend/types';
+export declare const DEFAULT_REPEATER_SUMMARY_MAX_CHARS = 96;
 export declare function buildSummary(field: RepeaterFieldConfig, index: number, backend: FormBackend, basePath: string): string;

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/index.d.ts

@@ -1,8 +1,10 @@
 export { createDefaultItem } from './createDefaultItem';
 export { buildItemLabel } from './buildItemLabel';
-export { buildSummary } from './buildSummary';
+export { buildSummary, DEFAULT_REPEATER_SUMMARY_MAX_CHARS, } from './buildSummary';
 export { getRepeaterItemFields } from './getRepeaterItemFields';
 export { getRepeaterItemFieldGroups } from './getRepeaterItemFieldGroups';
+export { resolveRepeaterLabelSource, type RepeaterLabelSource, } from './repeaterLabelSource';
+export { REPEATER_ROW_COMPACT_ACTIONS_WIDTH, isRepeaterRowActionDisabled, resolveRepeaterRowActionRenderPlan, type RepeaterRowActionAvailability, type RepeaterRowActionId, type RepeaterRowActionMenu, type RepeaterRowMenuAction, type RepeaterRowActionPresentation, type RepeaterRowActionRenderPlan, } from './repeaterRowActionsDomain';
 export { areLayoutGridCapacityContextsEqual } from './layoutGridCapacityContext';
 export { handleLinearRepeaterDragEnd, resolveLinearRepeaterMoveIntent, resolveRepeaterPointerDragCapability, type LinearRepeaterDragEndEvent, type LinearRepeaterMoveIntent, type RepeaterPointerDragCapability, } from './repeaterDndDomain';
 export { resolveRepeaterPresentation } from './repeaterPresentation';

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/repeaterDndDomain.d.ts

@@ -5,7 +5,7 @@ export type RepeaterPointerDragCapability = {
 } | {
     kind: 'disabled';
     breakpoint: RepeaterGridBreakpoint;
-    reason: 'insufficient-items' | 'small-breakpoint' | 'coarse-pointer';
+    reason: 'insufficient-items' | 'coarse-pointer';
 };
 export type LinearRepeaterMoveIntent = {
     kind: 'none';

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/repeaterLabelSource.d.ts

@@ -0,0 +1,15 @@
+import type { FieldConfig, RepeaterFieldConfig } from '../../../fields/types';
+export type RepeaterLabelSource = {
+    kind: 'field';
+    fieldId: string;
+    source: 'explicit' | 'auto';
+} | {
+    kind: 'none';
+};
+type RepeaterItemValue = Record<string, unknown>;
+export declare function resolveRepeaterLabelSource(input: {
+    config: Pick<RepeaterFieldConfig, 'itemLabelSource'>;
+    fields: readonly FieldConfig[];
+    itemValue: RepeaterItemValue | null;
+}): RepeaterLabelSource;
+export {};

package/dist/_dts/block-form/src/widgets/RepeaterField/utils/repeaterRowActionsDomain.d.ts

@@ -0,0 +1,50 @@
+export declare const REPEATER_ROW_COMPACT_ACTIONS_WIDTH = 640;
+export type RepeaterRowActionId = 'moveEarlier' | 'moveLater' | 'delete';
+export type RepeaterRowActionAvailability = {
+    kind: 'enabled';
+} | {
+    kind: 'disabled';
+    reason: 'first-item' | 'last-item' | 'minimum-items' | 'unavailable';
+};
+export type RepeaterRowMenuAction = {
+    id: RepeaterRowActionId;
+    availability: RepeaterRowActionAvailability;
+};
+export type RepeaterRowActionMenu = {
+    kind: 'hidden';
+} | {
+    kind: 'visible';
+    actions: readonly RepeaterRowMenuAction[];
+};
+export type RepeaterRowActionPresentation = {
+    kind: 'wide';
+    moveEarlier: RepeaterRowActionAvailability;
+    moveLater: RepeaterRowActionAvailability;
+    menu: RepeaterRowActionMenu;
+} | {
+    kind: 'compact';
+    moveEarlier: RepeaterRowActionAvailability;
+    moveLater: RepeaterRowActionAvailability;
+    menu: RepeaterRowActionMenu;
+};
+export type RepeaterRowActionPresentationInput = {
+    containerWidth?: number;
+    index: number;
+    itemsLength: number;
+    minItems: number;
+    actionPresentation?: 'auto' | 'wide' | 'compact';
+};
+export type RepeaterRowActionRenderPlanInput = RepeaterRowActionPresentationInput & {
+    showReorderActions?: boolean;
+    disableMoveUp?: boolean;
+    disableMoveDown?: boolean;
+};
+export type RepeaterRowActionRenderPlan = {
+    kind: RepeaterRowActionPresentation['kind'];
+    showDirectMoveActions: boolean;
+    moveEarlier: RepeaterRowActionAvailability;
+    moveLater: RepeaterRowActionAvailability;
+    menu: RepeaterRowActionMenu;
+};
+export declare function isRepeaterRowActionDisabled(availability: RepeaterRowActionAvailability): boolean;
+export declare function resolveRepeaterRowActionRenderPlan(input: RepeaterRowActionRenderPlanInput): RepeaterRowActionRenderPlan;