@happyvertical/smrt-content 0.44.1 → 0.45.0

package/dist/svelte/components/ContentList.svelte

@@ -50,6 +50,11 @@ import {
   readContentListLifecycleSummary,
   reconcileContentListLifecycleSelection,
 } from '../content-list-lifecycle.js';
+import {
+  registerContentListDataSurface,
+  type ContentListSurfaceContext,
+  type ContentListSurfaceHandle,
+} from '../content-list-data-surface.js';
 import {
   applyContentListFilter,
   buildContentListColumns,
@@ -133,6 +138,104 @@ import ImageThumbnail from './ImageThumbnail.svelte';
 
 const { t } = useI18n();
 
+const DEFAULT_CONTENT_LIST_SURFACE_IDENTITY: DataSurfaceIdentity = {
+  surfaceId: 'content-list',
+  kind: 'table',
+};
+
+function sameSurfaceIdentity(
+  left: DataSurfaceIdentity,
+  right: DataSurfaceIdentity,
+): boolean {
+  return (
+    left.kind === right.kind &&
+    left.surfaceId === right.surfaceId &&
+    left.subject?.type === right.subject?.type &&
+    left.subject?.id === right.subject?.id
+  );
+}
+
+function resolveSurfaceAuthority(
+  lifecycle: ContentListLifecycleBinding | undefined,
+  workflows: ContentListWorkflowBinding | undefined,
+): {
+  identity?: DataSurfaceIdentity;
+  maxSelectionSize?: number;
+  lifecycle?: ContentListLifecycleBinding;
+  workflows?: ContentListWorkflowBinding;
+} {
+  const lifecycleIdentity = lifecycle
+    ? (lifecycle.identity ?? DEFAULT_CONTENT_LIST_SURFACE_IDENTITY)
+    : undefined;
+  const workflowIdentity = workflows
+    ? (workflows.identity ?? DEFAULT_CONTENT_LIST_SURFACE_IDENTITY)
+    : undefined;
+  if (
+    lifecycleIdentity &&
+    workflowIdentity &&
+    !sameSurfaceIdentity(lifecycleIdentity, workflowIdentity)
+  ) {
+    throw new Error(
+      'ContentList lifecycle and workflow bindings must use the same data surface identity',
+    );
+  }
+  const bindings = [lifecycle, workflows].filter(
+    (binding): binding is ContentListLifecycleBinding | ContentListWorkflowBinding =>
+      binding !== undefined,
+  );
+  const maxSelectionSize =
+    bindings.length > 0
+      ? Math.min(...bindings.map((binding) => binding.maxSelectionSize ?? 200))
+      : undefined;
+  return {
+    ...(lifecycleIdentity ?? workflowIdentity
+      ? { identity: lifecycleIdentity ?? workflowIdentity }
+      : {}),
+    ...(maxSelectionSize === undefined ? {} : { maxSelectionSize }),
+    ...(lifecycle && lifecycleIdentity
+      ? {
+          lifecycle: {
+            ...lifecycle,
+            identity: lifecycleIdentity,
+            ...(maxSelectionSize === undefined ? {} : { maxSelectionSize }),
+          },
+        }
+      : {}),
+    ...(workflows && workflowIdentity
+      ? {
+          workflows: {
+            ...workflows,
+            identity: workflowIdentity,
+            ...(maxSelectionSize === undefined ? {} : { maxSelectionSize }),
+          },
+        }
+      : {}),
+  };
+}
+
+function reconcileSurfaceDescriptor(
+  descriptor: import('@happyvertical/smrt-ui/data').DataSurfaceDescriptor,
+  authority: ReturnType<typeof resolveSurfaceAuthority>,
+): import('@happyvertical/smrt-ui/data').DataSurfaceDescriptor {
+  if (
+    authority.identity &&
+    !sameSurfaceIdentity(descriptor.identity, authority.identity)
+  ) {
+    throw new Error(
+      'ContentList custom data surface descriptor must use the lifecycle and workflow identity',
+    );
+  }
+  if (
+    authority.maxSelectionSize !== undefined &&
+    descriptor.limits.maxSelectionSize !== authority.maxSelectionSize
+  ) {
+    throw new Error(
+      'ContentList custom data surface descriptor must use the lifecycle and workflow selection limit',
+    );
+  }
+  return descriptor;
+}
+
 const WORKFLOW_LABEL_MESSAGES: Record<
   ContentListWorkflowId,
   keyof typeof M
@@ -324,7 +427,7 @@ interface Props {
   error?: string | null;
   /** Retry affordance rendered with an error. */
   onRetry?: () => void;
-  /** Opt-in agent addressability. Non-table presentations land with #2456. */
+  /** Opt-in agent addressability shared by every list presentation. */
   dataSurface?: ContentListDataSurface;
   /**
    * Opt-in server-backed rows (#2452). `bind()` is called exactly once, during
@@ -370,6 +473,10 @@ let {
   lifecycleMode = 'active',
 }: Props = $props();
 
+const surfaceAuthority = $derived(
+  resolveSurfaceAuthority(lifecycle, workflows),
+);
+
 const initialQuery = untrack(() => query);
 
 // One controller owns search, filters, sorting, paging, and selection for
@@ -471,6 +578,14 @@ let settledLifecycleQuery = $state<ContentListDataQueryRequest | undefined>(
   undefined,
 );
 let settledLifecycleFingerprint = $state<string | undefined>(undefined);
+let settledSurfaceMetadata = $state<
+  | {
+      signature: string;
+      queryFingerprint: string | null;
+      totalRows: number | null;
+    }
+  | undefined
+>(undefined);
 
 function toSearchParams(
   input: URLSearchParams | string | null | undefined,
@@ -563,6 +678,10 @@ let completedJobs = $state<ContentListJob[]>([]);
 let completedJobsOverflowed = $state(false);
 let activeQueryKey = $state<string | undefined>(undefined);
 let lifecycleRefreshPending = $state(false);
+let surfaceRoot: HTMLDivElement | undefined;
+let surfaceHighlighted = $state(false);
+let surfaceHighlightTimeout: ReturnType<typeof setTimeout> | undefined;
+let surfaceHandle: ContentListSurfaceHandle | undefined;
 
 // Job state is subscribed once so hosts can use a framework-free controller.
 // Only transitions observed after the initial snapshot are completion events;
@@ -924,9 +1043,20 @@ function settleWorkflowQueryResult(
   signature: string,
 ): void {
   settledSignature = signature;
+  const envelope =
+    result !== null && typeof result === 'object' && !Array.isArray(result)
+      ? (result as Record<string, unknown>)
+      : undefined;
+  settledSurfaceMetadata = {
+    signature,
+    queryFingerprint:
+      typeof envelope?.queryFingerprint === 'string'
+        ? envelope.queryFingerprint
+        : null,
+    totalRows: surfaceMetadataTotalRows(envelope?.total),
+  };
   resultNotices = readContentListQueryNotices(result);
-  if (result !== null && typeof result === 'object' && !Array.isArray(result)) {
-    const envelope = result as Record<string, unknown>;
+  if (envelope) {
     settledWorkflowQuery = request;
     settledWorkflowFingerprint =
       typeof envelope.queryFingerprint === 'string'
@@ -947,6 +1077,17 @@ function settleWorkflowQueryResult(
   settledWorkflowRevision = null;
 }
 
+function surfaceMetadataTotalRows(total: unknown): number | null {
+  if (!total || typeof total !== 'object' || Array.isArray(total)) return null;
+  const record = total as Record<string, unknown>;
+  return (record.kind === 'exact' || record.kind === 'estimated') &&
+    typeof record.value === 'number' &&
+    Number.isSafeInteger(record.value) &&
+    record.value >= 0
+    ? record.value
+    : null;
+}
+
 function settleLifecycleResult(
   result: unknown,
   request: ContentListDataQueryRequest | undefined,
@@ -1205,7 +1346,7 @@ const canSelectAllMatching = $derived(
       settledWorkflowRevision &&
       exactMatchingCount !== undefined &&
       exactMatchingCount > 0 &&
-      exactMatchingCount <= (workflows?.maxSelectionSize ?? 200),
+      exactMatchingCount <= (surfaceAuthority.maxSelectionSize ?? 200),
   ),
 );
 const workflowPayloadValid = $derived(
@@ -1385,20 +1526,30 @@ const surfaceOptions = $derived(
     ? {
         registry: dataSurface.registry,
         descriptor:
-          dataSurface.descriptor ??
+          dataSurface.descriptor
+            ? reconcileSurfaceDescriptor(
+                dataSurface.descriptor,
+                surfaceAuthority,
+              )
+            :
           (() => {
             const descriptor = buildContentListSurfaceDescriptor({
               columnLabels,
+              serverBacked: initialQuery !== undefined,
+              lifecycle: lifecycle !== undefined,
+              lifecycleMode,
               includeWorkflows: workflows !== undefined,
+              refresh: queryBinding?.refresh !== undefined,
+              retry: retryHandler !== undefined,
             });
             return {
               ...descriptor,
-              identity: workflows?.identity ?? descriptor.identity,
+              identity: surfaceAuthority.identity ?? descriptor.identity,
               limits: {
                 ...descriptor.limits,
-                ...(workflows?.maxSelectionSize === undefined
+                ...(surfaceAuthority.maxSelectionSize === undefined
                   ? {}
-                  : { maxSelectionSize: workflows.maxSelectionSize }),
+                  : { maxSelectionSize: surfaceAuthority.maxSelectionSize }),
               },
             };
           })(),
@@ -1440,6 +1591,164 @@ const queryWarnings = $derived<ReadonlyArray<string>>(
     boundResultNotices?.warnings ??
     resultNotices.warnings,
 );
+
+function surfaceLastUpdated(value: unknown): string | null {
+  if (value instanceof Date) return value.toISOString();
+  if (typeof value === 'string') return value;
+  if (typeof value === 'number' && Number.isFinite(value)) {
+    return new Date(value).toISOString();
+  }
+  return null;
+}
+
+const matchingSurfaceMetadata = $derived(
+  serverBacked && settledSurfaceMetadata?.signature === querySignature
+    ? settledSurfaceMetadata
+    : undefined,
+);
+
+const surfaceContext = $derived<ContentListSurfaceContext>({
+  viewMode,
+  queryFingerprint: serverBacked
+    ? (matchingSurfaceMetadata?.queryFingerprint ?? null)
+    : null,
+  totalRows: serverBacked
+    ? (matchingSurfaceMetadata?.totalRows ?? null)
+    : Number.isSafeInteger(totalRowCount)
+      ? totalRowCount
+      : null,
+  freshness: {
+    stale,
+    refreshing,
+    offline,
+    lastUpdated: surfaceLastUpdated(lastUpdated),
+    truncated: queryTruncated,
+    warnings: queryWarnings,
+  },
+});
+
+function focusSurface(): void {
+  if (!surfaceRoot) return;
+  surfaceRoot.tabIndex = -1;
+  surfaceRoot.focus();
+}
+
+// ContentList owns the registration so grid, detailed, compact, empty, and
+// loading presentations all expose one stable identity and revision stream.
+// This ref is deliberately non-reactive: registration input changes must
+// advance a stable identity revision, but normal command acknowledgements must
+// not themselves cause a registration teardown/replay window.
+const surfaceRevision = { value: undefined as number | undefined };
+
+function acceptsSurfaceTableCommand(
+  command: import('@happyvertical/smrt-ui/data').DataTableCommand,
+): boolean {
+  if (command.type === 'setPageSize' && serverPageSize !== null) {
+    if (command.pageSize === null || command.pageSize > maxPageSize) return false;
+  }
+  if (command.type === 'setPage') {
+    if (command.page > maxReachablePage) return false;
+    if (
+      tableState.pageSize !== null &&
+      clampableRowCount !== undefined &&
+      // A server binding retains the previous query's exact total until its
+      // replacement settles. That count cannot bound a command for the new
+      // query: it may be smaller, and would reject a valid page before the
+      // new query gets a chance to report its own total.
+      (!serverBacked || settledSignature === querySignature) &&
+      command.page > Math.max(1, Math.ceil(clampableRowCount / tableState.pageSize))
+    )
+      return false;
+  }
+  if (command.type === 'setFilters') {
+    if (
+      lockedType !== null &&
+      !isContentListFilterExactly(
+        { ...tableState, filters: command.filters },
+        CONTENT_LIST_TYPE_FILTER_ID,
+        lockedType,
+      )
+    )
+      return false;
+    if (
+      lifecycleMode === 'trash' &&
+      !isContentListFilterExactly(
+        { ...tableState, filters: command.filters },
+        CONTENT_LIST_STATUS_FILTER_ID,
+        'deleted',
+      )
+    )
+      return false;
+  }
+  return command.type !== 'reset' || (lockedType === null && lifecycleMode !== 'trash');
+}
+
+$effect(() => {
+  const surface = surfaceOptions;
+  if (!surface) {
+    surfaceHandle = undefined;
+    return;
+  }
+  const handle = registerContentListDataSurface({
+    ...surface,
+    controller,
+    context: untrack(() => surfaceContext),
+    initialRevision:
+      surfaceRevision.value === undefined ? 0 : surfaceRevision.value + 1,
+    onRevision: (revision) => {
+      surfaceRevision.value = revision;
+    },
+    acceptsTableCommand: acceptsSurfaceTableCommand,
+    setViewMode: (next) => {
+      viewMode = next;
+    },
+    ...(queryBinding?.refresh
+      ? {
+          refresh: async () => {
+            await refreshQuery();
+            return true;
+          },
+        }
+      : {}),
+    ...(retryHandler
+      ? {
+          retry: async () => {
+            await retryHandler();
+            return true;
+          },
+        }
+      : {}),
+    focus: focusSurface,
+    reveal: () => surfaceRoot?.scrollIntoView({ block: 'nearest' }),
+    highlight: () => {
+      if (surfaceHighlightTimeout !== undefined) {
+        clearTimeout(surfaceHighlightTimeout);
+      }
+      surfaceHighlighted = true;
+      const timeout = setTimeout(() => {
+        if (surfaceHandle === handle) surfaceHighlighted = false;
+        if (surfaceHighlightTimeout === timeout) {
+          surfaceHighlightTimeout = undefined;
+        }
+      }, 1_000);
+      surfaceHighlightTimeout = timeout;
+    },
+  });
+  surfaceHandle = handle;
+  return () => {
+    if (surfaceHandle === handle) surfaceHandle = undefined;
+    if (surfaceHighlightTimeout !== undefined) {
+      clearTimeout(surfaceHighlightTimeout);
+      surfaceHighlightTimeout = undefined;
+    }
+    surfaceHighlighted = false;
+    handle.destroy();
+  };
+});
+
+$effect(() => {
+  surfaceHandle?.update(surfaceContext);
+});
 /** Identity of the current set of refusals, so a dismissal is not permanent. */
 const dropNoticeKey = $derived(
   dropNotices.length > 0 || queryTruncated || queryWarnings.length > 0
@@ -1734,6 +2043,16 @@ function workflowSelection(): ContentListWorkflowRequest['selection'] | null {
   return { scope: 'explicit-ids', rowIds: effectiveRowIds };
 }
 
+function workflowSelectionCount(
+  selection: ContentListWorkflowRequest['selection'],
+): number {
+  if (selection.scope === 'explicit-ids') return selection.rowIds.length;
+  if (selection.scope === 'current-page') return selectablePageRowIds.length;
+  return tableState.selection.scope === 'allMatching'
+    ? tableState.selection.expectedCount
+    : 0;
+}
+
 function workflowJobTarget(
   request: ContentListWorkflowRequest,
 ): ContentListJobTarget {
@@ -1774,6 +2093,8 @@ function createWorkflowRequest(
 ): ContentListWorkflowRequest | null {
   const selection = workflowSelection();
   if (!selection) return null;
+  const selectionCount = workflowSelectionCount(selection);
+  if (selectionCount > (surfaceAuthority.maxSelectionSize ?? 200)) return null;
   const queryRequired = selection.scope !== 'explicit-ids';
   if (
     queryRequired &&
@@ -1786,7 +2107,8 @@ function createWorkflowRequest(
   return {
     version: 1,
     requestId: globalThis.crypto?.randomUUID?.() ?? `content-workflow-${Date.now()}`,
-    identity: workflows?.identity ?? { surfaceId: 'content-list', kind: 'table' },
+    identity:
+      surfaceAuthority.identity ?? DEFAULT_CONTENT_LIST_SURFACE_IDENTITY,
     actionId: selectedWorkflow,
     phase,
     selection,
@@ -1796,10 +2118,7 @@ function createWorkflowRequest(
       ...(queryRequired && settledWorkflowQuery
         ? { query: settledWorkflowQuery }
         : {}),
-      expectedCount:
-        selection.scope === 'explicit-ids'
-          ? selection.rowIds.length
-          : selectedCount,
+      expectedCount: selectionCount,
     },
   };
 }
@@ -2380,7 +2699,11 @@ const tableColumns: DataTableColumn<ContentListRow>[] = $derived([
   </div>
 {/snippet}
 
-<div class="content-list-wrapper">
+<div
+  class="content-list-wrapper"
+  class:data-surface-highlighted={surfaceHighlighted}
+  bind:this={surfaceRoot}
+>
 
   <div class="content-controls">
     <div class="search-filters">
@@ -2726,7 +3049,7 @@ const tableColumns: DataTableColumn<ContentListRow>[] = $derived([
 
     {#if lifecycle}
       <ContentListLifecyclePanel
-        binding={lifecycle}
+        binding={surfaceAuthority.lifecycle ?? lifecycle}
         mode={lifecycleMode}
         selectedRowIds={tableState.selectedRowIds}
         query={lifecycleQuery}
@@ -2855,9 +3178,9 @@ const tableColumns: DataTableColumn<ContentListRow>[] = $derived([
 
     {#if viewMode === 'compact'}
       <!--
-        The compact table stays mounted for empty and loading results: it owns
-        the mounted data surface, so unmounting it on a zero-row query would
-        unregister the surface and leave an agent unable to undo its own search.
+        The compact table stays mounted for empty and loading results so its
+        table semantics and operator affordances remain stable across queries.
+        ContentList itself owns the agent-addressable surface in every view.
       -->
       <div class="content-table-wrapper">
         <DataTable
@@ -2870,7 +3193,6 @@ const tableColumns: DataTableColumn<ContentListRow>[] = $derived([
           loading={isLoading}
           caption={t(M['content.content_list.table_caption'])}
           rowLabel={(row: ContentListRow) => row.title}
-          dataSurface={surfaceOptions}
           empty={tableEmptyState}
         />
       </div>
@@ -3108,6 +3430,11 @@ const tableColumns: DataTableColumn<ContentListRow>[] = $derived([
     width: 100%;
   }
 
+  .content-list-wrapper.data-surface-highlighted {
+    outline: 2px solid var(--smrt-color-primary);
+    outline-offset: 0.25rem;
+  }
+
   .content-controls {
     display: flex;
     justify-content: space-between;

package/dist/svelte/components/ContentList.svelte.d.ts

@@ -60,7 +60,7 @@ interface Props {
     error?: string | null;
     /** Retry affordance rendered with an error. */
     onRetry?: () => void;
-    /** Opt-in agent addressability. Non-table presentations land with #2456. */
+    /** Opt-in agent addressability shared by every list presentation. */
     dataSurface?: ContentListDataSurface;
     /**
      * Opt-in server-backed rows (#2452). `bind()` is called exactly once, during

package/dist/svelte/components/ContentList.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ContentList.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,IAAI,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CACT,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,6BAA6B,KACjC,IAAI,CAAC;IACV,uEAAuE;IACvE,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAcD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAKhF,OAAO,EASL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAiBzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAOL,KAAK,sBAAsB,EAU5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,yBAAyB,EAG/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,0BAA0B,EAOhC,MAAM,8BAA8B,CAAC;AAiBtC,UAAU,KAAK;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,oFAAoF;IACpF,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC;AAgnFD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"ContentList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ContentList.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,IAAI,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CACT,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,6BAA6B,KACjC,IAAI,CAAC;IACV,uEAAuE;IACvE,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAcD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAUhF,OAAO,EASL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAiBzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAOL,KAAK,sBAAsB,EAU5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGL,KAAK,qBAAqB,EAG3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,yBAAyB,EAG/B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,0BAA0B,EAOhC,MAAM,8BAA8B,CAAC;AAiBtC,UAAU,KAAK;IACb,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,6DAA6D;IAC7D,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,4DAA4D;IAC5D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,MAAM,GAAG,IAAI,CAAC;IACtD,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qEAAqE;IACrE,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,0BAA0B,CAAC;IACtC,oFAAoF;IACpF,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,6EAA6E;IAC7E,SAAS,CAAC,EAAE,0BAA0B,CAAC;IACvC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,2BAA2B,CAAC;IACxC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACpC;AA26FD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/components/ContentListLifecyclePanel.svelte

@@ -42,7 +42,7 @@ let {
   oncomplete,
 }: Props = $props();
 
-const controller = createContentListLifecycleController(untrack(() => binding));
+let controller = createContentListLifecycleController(untrack(() => binding));
 let snapshot = $state<ContentListLifecycleSnapshot>(controller.snapshot());
 let lastResult = $state<ContentListLifecycleSnapshot['summary']>();
 let dialogOpen = $state(false);
@@ -50,10 +50,50 @@ let countConfirmation = $state('');
 let restoreStatus = $state<ContentListRestoreStatus>('draft');
 let intent = $state<'selected' | 'all-matching'>('selected');
 
-const unsubscribe = controller.subscribe((next) => {
+let unsubscribe = controller.subscribe((next) => {
   snapshot = next;
 });
-onDestroy(unsubscribe);
+
+function sameBindingAuthority(
+  left: ContentListLifecycleBinding,
+  right: ContentListLifecycleBinding,
+): boolean {
+  return (
+    left.client === right.client &&
+    left.client.preview === right.client.preview &&
+    left.client.apply === right.client.apply &&
+    left.revision === right.revision &&
+    left.maxSelectionSize === right.maxSelectionSize &&
+    left.identity?.kind === right.identity?.kind &&
+    left.identity?.surfaceId === right.identity?.surfaceId &&
+    left.identity?.subject?.type === right.identity?.subject?.type &&
+    left.identity?.subject?.id === right.identity?.subject?.id
+  );
+}
+
+let installedBinding = untrack(() => binding);
+
+function replaceController(nextBinding: ContentListLifecycleBinding): void {
+  unsubscribe();
+  controller.reset();
+  controller = createContentListLifecycleController(nextBinding);
+  snapshot = controller.snapshot();
+  lastResult = undefined;
+  dialogOpen = false;
+  countConfirmation = '';
+  unsubscribe = controller.subscribe((next) => {
+    snapshot = next;
+  });
+}
+
+$effect(() => {
+  const nextBinding = binding;
+  if (sameBindingAuthority(installedBinding, nextBinding)) return;
+  replaceController(nextBinding);
+  installedBinding = nextBinding;
+});
+
+onDestroy(() => unsubscribe());
 
 $effect(() => {
   controller.invalidate(viewKey);
@@ -70,6 +110,7 @@ const busy = $derived(
 );
 const selectedCount = $derived(selectedRowIds.length);
 const selectionLimit = $derived(binding.maxSelectionSize ?? 200);
+const selectedSelectionTooLarge = $derived(selectedCount > selectionLimit);
 const matchingSelectionTooLarge = $derived(
   exactMatchingCount !== undefined && exactMatchingCount > selectionLimit,
 );
@@ -92,6 +133,11 @@ async function begin(
   actionId: ContentListLifecycleActionId,
   scope: 'selected' | 'all-matching' = 'selected',
 ) {
+  if (
+    (scope === 'selected' && selectedSelectionTooLarge) ||
+    (scope === 'all-matching' && matchingSelectionTooLarge)
+  )
+    return;
   intent = scope;
   countConfirmation = '';
   dialogOpen = true;
@@ -136,7 +182,7 @@ function retryPreview() {
       variant="ghost"
       size="sm"
       type="button"
-      disabled={selectedCount === 0 || busy}
+      disabled={selectedCount === 0 || selectedSelectionTooLarge || busy}
       onclick={() => begin('move-to-trash')}
     >{t(M['content.content_list.move_selected_to_trash'])}</Button>
   {:else}
@@ -153,14 +199,14 @@ function retryPreview() {
       variant="ghost"
       size="sm"
       type="button"
-      disabled={selectedCount === 0 || busy}
+      disabled={selectedCount === 0 || selectedSelectionTooLarge || busy}
       onclick={() => begin('restore')}
     >{t(M['content.content_list.restore_selected'])}</Button>
     <Button
       variant="ghost"
       size="sm"
       type="button"
-      disabled={selectedCount === 0 || busy}
+      disabled={selectedCount === 0 || selectedSelectionTooLarge || busy}
       onclick={() => begin('permanent-delete')}
     >{t(M['content.content_list.delete_selected_permanently'])}</Button>
     <Button

package/dist/svelte/components/ContentListLifecyclePanel.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ContentListLifecyclePanel.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ContentListLifecyclePanel.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAEL,KAAK,2BAA2B,EAIjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAI5E,UAAU,KAAK;IACb,OAAO,EAAE,2BAA2B,CAAC;IACrC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACvD;AAkPD,QAAA,MAAM,yBAAyB,2CAAwC,CAAC;AACxE,KAAK,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC9E,eAAe,yBAAyB,CAAC"}
+{"version":3,"file":"ContentListLifecyclePanel.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ContentListLifecyclePanel.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,EAEL,KAAK,2BAA2B,EAIjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAI5E,UAAU,KAAK;IACb,OAAO,EAAE,2BAA2B,CAAC;IACrC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,KAAK,CAAC,EAAE,2BAA2B,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACvD;AAgSD,QAAA,MAAM,yBAAyB,2CAAwC,CAAC;AACxE,KAAK,yBAAyB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC9E,eAAe,yBAAyB,CAAC"}

package/dist/svelte/content-list-controller.d.ts

@@ -105,6 +105,16 @@ export interface ContentListSurfaceDescriptorOptions {
     limits?: Partial<DataSurfaceLimits>;
     /** Publish bulk workflow actions only when the mounted list can execute them. */
     includeWorkflows?: boolean;
+    /** Narrows discovery to operations the server query translator can execute. */
+    serverBacked?: boolean;
+    /** Publish the server-authoritative lifecycle actions available to this list. */
+    lifecycle?: boolean;
+    /** Trash lists expose restore/delete rather than active editing actions. */
+    lifecycleMode?: 'active' | 'trash';
+    /** A mounted query can refresh the currently visible result. */
+    refresh?: boolean;
+    /** A mounted query or host callback can retry a failed result. */
+    retry?: boolean;
 }
 /**
  * Opt-in agent addressability for the compact table. The host owns the