@phis/ui 0.3.0 → 0.4.1

package/plugins/runtime-modules/core/widgets/entry-header/config.js

@@ -1,3 +1,4 @@
+import { PHI_CORE_RUNTIME_DATA_PROVIDER_KEYS } from "../../../../../constants/core-data-provider-keys";
 import { isPhiRecord } from "../../../../../helpers/is-record";
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
 import { readPhiContentEntryRecordBinding } from "../../../../../helpers/content-entry-record-binding";
@@ -32,7 +33,13 @@ export const PHI_ENTRY_HEADER_WIDGET_DEFINITION = {
     icon: "antd:profile",
     slotSizePolicy: "fill-inline",
     fields: [
-        { key: "entry", type: "data-provider", providerKind: "record", label: "Entry" },
+        {
+            key: "entry",
+            type: "data-provider",
+            providerKind: "record",
+            providerKey: PHI_CORE_RUNTIME_DATA_PROVIDER_KEYS.contentEntry,
+            label: "Entry",
+        },
         { key: "show", type: "flags", label: "Show", options: phiContentEntryPartOptions(PHI_ENTRY_HEADER_PARTS) },
         {
             key: "titleLevel",

package/plugins/runtime-modules/core/widgets/entry-list/client.d.ts

@@ -1,4 +1,5 @@
 import { type PhiMarkdownBlock } from "../../../../../components/widgets/shared/markdown-body-client";
+import type { PhiSequenceSettings } from "../../../../../components/widgets/config/sequence-settings";
 import type { PhiEntryListPresentation } from "./config";
 import type { PhiContentEntryReaderLabels } from "../../../../../components/widgets/label-sets/content-entries";
 /**
@@ -53,6 +54,8 @@ export type PhiEntryListWidgetClientProps = {
     parts: number;
     /** The list's own heading, drawn only above entries -- an empty related list leaves no heading behind. */
     title?: string;
+    /** How a slideshow moves; only a slideshow is handed one. */
+    sequence?: PhiSequenceSettings;
     /** Whether no entries is said or simply nothing: a related list under an entry says nothing. */
     emptyBehavior?: "say" | "hide";
 };
@@ -92,4 +95,4 @@ export declare function PhiEntryBody({ entry, parts, labels, }: {
  * through one: the Controls are where antd lives, and a server component cannot use them. Nothing here
  * depends on the visitor, so the first paint already carries every entry.
  */
-export declare function PhiEntryListWidgetClient({ entries, labels, presentation, parts, title, emptyBehavior, }: PhiEntryListWidgetClientProps): import("react").JSX.Element | null;
+export declare function PhiEntryListWidgetClient({ entries, labels, presentation, parts, title, sequence, emptyBehavior, }: PhiEntryListWidgetClientProps): import("react").JSX.Element | null;

package/plugins/runtime-modules/core/widgets/entry-list/client.js

@@ -10,6 +10,7 @@ import { PhiLink } from "../../../../../components/navigation/phi-link";
 import { PhiMarkdownWidgetClient, } from "../../../../../components/widgets/shared/markdown-body-client";
 import { PhiCollectionLayoutControl } from "../../../../../components/controls/phi-collection-layout-control";
 import { PhiCardWidgetClient } from "../../../../../components/widgets/shared/card-body-client";
+import { PhiSequenceRun } from "../../../../../components/motion/phi-sequence-run";
 import { PHI_SURFACE_CARD } from "../../../../../helpers/surface-presets";
 import { PHI_FONT_SIZE, PHI_SPACE } from "../../../../../theme/antd-css-var-contract";
 import { hasPhiContentEntryPart, PhiContentEntryPart } from "../../../../../constants/content-entry-parts";
@@ -113,7 +114,7 @@ function PhiEntryArticle({ entry, labels, parts, }) {
  * through one: the Controls are where antd lives, and a server component cannot use them. Nothing here
  * depends on the visitor, so the first paint already carries every entry.
  */
-export function PhiEntryListWidgetClient({ entries, labels, presentation, parts, title, emptyBehavior = "say", }) {
+export function PhiEntryListWidgetClient({ entries, labels, presentation, parts, title, sequence, emptyBehavior = "say", }) {
     if (entries.length === 0) {
         if (emptyBehavior === "hide")
             return null;
@@ -125,6 +126,6 @@ export function PhiEntryListWidgetClient({ entries, labels, presentation, parts,
      * Still an `h2`, in the rule, so the Page's outline keeps it.
      */
     const heading = title ? (_jsx(PhiDividerControl, { titlePlacement: "start", style: { margin: 0 }, children: _jsx(PhiTypographyControl, { presentation: "title", level: 2, style: { margin: 0, fontSize: PHI_FONT_SIZE.lg }, children: title }) })) : null;
-    const body = presentation === "cards" ? (_jsx(PhiCollectionLayoutControl, { mode: "grid", gap: PHI_SPACE.base, minColumnWidth: ENTRY_CARD_MIN_COLUMN_WIDTH, items: entries.map((entry) => _jsx(PhiEntryCard, { entry: entry, parts: parts }, entry.id)) })) : presentation === "compact" ? (_jsx(PhiFlexControl, { vertical: true, gap: PHI_SPACE.base, children: entries.map((entry) => _jsx(PhiEntryLine, { entry: entry, parts: parts }, entry.id)) })) : (_jsx(PhiFlexControl, { vertical: true, gap: PHI_SPACE.lg, children: entries.map((entry, index) => (_jsxs(PhiFlexControl, { vertical: true, gap: PHI_SPACE.lg, children: [index > 0 ? _jsx(PhiDividerControl, { style: { margin: 0 } }) : null, _jsx(PhiEntryArticle, { entry: entry, labels: labels, parts: parts })] }, entry.id))) }));
+    const body = presentation === "slideshow" ? (_jsx(PhiSequenceRun, { items: entries.map((entry) => _jsx(PhiEntryCard, { entry: entry, parts: parts }, entry.id)), settings: sequence, labels: labels.sequence })) : presentation === "cards" ? (_jsx(PhiCollectionLayoutControl, { mode: "grid", gap: PHI_SPACE.base, minColumnWidth: ENTRY_CARD_MIN_COLUMN_WIDTH, items: entries.map((entry) => _jsx(PhiEntryCard, { entry: entry, parts: parts }, entry.id)) })) : presentation === "compact" ? (_jsx(PhiFlexControl, { vertical: true, gap: PHI_SPACE.base, children: entries.map((entry) => _jsx(PhiEntryLine, { entry: entry, parts: parts }, entry.id)) })) : (_jsx(PhiFlexControl, { vertical: true, gap: PHI_SPACE.lg, children: entries.map((entry, index) => (_jsxs(PhiFlexControl, { vertical: true, gap: PHI_SPACE.lg, children: [index > 0 ? _jsx(PhiDividerControl, { style: { margin: 0 } }) : null, _jsx(PhiEntryArticle, { entry: entry, labels: labels, parts: parts })] }, entry.id))) }));
     return heading ? (_jsxs(PhiFlexControl, { vertical: true, gap: PHI_SPACE.base, children: [heading, body] })) : body;
 }

package/plugins/runtime-modules/core/widgets/entry-list/config.d.ts

@@ -1,4 +1,5 @@
 import { type PhiRuntimeDataProviderBinding } from "../../../../../types/runtime-data-provider";
+import { type PhiSequenceSettings } from "../../../../../components/widgets/config/sequence-settings";
 import { type PhiContentEntryKind } from "../../../../../constants/content-entry-kinds";
 import { type PhiLinkTarget } from "../../../../../types/references";
 import { PHI_ENTRY_LIST_DEFAULT_PARTS } from "../../../../../constants/content-entry-parts";
@@ -6,9 +7,10 @@ import { type PhiCmsWidgetConfigBase } from "../../../../../components/widgets/c
 /**
  * How the entries stand on the page (`CONTENT_ENTRIES.md`): `stack` is each entry whole, one under the
  * next; `cards` a grid of cards, each leading to its entry's detail Page; `compact` one line of date and
- * title with a teaser under it, for a sidebar or a home page.
+ * title with a teaser under it, for a sidebar or a home page; `slideshow` the same cards a few at a
+ * time, moving the way a Gallery moves (`sequence-settings.ts`).
  */
-export declare const PHI_ENTRY_LIST_PRESENTATIONS: readonly ["stack", "cards", "compact"];
+export declare const PHI_ENTRY_LIST_PRESENTATIONS: readonly ["stack", "cards", "compact", "slideshow"];
 export type PhiEntryListPresentation = (typeof PHI_ENTRY_LIST_PRESENTATIONS)[number];
 /**
  * Where the entries come from: the newest of the kind, or the ones closest to one entry -- a "more like
@@ -19,7 +21,7 @@ export type PhiEntryListSource = (typeof PHI_ENTRY_LIST_SOURCES)[number];
 export { PHI_ENTRY_LIST_DEFAULT_PARTS };
 /** As many as a page can carry without becoming an archive, which is a later address. */
 export declare const PHI_ENTRY_LIST_DEFAULT_LIMIT = 10;
-export type PhiEntryListWidgetConfig = PhiCmsWidgetConfigBase & {
+export type PhiEntryListWidgetConfig = PhiCmsWidgetConfigBase & PhiSequenceSettings & {
     /** Which content kind's entries (`CONTENT_ENTRIES.md`). */
     kind: PhiContentEntryKind;
     /**
@@ -70,45 +72,336 @@ export declare const PHI_ENTRY_LIST_WIDGET_DEFINITION: {
     translatesOwnText: true;
     icon: string;
     slotSizePolicy: "fill-inline";
-    fields: ({
+    fields: (({
         key: string;
-        type: "choice";
         label: string;
-        options: {
-            value: string;
-            label: string;
-        }[];
-        heading?: undefined;
-        description?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-        visibleWhen?: undefined;
-        providerKind?: undefined;
-    } | {
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "string" | "url" | "icon";
+        emptyValue?: "";
+    }) | ({
         key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
         type: "link-target";
-        heading: string;
-        label: string;
-        options?: undefined;
-        description?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-        visibleWhen?: undefined;
-        providerKind?: undefined;
-    } | {
+        clearsWhenEmpty?: readonly string[];
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "readonly";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "data-provider";
+        providerKind?: import("../../../../../types").PhiRuntimeDataProviderKind;
+        providerKey?: import("@phis/contracts/controls").PhiRuntimeDataProviderKey;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "calendar-adapter";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "video-provider";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "dimension";
+        widthKey?: string;
+        heightKey?: string;
+        widthPlaceholder?: string;
+        heightPlaceholder?: string;
+        patchOnChange?: Record<string, unknown>;
+    }) | ({
         key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "length";
+        min?: number;
+        max?: number;
+        step?: number;
+        precision?: number;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "radius";
+        topLeftKey: string;
+        topRightKey: string;
+        bottomLeftKey: string;
+        bottomRightKey: string;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "padding";
+        paddingKey?: string;
+        gapKey?: string;
+        paddingTopKey?: string;
+        paddingRightKey?: string;
+        paddingBottomKey?: string;
+        paddingLeftKey?: string;
+        section?: string;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "color";
+        mode?: import("../../../../../types").PhiCmsConfigFieldColorMode;
+        defaultToken?: import("../../../../../theme/phi-theme-tokens").PhiThemeTokenKey;
+        section?: string;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "boolean";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "image";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "slot-texts";
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "number-list";
+        min?: number;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "flags";
+        options: readonly {
+            value: number;
+            label: string;
+        }[];
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
         type: "number";
+        min?: number;
+        max?: number;
+        step?: number;
+        precision?: number;
+        prefix?: string;
+        presentation?: "slider";
+        suffix?: string;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "choice";
+        valueType: "number";
+        options: import("@phis/contracts/controls").PhiControlOption<number>[];
+        emptyOption?: import("@phis/contracts/controls").PhiControlOption;
+        emptyValue?: null | undefined;
+        placeholder?: string;
+        mode?: never;
+        presentation?: never;
+        optionsProvider?: never;
+        allowCustom?: never;
+        createBehavior?: never;
+        filter?: never;
+        patchOnChange?: never;
+        optionPresets?: never;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "choice";
+        mode?: import("../../../../../types").PhiCmsConfigFieldChoiceMode;
+        valueType?: Exclude<import("../../../../../types").PhiCmsConfigFieldChoiceValueType, "number">;
+        presentation?: import("../../../../../types").PhiCmsConfigFieldChoicePresentation;
+        options?: import("@phis/contracts/controls").PhiControlOption[];
+        optionsProvider?: import("@phis/contracts/controls").PhiControlOptionsProviderConfig;
+        allowCustom?: boolean;
+        createBehavior?: import("../../../../../types").PhiCmsConfigFieldChoiceCreateBehavior;
+        placeholder?: string;
+        filter?: import("../../../../../types").PhiCmsConfigFieldChoiceFilter;
+        emptyOption?: import("@phis/contracts/controls").PhiControlOption;
+        emptyValue?: null | undefined;
+        patchOnChange?: Record<string, unknown>;
+        optionPresets?: import("../../../../../types/cms-plugins").PhiCmsConfigFieldOptionPresets;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "collection";
+        itemKeyField: string;
+        itemLabelField?: string;
+        itemFields: import("../../../../../types").PhiCmsConfigField[];
+        defaultItem?: Record<string, unknown>;
+        addLabel?: string;
+        emptyLabel?: string;
+        minItems?: number;
+        maxItems?: number;
+        reorderable?: boolean;
+        presentation?: import("../../../../../types").PhiCmsConfigFieldCollectionPresentation;
+        editLabel?: string;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "background";
+        section?: string;
+        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "border";
+        section?: string;
+        storage?: import("../../../../../types").PhiCmsConfigFieldValueStorage;
+    }) | ({
+        key: string;
+        label: string;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "surface";
+        tone?: false;
+    }) | ({
+        key: string;
         label: string;
-        description: string;
-        options?: undefined;
-        heading?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-        visibleWhen?: undefined;
-        providerKind?: undefined;
+        description?: string;
+        required?: boolean;
+        editorPlacement?: "inspector" | "geometry" | "toolbar";
+        visibleWhen?: import("../../../../../types").PhiCmsConfigFieldVisibilityRule | readonly import("../../../../../types").PhiCmsConfigFieldVisibilityRule[];
+        heading?: string;
+    } & {
+        type: "shadow" | "grid-placement" | "column-count";
+        section?: string;
+    }) | {
+        key: string;
+        type: "choice";
+        label: string;
+        options: {
+            value: "news" | "blog";
+            label: "news" | "blog";
+        }[];
     } | {
         key: string;
         type: "flags";
@@ -138,64 +431,70 @@ export declare const PHI_ENTRY_LIST_WIDGET_DEFINITION: {
             readonly value: number;
             readonly label: "Link";
         })[];
-        heading?: undefined;
-        description?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-        visibleWhen?: undefined;
-        providerKind?: undefined;
-    } | {
-        key: string;
-        type: "choice";
-        mode: "multiple";
-        label: string;
-        description: string;
-        placeholder: string;
-        optionsProvider: {
-            providerKey: `${string}/${string}`;
-            params: {
-                noneValue: string;
-                categoryNoneLabel: string;
-            };
-        };
-        visibleWhen: {
-            field: string;
-            notEquals: string;
-            equals?: undefined;
-        };
-        options?: undefined;
-        heading?: undefined;
-        providerKind?: undefined;
-    } | {
-        key: string;
-        type: "data-provider";
-        providerKind: "record";
-        label: string;
-        description: string;
-        visibleWhen: {
-            field: string;
-            equals: string;
-            notEquals?: undefined;
-        };
-        options?: undefined;
-        heading?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-    } | {
-        key: string;
-        type: "string";
-        label: string;
-        options?: undefined;
-        heading?: undefined;
-        description?: undefined;
-        mode?: undefined;
-        placeholder?: undefined;
-        optionsProvider?: undefined;
-        visibleWhen?: undefined;
-        providerKind?: undefined;
     })[];
-    defaultConfig: PhiEntryListWidgetConfig;
+    defaultConfig: {
+        visibleCount: 1;
+        transition: "slide";
+        durationMs: 320;
+        easing: "linear" | "ease" | "ease-in" | "ease-out" | "ease-in-out";
+        gap: "xs";
+        lookahead: 1;
+        mountPolicy: "lazy-keep";
+        controls: "both";
+        loop: false;
+        autoplayMs: 0;
+        renderMode?: import("../../../../../types").PhiRenderableBlockRenderMode;
+        visibility?: import("../../../../../types").PhiRenderableBlockVisibility;
+        accessPolicy?: import("@phis/contracts/access").PhiViewerAccessPolicy;
+        viewportFlags?: import("../../../../../types").PhiViewportFlags;
+        enabled?: boolean;
+        debugMode?: boolean;
+        anchor?: import("../../../../../types").PhiRenderableBlockAnchor;
+        zIndex?: number;
+        opacity?: number;
+        surface?: import("../../../../../types/surface").PhiSurface;
+        className?: string;
+        size?: import("../../../../../types").PhiRenderableBlockResponsiveSize;
+        minSize?: import("../../../../../types").PhiRenderableBlockResponsiveSize;
+        maxSize?: import("../../../../../types").PhiRenderableBlockResponsiveSize;
+        collapsedSizeHint?: import("../../../../../types").PhiRenderableBlockSize;
+        effects?: import("../../../../../types").PhiRenderableBlockEffects;
+        /** Which content kind's entries (`CONTENT_ENTRIES.md`). */
+        kind: PhiContentEntryKind;
+        /**
+         * Where an entry's title leads: the kind's detail route, a Page target the slug fills per entry
+         * (REFERENCES.md). Absent, or a route that does not resolve, and the titles are not links.
+         */
+        detailLinkTarget?: PhiLinkTarget;
+        presentation: PhiEntryListPresentation;
+        /**
+         * How many entries at most.
+         *
+         * A ceiling in the Widget rather than a page parameter: what a Site shows on its list page is a
+         * decision it makes once in the Builder, and a visitor who could ask for five hundred entries would be
+         * asking the server to render them.
+         */
+        limit: number;
+        /** Which parts of each entry show (`constants/content-entry-parts.ts`). */
+        show: number;
+        source: PhiEntryListSource;
+        /**
+         * Which categories a `latest` list shows, by id, and `none` for the entries filed under no category;
+         * empty is every entry. An id whose category was deleted since filters nothing -- it is left standing
+         * rather than swept, and a list left with only such ids shows every entry again.
+         *
+         * By id, not by address: a category renamed or given another address is still the one the list was
+         * set to (REFERENCES.md says the same of Pages).
+         */
+        categories: string[];
+        /**
+         * The entry a `related` list is about, as a record binding (`types/record-provider.ts`) -- the one the
+         * header and text above it are bound to, so the three share one read. A detail route's tree writes the
+         * route's slug into it; a list with no entry to be related to shows nothing.
+         */
+        relatedTo: PhiRuntimeDataProviderBinding | null;
+        /** A heading drawn above the entries, and only where there are any; empty for none. */
+        title: string;
+    };
     parseConfig: typeof parsePhiEntryListWidgetConfig;
 };

package/plugins/runtime-modules/core/widgets/entry-list/config.js

@@ -1,5 +1,6 @@
 import { readPhiRuntimeDataProviderBinding, } from "../../../../../types/runtime-data-provider";
 import { isPhiRecord } from "../../../../../helpers/is-record";
+import { buildPhiSequenceSettingsFields, PHI_SEQUENCE_SETTINGS_DEFAULTS, readPhiSequenceSettings, } from "../../../../../components/widgets/config/sequence-settings";
 import { resolvePhiCmsWidgetPluginKey } from "../../../../../constants/cms-widget-types";
 import { PHI_CORE_RUNTIME_DATA_PROVIDER_KEYS } from "../../../../../constants/core-data-provider-keys";
 import { PHI_CONTENT_ENTRY_CURATION_NONE_CONFIG_KEYS } from "../../../../../components/forms/content-entry-curation-config";
@@ -10,9 +11,10 @@ import { readInteger, readRenderableBlockConfig, } from "../../../../../componen
 /**
  * How the entries stand on the page (`CONTENT_ENTRIES.md`): `stack` is each entry whole, one under the
  * next; `cards` a grid of cards, each leading to its entry's detail Page; `compact` one line of date and
- * title with a teaser under it, for a sidebar or a home page.
+ * title with a teaser under it, for a sidebar or a home page; `slideshow` the same cards a few at a
+ * time, moving the way a Gallery moves (`sequence-settings.ts`).
  */
-export const PHI_ENTRY_LIST_PRESENTATIONS = ["stack", "cards", "compact"];
+export const PHI_ENTRY_LIST_PRESENTATIONS = ["stack", "cards", "compact", "slideshow"];
 /**
  * Where the entries come from: the newest of the kind, or the ones closest to one entry -- a "more like
  * this" list under a detail Page, bound to that entry's record in `relatedTo`.
@@ -43,12 +45,23 @@ function readLimit(value) {
     }
     return Math.min(limit, PHI_ENTRY_LIST_MAX_LIMIT);
 }
+function failSequence(key, value, expected) {
+    throw new Error(`Invalid Entries ${key} ${JSON.stringify(value)}. Expected ${expected}.`);
+}
+/** A slideshow's settings, shown only while the list is one. */
+const PHI_ENTRY_LIST_SEQUENCE_FIELDS = buildPhiSequenceSettingsFields({
+    countLabel: "Visible Entries",
+    heading: "Slideshow",
+    visibleWhen: { field: "presentation", equals: "slideshow" },
+});
 export function normalizePhiEntryListWidgetConfig(config) {
     const raw = isPhiRecord(config)
         ? config
         : {};
     return {
         ...readRenderableBlockConfig(raw),
+        // Read strictly, as the Gallery reads them: a run that moves other than written is a quiet mistake.
+        ...readPhiSequenceSettings(raw, failSequence),
         // A new list shows News until somebody picks its kind in the Inspector.
         kind: isPhiContentEntryKind(raw.kind) ? raw.kind : "news",
         detailLinkTarget: readPhiLinkTarget(raw.detailLinkTarget) ?? undefined,
@@ -97,6 +110,7 @@ export const PHI_ENTRY_LIST_WIDGET_DEFINITION = {
                 { value: "stack", label: "Whole entries" },
                 { value: "cards", label: "Cards" },
                 { value: "compact", label: "Compact" },
+                { value: "slideshow", label: "Slideshow" },
             ],
         },
         {
@@ -142,12 +156,16 @@ export const PHI_ENTRY_LIST_WIDGET_DEFINITION = {
             key: "relatedTo",
             type: "data-provider",
             providerKind: "record",
+            providerKey: PHI_CORE_RUNTIME_DATA_PROVIDER_KEYS.contentEntry,
             label: "Related to",
             description: "The entry; a detail Page binds it to its own.",
             visibleWhen: { field: "source", equals: "related" },
         },
         { key: "title", type: "string", label: "Heading" },
+        ...PHI_ENTRY_LIST_SEQUENCE_FIELDS.window,
+        ...PHI_ENTRY_LIST_SEQUENCE_FIELDS.movement,
+        ...PHI_ENTRY_LIST_SEQUENCE_FIELDS.controls,
     ],
-    defaultConfig: normalizePhiEntryListWidgetConfig(null),
+    defaultConfig: { ...normalizePhiEntryListWidgetConfig(null), ...PHI_SEQUENCE_SETTINGS_DEFAULTS },
     parseConfig: parsePhiEntryListWidgetConfig,
 };