@happyvertical/smrt-content 0.44.0 → 0.45.0

package/dist/svelte/content-list-controller.js

@@ -101,8 +101,25 @@ const DEFAULT_SURFACE_LIMITS = {
     maxQueryBytes: 50_000,
     maxSelectionSize: 200,
 };
+/** Operators shared by the local evaluator and server query translator. */
+const CONTENT_LIST_FILTER_OPERATORS = [
+    'equals',
+    'notEquals',
+    'contains',
+    'startsWith',
+    'endsWith',
+    'in',
+    'notIn',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'isNull',
+    'isNotNull',
+];
 /** Local table commands a mounted content list accepts from a data surface. */
 const CONTENT_LIST_CONTROLS = [
+    { id: 'set-view', label: 'Change list presentation' },
     { id: 'set-search', label: 'Search contents' },
     { id: 'set-filters', label: 'Filter contents' },
     { id: 'set-sorting', label: 'Sort contents' },
@@ -112,6 +129,8 @@ const CONTENT_LIST_CONTROLS = [
     { id: 'set-selected-rows', label: 'Replace the row selection' },
     { id: 'toggle-row-selection', label: 'Toggle one row selection' },
     { id: 'reset', label: 'Reset the list view' },
+    { id: 'refresh', label: 'Refresh contents' },
+    { id: 'retry', label: 'Retry the content query' },
     { id: 'focus', label: 'Focus the list' },
     { id: 'reveal', label: 'Scroll the list into view' },
     { id: 'highlight', label: 'Highlight the list' },
@@ -828,14 +847,11 @@ export function contentListRowActions(row, options = {}) {
         actions.push('delete');
     return actions;
 }
-function surfaceColumn(id, labels, order, column) {
-    const capabilities = [
-        'read',
-        'filter',
-        'sort',
-        'project',
-    ];
-    if (column.searchable !== false)
+function surfaceColumn(id, labels, order, column, queryable = true) {
+    const capabilities = ['read'];
+    if (queryable)
+        capabilities.push('filter', 'sort', 'project');
+    if (queryable && column.searchable !== false)
         capabilities.push('search');
     const fieldName = CONTENT_LIST_COLUMN_FIELD_NAMES[id];
     return {
@@ -846,6 +862,21 @@ function surfaceColumn(id, labels, order, column) {
         visibility: 'basic',
         order,
         role: column.role === 'status' ? 'status' : 'data',
+        readable: true,
+        ...(queryable
+            ? {
+                operators: {
+                    ...(column.searchable !== false ? { search: ['contains'] } : {}),
+                    filter: [...CONTENT_LIST_FILTER_OPERATORS],
+                    sort: ['asc', 'desc'],
+                },
+                ...(column.searchable !== false
+                    ? { searchOperators: ['contains'] }
+                    : {}),
+                filterOperators: [...CONTENT_LIST_FILTER_OPERATORS],
+                sortOperators: ['asc', 'desc'],
+            }
+            : {}),
     };
 }
 /**
@@ -861,7 +892,7 @@ export function buildContentListSurfaceDescriptor(options = {}) {
         if (!column) {
             throw new Error(`Missing content list column definition: ${id}`);
         }
-        return surfaceColumn(id, columnLabels, index, column);
+        return surfaceColumn(id, columnLabels, index, column, !(options.serverBacked && id === 'site'));
     });
     // The row-key column must be declared even though the table renders identity
     // through Svelte keys rather than a visible column.
@@ -871,11 +902,15 @@ export function buildContentListSurfaceDescriptor(options = {}) {
         capabilities: ['read', 'project'],
         fieldName: CONTENT_LIST_ROW_KEY,
         role: 'row-key',
+        readable: true,
     };
-    const columnIds = visibleColumns.map((column) => column.id);
+    const columnIds = visibleColumns
+        .filter((column) => column.capabilities.includes('project'))
+        .map((column) => column.id);
     const searchableColumnIds = visibleColumns
         .filter((column) => column.capabilities.includes('search'))
         .map((column) => column.id);
+    const lifecycleMode = options.lifecycleMode ?? 'active';
     const actions = [
         {
             id: 'view',
@@ -883,20 +918,65 @@ export function buildContentListSurfaceDescriptor(options = {}) {
             selectionScopes: ['explicit-ids'],
             columnIds: ['title'],
         },
-        {
-            id: 'edit',
-            label: actionLabels.edit ?? DEFAULT_ACTION_LABELS.edit,
-            selectionScopes: ['explicit-ids'],
-        },
-        {
-            id: 'delete',
-            label: actionLabels.delete ?? DEFAULT_ACTION_LABELS.delete,
-            sensitivity: 'sensitive',
-            selectionScopes: ['explicit-ids', 'current-page'],
-            requiresConfirmation: true,
-        },
+        ...(lifecycleMode === 'active'
+            ? [
+                {
+                    id: 'edit',
+                    label: actionLabels.edit ?? DEFAULT_ACTION_LABELS.edit,
+                    selectionScopes: ['explicit-ids'],
+                },
+                options.lifecycle
+                    ? {
+                        id: 'move-to-trash',
+                        label: 'Move to trash',
+                        sensitivity: 'sensitive',
+                        selectionScopes: [
+                            'explicit-ids',
+                            'current-page',
+                            'all-matching',
+                        ],
+                        requiresConfirmation: true,
+                    }
+                    : {
+                        id: 'delete',
+                        label: actionLabels.delete ?? DEFAULT_ACTION_LABELS.delete,
+                        sensitivity: 'sensitive',
+                        selectionScopes: [
+                            'explicit-ids',
+                            'current-page',
+                        ],
+                        requiresConfirmation: true,
+                    },
+            ]
+            : options.lifecycle
+                ? [
+                    {
+                        id: 'restore',
+                        label: 'Restore',
+                        sensitivity: 'sensitive',
+                        selectionScopes: [
+                            'explicit-ids',
+                            'current-page',
+                            'all-matching',
+                        ],
+                        requiresConfirmation: true,
+                    },
+                    {
+                        id: 'permanent-delete',
+                        label: 'Delete permanently',
+                        sensitivity: 'sensitive',
+                        selectionScopes: [
+                            'explicit-ids',
+                            'current-page',
+                            'all-matching',
+                        ],
+                        requiresConfirmation: true,
+                    },
+                ]
+                : []),
         ...(options.includeWorkflows
-            ? CONTENT_LIST_WORKFLOW_OPTIONS.map((workflow) => ({
+            ? CONTENT_LIST_WORKFLOW_OPTIONS.filter((workflow) => !(options.lifecycle && workflow.id === 'move-to-trash') &&
+                !(lifecycleMode === 'trash' && workflow.id === 'restore')).map((workflow) => ({
                 id: workflow.id,
                 label: workflow.label,
                 sensitivity: workflow.sensitivity,
@@ -925,10 +1005,15 @@ export function buildContentListSurfaceDescriptor(options = {}) {
             modes: ['rows', 'count'],
             projectableColumnIds: [CONTENT_LIST_ROW_KEY, ...columnIds],
             searchableColumnIds,
-            filterableColumnIds: columnIds,
-            sortableColumnIds: columnIds,
+            filterableColumnIds: visibleColumns
+                .filter((column) => column.capabilities.includes('filter'))
+                .map((column) => column.id),
+            sortableColumnIds: visibleColumns
+                .filter((column) => column.capabilities.includes('sort'))
+                .map((column) => column.id),
         },
-        controls: CONTENT_LIST_CONTROLS.map((control) => ({ ...control })),
+        controls: CONTENT_LIST_CONTROLS.filter((control) => (control.id !== 'refresh' || options.refresh === true) &&
+            (control.id !== 'retry' || options.retry === true)).map((control) => ({ ...control })),
         actions,
         limits: { ...DEFAULT_SURFACE_LIMITS, ...options.limits },
     };

package/dist/svelte/content-list-data-surface.d.ts

@@ -0,0 +1,45 @@
+/** ContentList-owned mounted data surface, shared by every presentation. */
+import { type DataSurfaceDescriptor, type DataSurfaceRegistry, type DataTableCommand, type DataTableController } from '@happyvertical/smrt-ui/data';
+import type { ContentListViewMode } from './content-list-controller.js';
+export interface ContentListSurfaceFreshness {
+    stale: boolean;
+    refreshing: boolean;
+    offline: boolean;
+    lastUpdated: string | null;
+    truncated: boolean;
+    warnings: readonly string[];
+}
+export interface ContentListSurfaceContext {
+    viewMode: ContentListViewMode;
+    queryFingerprint: string | null;
+    totalRows: number | null;
+    freshness: ContentListSurfaceFreshness;
+}
+export interface ContentListSurfaceRegistrationOptions {
+    registry: DataSurfaceRegistry;
+    descriptor: DataSurfaceDescriptor;
+    controller: DataTableController;
+    context: ContentListSurfaceContext;
+    /** Carries the mounted identity's monotonic revision across re-registration. */
+    initialRevision?: number;
+    onRevision?: (revision: number) => void;
+    /**
+     * ContentList-owned constraints that must hold before a visible command is
+     * acknowledged. Returning false denies the command rather than publishing a
+     * transient state which a later component effect would correct.
+     */
+    acceptsTableCommand?: (command: DataTableCommand) => boolean;
+    setViewMode(viewMode: ContentListViewMode): void;
+    refresh?: () => boolean | Promise<boolean>;
+    retry?: () => boolean | Promise<boolean>;
+    focus?: () => void;
+    reveal?: () => void;
+    highlight?: () => void;
+}
+export interface ContentListSurfaceHandle {
+    update(context: ContentListSurfaceContext): void;
+    destroy(): void;
+}
+/** Register one stable ContentList identity independently of its view mode. */
+export declare function registerContentListDataSurface(options: ContentListSurfaceRegistrationOptions): ContentListSurfaceHandle;
+//# sourceMappingURL=content-list-data-surface.d.ts.map

package/dist/svelte/content-list-data-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-list-data-surface.d.ts","sourceRoot":"","sources":["../../src/svelte/content-list-data-surface.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EACL,KAAK,qBAAqB,EAG1B,KAAK,mBAAmB,EAGxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAIzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,2BAA2B,CAAC;CACxC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,qBAAqB,CAAC;IAClC,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,yBAAyB,CAAC;IACnC,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC;IAC7D,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACjD,OAAO,IAAI,IAAI,CAAC;CACjB;AA8HD,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,qCAAqC,GAC7C,wBAAwB,CAyG1B"}

package/dist/svelte/content-list-data-surface.js

@@ -0,0 +1,196 @@
+/** ContentList-owned mounted data surface, shared by every presentation. */
+import { dataTableCommandFromDataSurfaceCommand, dataTableRowIdKey, } from '@happyvertical/smrt-ui/data';
+const VIEWS = new Set(['grid', 'detailed', 'compact']);
+const revisionsByRegistry = new WeakMap();
+function identityKey(descriptor) {
+    const { identity } = descriptor;
+    return JSON.stringify([
+        identity.kind,
+        identity.surfaceId,
+        identity.subject?.type,
+        identity.subject?.id,
+    ]);
+}
+function selectionReference(selection) {
+    if (selection.scope === 'page')
+        return { scope: 'current-page' };
+    if (selection.scope === 'allMatching') {
+        return {
+            scope: 'all-matching',
+            queryFingerprint: selection.queryFingerprint,
+        };
+    }
+    return selection.rowIds.length > 0
+        ? { scope: 'explicit-ids', rowIds: selection.rowIds }
+        : null;
+}
+function contextState(context) {
+    return {
+        viewMode: context.viewMode,
+        queryFingerprint: context.queryFingerprint,
+        totalRows: context.totalRows,
+        freshness: {
+            stale: context.freshness.stale,
+            refreshing: context.freshness.refreshing,
+            offline: context.freshness.offline,
+            lastUpdated: context.freshness.lastUpdated,
+            truncated: context.freshness.truncated,
+            warnings: [...context.freshness.warnings],
+        },
+    };
+}
+function payloadObject(value) {
+    return value && !Array.isArray(value) && typeof value === 'object'
+        ? value
+        : undefined;
+}
+function allowsFilterOperator(column, operator) {
+    if (!column)
+        return false;
+    const canonical = column.operators?.filter;
+    const alias = column.filterOperators;
+    if (canonical && alias)
+        return canonical.includes(operator) && alias.includes(operator);
+    return canonical?.includes(operator) ?? alias?.includes(operator) ?? false;
+}
+function commandAllowed(command, descriptor, controller) {
+    const readable = new Set(descriptor.columns
+        .filter((column) => column.capabilities.includes('read'))
+        .map((column) => column.id));
+    const filterable = new Set(descriptor.query.filterableColumnIds ?? []);
+    const sortable = new Set(descriptor.query.sortableColumnIds ?? []);
+    switch (command.type) {
+        case 'setFilters':
+            return command.filters.every((filter) => {
+                const column = descriptor.columns.find((candidate) => candidate.id === filter.columnId);
+                return (filterable.has(filter.columnId) &&
+                    allowsFilterOperator(column, filter.operator));
+            });
+        case 'setSorting':
+            return command.sorting.every((sort) => sortable.has(sort.columnId));
+        case 'toggleSorting':
+            return sortable.has(command.columnId);
+        case 'setSelectedRows':
+            return command.rowIds.length <= descriptor.limits.maxSelectionSize;
+        case 'toggleRowSelection': {
+            const selection = controller.snapshot().state.selection;
+            if (selection.scope === 'allMatching')
+                return false;
+            const selected = selection.rowIds.some((rowId) => dataTableRowIdKey(rowId) === dataTableRowIdKey(command.rowId));
+            return (selected || selection.rowIds.length < descriptor.limits.maxSelectionSize);
+        }
+        case 'setPageSize':
+            return (command.pageSize === null ||
+                (Number.isSafeInteger(command.pageSize) && command.pageSize > 0));
+        case 'setColumnOrder':
+            return command.columnIds.every((columnId) => readable.has(columnId));
+        case 'setColumnVisibility':
+            return command.columns.every((column) => readable.has(column.columnId));
+        default:
+            return true;
+    }
+}
+/** Register one stable ContentList identity independently of its view mode. */
+export function registerContentListDataSurface(options) {
+    let revisions = revisionsByRegistry.get(options.registry);
+    if (!revisions) {
+        revisions = new Map();
+        revisionsByRegistry.set(options.registry, revisions);
+    }
+    const key = identityKey(options.descriptor);
+    const previousRevision = revisions.get(key);
+    let revision = Math.max(options.initialRevision ?? 0, previousRevision === undefined ? 0 : previousRevision + 1);
+    revisions.set(key, revision);
+    const advanceRevision = () => {
+        revision += 1;
+        revisions.set(key, revision);
+        options.onRevision?.(revision);
+    };
+    let context = options.context;
+    let contextSignature = JSON.stringify(contextState(context));
+    const updateContext = (next) => {
+        const signature = JSON.stringify(contextState(next));
+        if (signature !== contextSignature) {
+            advanceRevision();
+            contextSignature = signature;
+        }
+        context = next;
+    };
+    const unsubscribe = options.controller.subscribe((transition) => {
+        if (transition.changed)
+            advanceRevision();
+    });
+    const unregister = options.registry.register({
+        descriptor: options.descriptor,
+        getSnapshot: () => {
+            const table = options.controller.snapshot();
+            return {
+                revision,
+                state: {
+                    ...contextState(context),
+                    table: table,
+                },
+                selection: selectionReference(table.state.selection),
+            };
+        },
+        execute: async (command) => {
+            const tableCommand = dataTableCommandFromDataSurfaceCommand(command);
+            if (tableCommand) {
+                if (!commandAllowed(tableCommand, options.descriptor, options.controller) ||
+                    options.acceptsTableCommand?.(tableCommand) === false)
+                    return { ok: false };
+                options.controller.dispatch(tableCommand);
+                return;
+            }
+            switch (command.controlId) {
+                case 'set-view': {
+                    const view = payloadObject(command.payload)?.view;
+                    if (typeof view !== 'string' ||
+                        !VIEWS.has(view))
+                        return { ok: false };
+                    const viewMode = view;
+                    updateContext({ ...context, viewMode });
+                    options.setViewMode(viewMode);
+                    return;
+                }
+                case 'refresh':
+                    if (!options.refresh)
+                        return { ok: false };
+                    if ((await options.refresh()) === false)
+                        return { ok: false };
+                    return;
+                case 'retry':
+                    if (!options.retry)
+                        return { ok: false };
+                    if ((await options.retry()) === false)
+                        return { ok: false };
+                    return;
+                case 'focus':
+                    if (!options.focus)
+                        return { ok: false };
+                    options.focus();
+                    return;
+                case 'reveal':
+                    if (!options.reveal)
+                        return { ok: false };
+                    options.reveal();
+                    return;
+                case 'highlight':
+                    if (!options.highlight)
+                        return { ok: false };
+                    options.highlight();
+                    return;
+                default:
+                    return { ok: false };
+            }
+        },
+    });
+    options.onRevision?.(revision);
+    return {
+        update: updateContext,
+        destroy() {
+            unsubscribe();
+            unregister();
+        },
+    };
+}

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

@@ -0,0 +1,132 @@
+/**
+ * Browser-safe trash, restore, and permanent-delete orchestration for
+ * ContentList (#2454).
+ *
+ * Lifecycle authority stays on the server. The browser supplies a selection
+ * hint and expected count, then renders the server's resolved preview. Apply
+ * must reuse that preview's opaque confirmation token and authority-bound
+ * selection while using a fresh request id for each transport attempt; a
+ * changed query, count, permission, row revision, or eligibility is therefore
+ * rejected by the principal-bound server adapter rather than being guessed
+ * from stale list rows.
+ */
+import type { DataSurfaceActionResult, DataSurfaceIdentity, DataSurfaceJsonValue, DataSurfaceSelectionReference } from '@happyvertical/smrt-ui/data';
+import type { ContentListDataQueryRequest } from './content-list-query.js';
+export declare const CONTENT_LIST_LIFECYCLE_ACTION_IDS: readonly ["move-to-trash", "restore", "permanent-delete"];
+export type ContentListLifecycleActionId = (typeof CONTENT_LIST_LIFECYCLE_ACTION_IDS)[number];
+export type ContentListRestoreStatus = 'draft' | 'review' | 'published';
+export interface ContentListLifecycleTarget {
+    /** Canonical server query. Required for all-matching selections. */
+    query?: ContentListDataQueryRequest;
+    /** Count visible when the operator requested the preview. */
+    expectedCount: number;
+    /** Operator-entered server preview count, sent only on permanent-delete apply. */
+    confirmedCount?: number;
+}
+export interface ContentListLifecycleRequest {
+    version: 1;
+    requestId: string;
+    identity: DataSurfaceIdentity;
+    actionId: ContentListLifecycleActionId;
+    phase: 'preview' | 'apply';
+    selection: DataSurfaceSelectionReference;
+    payload?: DataSurfaceJsonValue;
+    expectedRevision: number;
+    target: ContentListLifecycleTarget;
+    confirmationToken?: string;
+    idempotencyKey?: string;
+}
+export interface ContentListLifecycleClient {
+    preview(request: ContentListLifecycleRequest): Promise<DataSurfaceActionResult>;
+    apply(request: ContentListLifecycleRequest): Promise<DataSurfaceActionResult>;
+}
+export interface ContentListLifecycleBinding {
+    client: ContentListLifecycleClient;
+    /** Server-owned surface revision. Never derived from list rows. */
+    revision?: number;
+    /** Override the default ContentList identity. */
+    identity?: DataSurfaceIdentity;
+    /** Server action-selection cap. Defaults to 200 and fails closed in the UI. */
+    maxSelectionSize?: number;
+}
+export interface ContentListLifecycleTransportOptions {
+    apiBaseUrl?: string;
+    path?: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+    credentials?: RequestCredentials;
+}
+export type ContentListLifecycleTransportErrorReason = 'network_failure' | 'invalid_json' | 'http_error' | 'invalid_result';
+export declare class ContentListLifecycleTransportError extends Error {
+    readonly status?: number;
+    readonly reason: ContentListLifecycleTransportErrorReason;
+    constructor(message: string, status?: number, reason?: ContentListLifecycleTransportErrorReason);
+}
+export interface ContentListLifecycleOutcome {
+    rowId: string | number;
+    status: 'accepted' | 'skipped' | 'failed';
+    reason?: string;
+    /** Canonical runtime subtype, for example a Document or Mirror. */
+    resourceType?: string;
+    /** Canonical resource id used by the server mutation. */
+    resourceId?: string;
+}
+export interface ContentListLifecycleSummary {
+    resolvedCount: number;
+    accepted: number;
+    skipped: number;
+    failed: number;
+    outcomes: ContentListLifecycleOutcome[];
+    representativeLabels: string[];
+    expiresAt?: number;
+    /** Correlates the visible result with principal audit metadata. */
+    auditReference: string;
+}
+export type ContentListLifecycleControllerStatus = 'idle' | 'previewing' | 'ready' | 'applying' | 'succeeded' | 'failed';
+export interface ContentListLifecycleSnapshot {
+    status: ContentListLifecycleControllerStatus;
+    actionId?: ContentListLifecycleActionId;
+    selection?: DataSurfaceSelectionReference;
+    summary?: ContentListLifecycleSummary;
+    result?: DataSurfaceActionResult;
+    error?: string;
+    /** True when the only safe recovery is another server preview. */
+    renewalRequired: boolean;
+    /** True while an ambiguous apply must replay its exact authority envelope. */
+    replayRequired?: boolean;
+}
+export interface ContentListLifecyclePreviewInput {
+    actionId: ContentListLifecycleActionId;
+    selection: DataSurfaceSelectionReference;
+    expectedCount: number;
+    query?: ContentListDataQueryRequest;
+    restoreStatus?: ContentListRestoreStatus;
+    /** Invalidates the preview when the visible query/selection changes. */
+    viewKey: string;
+}
+export interface ContentListLifecycleControllerOptions extends ContentListLifecycleBinding {
+    createRequestId?: () => string;
+    createIdempotencyKey?: () => string;
+}
+export interface ContentListLifecycleController {
+    snapshot(): ContentListLifecycleSnapshot;
+    subscribe(listener: (snapshot: ContentListLifecycleSnapshot) => void): () => void;
+    preview(input: ContentListLifecyclePreviewInput): Promise<ContentListLifecycleSnapshot>;
+    /**
+     * Apply only after the operator confirms the server-resolved count. The
+     * number is intentionally passed again rather than inferred by the UI.
+     */
+    apply(confirmedCount: number): Promise<ContentListLifecycleSnapshot>;
+    /** Drop a preview after any visible query or selection change. */
+    invalidate(viewKey: string): void;
+    reset(): void;
+}
+/** Authenticated fetch transport for the host's lifecycle route. */
+export declare function createContentListLifecycleTransport(options?: ContentListLifecycleTransportOptions): ContentListLifecycleClient;
+/** Parse the bounded, optional preview/apply details without trusting casts. */
+export declare function readContentListLifecycleSummary(result: DataSurfaceActionResult): ContentListLifecycleSummary;
+/** Framework-free state machine shared by UI and agent-driven lifecycle flows. */
+export declare function createContentListLifecycleController(options: ContentListLifecycleControllerOptions): ContentListLifecycleController;
+/** Keep unsuccessful rows selected so partial failures are visible/retryable. */
+export declare function reconcileContentListLifecycleSelection(selectedRowIds: readonly (string | number)[], result: DataSurfaceActionResult): Array<string | number>;
+//# sourceMappingURL=content-list-lifecycle.d.ts.map

package/dist/svelte/content-list-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-list-lifecycle.d.ts","sourceRoot":"","sources":["../../src/svelte/content-list-lifecycle.ts"],"names":[],"mappings":"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"}