@happyvertical/smrt-content 0.43.4 → 0.43.6

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

@@ -1,9 +1,41 @@
+import type { DataTableViewState as ContentListDataTableViewState } from '@happyvertical/smrt-ui/data';
+import type { ContentListUrlStateOptions } from '../content-list-url-state.js';
+/**
+ * Optional, router-agnostic URL state (#2452).
+ *
+ * `ContentList` never imports a router: it reads `params` once during
+ * initialization and hands the merged parameters back through `onChange`, so a
+ * SvelteKit host calls `replaceState`, a hash router rewrites the fragment, and
+ * a test passes a plain `URLSearchParams`.
+ */
+export interface ContentListUrlStateBinding {
+    /**
+     * Query parameters to restore the view from. Read once, at initialization —
+     * later navigation is the host's to drive (re-key the component to re-read).
+     */
+    params?: URLSearchParams | string | null;
+    /**
+     * Receives the full merged parameter set — every foreign parameter
+     * preserved — whenever the query-affecting state changes. Never called for
+     * the initial restore.
+     */
+    onChange?: (params: URLSearchParams, state: ContentListDataTableViewState) => void;
+    /** Prefix and default page size, forwarded to the URL-state module. */
+    options?: ContentListUrlStateOptions;
+}
 import type { Snippet } from 'svelte';
 import type { ContentData } from '../../mock-smrt-client.js';
 import { type ContentListDataSurface, type ContentListViewMode } from '../content-list-controller.js';
+import { type ContentListQuerySource } from '../content-list-query.js';
+import { type ContentListSavedViewStore } from '../content-list-saved-views.js';
 interface Props {
     apiBaseUrl?: string;
-    contents: ContentData[];
+    /**
+     * Client-side rows. Ignored when `query` is supplied — the server then owns
+     * filtering, sorting, and paging, and these rows would be a second, disagreeing
+     * source of truth.
+     */
+    contents?: ContentData[];
     type?: string;
     defaultViewMode?: ContentListViewMode;
     onEdit: (content: ContentData) => void;
@@ -19,6 +51,17 @@ interface Props {
     onRetry?: () => void;
     /** Opt-in agent addressability. Non-table presentations land with #2456. */
     dataSurface?: ContentListDataSurface;
+    /**
+     * Opt-in server-backed rows (#2452). `bind()` is called exactly once, during
+     * initialization, so a `remoteQuery(...)` binding is disposed with this
+     * component. Supplying it switches the list into server mode: `contents` is
+     * ignored and the local select/paginate transform never runs.
+     */
+    query?: ContentListQuerySource;
+    /** Opt-in shareable URL state. The host owns navigation. */
+    urlState?: ContentListUrlStateBinding;
+    /** Opt-in saved views. `createContentListSavedViewStore()` is the default store. */
+    savedViews?: ContentListSavedViewStore;
 }
 declare const ContentList: import("svelte").Component<Props, {}, "">;
 type ContentList = ReturnType<typeof ContentList>;

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":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EASL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAazB,MAAM,+BAA+B,CAAC;AAKvC,UAAU,KAAK;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,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;CACtC;AAqmBD,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;AAYD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EASL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAiBzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAML,KAAK,sBAAsB,EAS5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,yBAAyB,EAG/B,MAAM,gCAAgC,CAAC;AAgBxC,UAAU,KAAK;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,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;CACxC;AAg2CD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

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

@@ -123,6 +123,33 @@ export interface ContentListActionOptions {
 export declare function normalizeContentType(value: unknown): string;
 /** Normalizes a status/state token for filtering and badge variants. */
 export declare function normalizeContentToken(value: unknown): string;
+/**
+ * The type tokens the toolbar select offers.
+ *
+ * `Content.type` is freeform, so this is a display vocabulary rather than the
+ * model's domain: a value outside it is still a valid filter, and the list
+ * surfaces it rather than hiding it (see `ContentList`).
+ */
+export declare const CONTENT_LIST_TYPE_OPTIONS: readonly ["article", "document", "mirror"];
+/**
+ * The status tokens the toolbar select offers.
+ *
+ * `Content.status` is `published | draft | review | archived | deleted`.
+ * `review` is offered because it is a real, reachable state that governance
+ * puts content into; omitting it meant `?status=review` restored a live
+ * predicate the toolbar could not show.
+ *
+ * `deleted` is deliberately NOT offered: it is the trash lifecycle, which is
+ * #2454's, and exposing it here would imply a restore/purge affordance this
+ * list does not have.
+ */
+export declare const CONTENT_LIST_STATUS_OPTIONS: readonly ["published", "draft", "review", "archived"];
+/**
+ * Resolves the normalized type a `type` prop locks the list to, or `null` when
+ * the list is unlocked. Shared so the lock effect and the initial restore
+ * cannot disagree about what "locked" means.
+ */
+export declare function normalizeContentListTypeLock(value: string | null | undefined): string | null;
 export declare function contentTypeLabel(value: unknown): string;
 /** Badge variant for a status; unrecognized statuses degrade to `unknown`. */
 export declare function contentStatusVariant(value: unknown): string;
@@ -153,9 +180,28 @@ export declare function resolveSelectedContents(rows: readonly ContentListRow[],
  * searchable/filterable/sortable flags the descriptor is derived from.
  */
 export declare function buildContentListColumns(labels?: ContentListColumnLabels): DataTableColumn<ContentListRow>[];
+/**
+ * Columns whose stored values are lowercase tokens rather than free text.
+ *
+ * Only these may have their case normalized by a filter: their domain is a
+ * fixed vocabulary the model writes in lower case, so folding the operator's
+ * input to match it is a correction. Every other column holds text a person
+ * typed.
+ */
+export declare const CONTENT_LIST_TOKEN_COLUMN_IDS: readonly ["type", "status", "state"];
 /**
  * One normalizer per filter column, so a filter built by the toolbar, by the
  * `type` lock, and by a restored view all compare equal.
+ *
+ * CASE IS PRESERVED FOR FREE TEXT. This helper was written for #2451, when
+ * every comparison happened in the browser and lowercasing everything was
+ * harmless. Under #2452 a stored filter value becomes a server-side `eq` or
+ * `like` predicate compared against the STORED text, so lowercasing `NASA`
+ * would send `%nasa%` and miss `NASA Update` on a case-sensitive backend
+ * (PostgreSQL, DuckDB). Local matching is unaffected either way: the local
+ * evaluator compares through `textValue()`, which lower-cases BOTH sides at
+ * compare time, so a case-preserving stored value still matches
+ * case-insensitively there.
  */
 export declare function normalizeContentListFilterValue(columnId: string, value: string): string;
 /** Builds the declarative filter set for the two toolbar filters. */
@@ -163,8 +209,59 @@ export declare function contentListFilters(values: {
     type?: string | null;
     status?: string | null;
 }): DataTableFilter[];
-/** Reads one filter's value, or `null` when the filter is not applied. */
+/**
+ * Reads one filter's value, or `null` when the filter is not applied.
+ *
+ * Value-only, and therefore NOT enough to drive a single-select toolbar
+ * control: it reports the same string for `equals 'draft'` and
+ * `notEquals 'draft'`. Use {@link readContentListSelectFilter} for anything
+ * that displays the filter to an operator.
+ */
 export declare function readContentListFilter(state: DataTableViewState, columnId: string): string | null;
+/**
+ * The value a toolbar select carries while a live filter cannot be represented
+ * as one of its options. It is only ever set programmatically on a disabled
+ * option, so it can never be submitted; `applyContentListFilter` would replace
+ * every filter on the column anyway.
+ *
+ * The prefix is U+001F rather than U+0000 deliberately. The HTML tokenizer
+ * rewrites a NUL inside an attribute value to U+FFFD, so a server-rendered
+ * option would come back with a different value than the select was given and
+ * hydrate to no selection at all — exactly the state this sentinel exists to
+ * prevent. U+001F passes through attribute parsing unchanged.
+ *
+ * A crafted filter value could still equal it — the normalizer only trims and
+ * lower-cases — and that is harmless: the representable and unrepresentable
+ * paths are mutually exclusive, and the representable one renders the value as
+ * a real, enabled option carrying the same value.
+ */
+export declare const CONTENT_LIST_UNREPRESENTABLE_OPTION = "\u001Funrepresentable";
+/** What a single-select toolbar control can honestly display for one column. */
+export interface ContentListSelectFilterState {
+    /** The value to display, or `''` when there is nothing to display. */
+    value: string;
+    /**
+     * False when a live filter exists on this column that a single select cannot
+     * express — a non-`equals` operator, a list value, a valueless operator, or
+     * more than one filter. The caller must then not render a plain value: it
+     * would state something other than the query being run.
+     */
+    representable: boolean;
+    /** A short, operator-facing summary of the live predicate when it is not. */
+    detail: string | null;
+}
+/**
+ * Resolves what a toolbar select may show for one column.
+ *
+ * A select offers a single `equals` value, but the filter vocabulary a link or
+ * a saved view can restore is much wider. `?status.in=draft,review` and
+ * `?status.isNull=1` constrain the query while a value-only read reports
+ * nothing, and `?status.notEquals=draft` reports `draft` — the exact inverse of
+ * what is being applied. This is the seam that keeps the control from
+ * misstating the query: either it can show the predicate exactly, or the caller
+ * is told it cannot and reports it.
+ */
+export declare function readContentListSelectFilter(state: DataTableViewState, columnId: string): ContentListSelectFilterState;
 /**
  * True when a column is filtered to exactly the given value and nothing else.
  *

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

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

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

@@ -126,6 +126,44 @@ export function normalizeContentType(value) {
 export function normalizeContentToken(value) {
     return getTextValue(value).trim().toLowerCase();
 }
+/**
+ * The type tokens the toolbar select offers.
+ *
+ * `Content.type` is freeform, so this is a display vocabulary rather than the
+ * model's domain: a value outside it is still a valid filter, and the list
+ * surfaces it rather than hiding it (see `ContentList`).
+ */
+export const CONTENT_LIST_TYPE_OPTIONS = [
+    'article',
+    'document',
+    'mirror',
+];
+/**
+ * The status tokens the toolbar select offers.
+ *
+ * `Content.status` is `published | draft | review | archived | deleted`.
+ * `review` is offered because it is a real, reachable state that governance
+ * puts content into; omitting it meant `?status=review` restored a live
+ * predicate the toolbar could not show.
+ *
+ * `deleted` is deliberately NOT offered: it is the trash lifecycle, which is
+ * #2454's, and exposing it here would imply a restore/purge affordance this
+ * list does not have.
+ */
+export const CONTENT_LIST_STATUS_OPTIONS = [
+    'published',
+    'draft',
+    'review',
+    'archived',
+];
+/**
+ * Resolves the normalized type a `type` prop locks the list to, or `null` when
+ * the list is unlocked. Shared so the lock effect and the initial restore
+ * cannot disagree about what "locked" means.
+ */
+export function normalizeContentListTypeLock(value) {
+    return value?.trim() ? normalizeContentType(value) : null;
+}
 export function contentTypeLabel(value) {
     switch (normalizeContentType(value)) {
         case 'article':
@@ -322,14 +360,40 @@ export function buildContentListColumns(labels = {}) {
         },
     ];
 }
+/**
+ * Columns whose stored values are lowercase tokens rather than free text.
+ *
+ * Only these may have their case normalized by a filter: their domain is a
+ * fixed vocabulary the model writes in lower case, so folding the operator's
+ * input to match it is a correction. Every other column holds text a person
+ * typed.
+ */
+export const CONTENT_LIST_TOKEN_COLUMN_IDS = [
+    'type',
+    'status',
+    'state',
+];
+const TOKEN_COLUMNS = new Set(CONTENT_LIST_TOKEN_COLUMN_IDS);
 /**
  * One normalizer per filter column, so a filter built by the toolbar, by the
  * `type` lock, and by a restored view all compare equal.
+ *
+ * CASE IS PRESERVED FOR FREE TEXT. This helper was written for #2451, when
+ * every comparison happened in the browser and lowercasing everything was
+ * harmless. Under #2452 a stored filter value becomes a server-side `eq` or
+ * `like` predicate compared against the STORED text, so lowercasing `NASA`
+ * would send `%nasa%` and miss `NASA Update` on a case-sensitive backend
+ * (PostgreSQL, DuckDB). Local matching is unaffected either way: the local
+ * evaluator compares through `textValue()`, which lower-cases BOTH sides at
+ * compare time, so a case-preserving stored value still matches
+ * case-insensitively there.
  */
 export function normalizeContentListFilterValue(columnId, value) {
-    return columnId === CONTENT_LIST_TYPE_FILTER_ID
-        ? normalizeContentType(value)
-        : normalizeContentToken(value);
+    if (columnId === CONTENT_LIST_TYPE_FILTER_ID)
+        return normalizeContentType(value);
+    if (TOKEN_COLUMNS.has(columnId))
+        return normalizeContentToken(value);
+    return value.trim();
 }
 /** Builds the declarative filter set for the two toolbar filters. */
 export function contentListFilters(values) {
@@ -350,11 +414,73 @@ export function contentListFilters(values) {
     }
     return filters;
 }
-/** Reads one filter's value, or `null` when the filter is not applied. */
+/**
+ * Reads one filter's value, or `null` when the filter is not applied.
+ *
+ * Value-only, and therefore NOT enough to drive a single-select toolbar
+ * control: it reports the same string for `equals 'draft'` and
+ * `notEquals 'draft'`. Use {@link readContentListSelectFilter} for anything
+ * that displays the filter to an operator.
+ */
 export function readContentListFilter(state, columnId) {
     const filter = state.filters.find((candidate) => candidate.columnId === columnId);
     return typeof filter?.value === 'string' ? filter.value : null;
 }
+/**
+ * The value a toolbar select carries while a live filter cannot be represented
+ * as one of its options. It is only ever set programmatically on a disabled
+ * option, so it can never be submitted; `applyContentListFilter` would replace
+ * every filter on the column anyway.
+ *
+ * The prefix is U+001F rather than U+0000 deliberately. The HTML tokenizer
+ * rewrites a NUL inside an attribute value to U+FFFD, so a server-rendered
+ * option would come back with a different value than the select was given and
+ * hydrate to no selection at all — exactly the state this sentinel exists to
+ * prevent. U+001F passes through attribute parsing unchanged.
+ *
+ * A crafted filter value could still equal it — the normalizer only trims and
+ * lower-cases — and that is harmless: the representable and unrepresentable
+ * paths are mutually exclusive, and the representable one renders the value as
+ * a real, enabled option carrying the same value.
+ */
+export const CONTENT_LIST_UNREPRESENTABLE_OPTION = '\u001Funrepresentable';
+function describeContentListFilter(filter) {
+    if (filter.value === undefined)
+        return filter.operator;
+    const value = Array.isArray(filter.value)
+        ? filter.value.map(String).join(', ')
+        : String(filter.value);
+    return `${filter.operator} ${value}`;
+}
+/**
+ * Resolves what a toolbar select may show for one column.
+ *
+ * A select offers a single `equals` value, but the filter vocabulary a link or
+ * a saved view can restore is much wider. `?status.in=draft,review` and
+ * `?status.isNull=1` constrain the query while a value-only read reports
+ * nothing, and `?status.notEquals=draft` reports `draft` — the exact inverse of
+ * what is being applied. This is the seam that keeps the control from
+ * misstating the query: either it can show the predicate exactly, or the caller
+ * is told it cannot and reports it.
+ */
+export function readContentListSelectFilter(state, columnId) {
+    const applied = state.filters.filter((candidate) => candidate.columnId === columnId);
+    if (applied.length === 0) {
+        return { value: '', representable: true, detail: null };
+    }
+    const unrepresentable = () => ({
+        value: '',
+        representable: false,
+        detail: applied.map(describeContentListFilter).join('; '),
+    });
+    if (applied.length > 1)
+        return unrepresentable();
+    const [filter] = applied;
+    if (filter.operator !== 'equals' || typeof filter.value !== 'string') {
+        return unrepresentable();
+    }
+    return { value: filter.value, representable: true, detail: null };
+}
 /**
  * True when a column is filtered to exactly the given value and nothing else.
  *
@@ -441,23 +567,143 @@ function compareFilterValues(left, right) {
     const rightText = textValue(right);
     return leftText === rightText ? 0 : leftText < rightText ? -1 : 1;
 }
+/**
+ * True when the content behind a row carries no value at all for a column.
+ *
+ * `ContentListRow` flattens every field to display text, so an absent value and
+ * an empty one both read as `''` — which made every ordered comparison treat
+ * "no author" as the smallest possible author, and made `isNull` match nothing.
+ * The original `ContentData` still distinguishes them, so the null-sensitive
+ * operators consult it. A derived column such as `site` has no single source
+ * field and is never absent.
+ */
+function isAbsentContentValue(row, column) {
+    const fieldName = CONTENT_LIST_COLUMN_FIELD_NAMES[column.id];
+    if (!fieldName)
+        return false;
+    const source = row.content[fieldName];
+    return source === null || source === undefined;
+}
+/**
+ * Columns whose flattened text is a LABEL when the content carries no value:
+ * `type` reads `content` and `title` reads `Untitled content`. Every other
+ * column flattens to empty text, which is what the stored column holds.
+ */
+const CONTENT_LIST_LABEL_FALLBACK_COLUMNS = new Set(['type', 'title']);
+/**
+ * The value a local comparison reads for one column.
+ *
+ * A fallback label is presentation, not data. Comparing it makes
+ * `?type=content` match every untyped row locally and none server-side, and
+ * makes a search for `untitled` match rows whose title is simply missing — the
+ * same link returning different data depending on how the host configured the
+ * list. For those two columns the comparison reads what is stored: `null` when
+ * the content has no value at all (which compares false against everything,
+ * exactly as SQL does), empty text when the value is genuinely blank, and
+ * otherwise the flattened text, which is already faithful.
+ */
+function comparisonValue(row, column) {
+    const value = getNestedValue(row, String(column.accessor ?? column.id));
+    if (!CONTENT_LIST_LABEL_FALLBACK_COLUMNS.has(column.id))
+        return value;
+    const fieldName = CONTENT_LIST_COLUMN_FIELD_NAMES[column.id];
+    const source = fieldName
+        ? row.content[fieldName]
+        : undefined;
+    if (source === null || source === undefined)
+        return null;
+    if (typeof source === 'string' && source.trim() === '')
+        return '';
+    return value;
+}
 /**
  * The single declarative-filter evaluator. It follows DataTable's operator
  * semantics so a persisted or agent-issued filter behaves the same here as it
  * would in a locally filtered table.
+ *
+ * The null-sensitive operators (`gt`/`gte`/`lt`/`lte`, `isNull`/`isNotNull`)
+ * additionally agree with SQL, and no comparison reads a display fallback, so
+ * the same shared link means the same thing on a client-array list and a
+ * server-backed one (#2452).
  */
+/**
+ * What an ABSENT value does to each operator, as the executor's SQL decides it.
+ *
+ * The flattened row reads an absent value as empty text, so comparing it as
+ * text answers a question about `''` rather than about absence — and the two
+ * differ for every operator once a BLANK comparand is involved. `author equals
+ * ''` matches an absent row as text and no row in SQL; `author notEquals ''`
+ * does the reverse. Deciding from the operator alone removes the text
+ * comparison from the picture entirely.
+ *
+ * The table is the SQL the executor emits (see `conditionToDnf`), not raw
+ * three-valued logic: `ne`/`notIn` union `IS NULL` unless a `null` is listed,
+ * which is why they read the way they do here.
+ */
+function matchesAbsentContentValue(filter) {
+    const listsNull = Array.isArray(filter.value) && filter.value.some((entry) => entry === null);
+    switch (filter.operator) {
+        // `eq v` is `= v`, true only when the caller named absence itself.
+        case 'equals':
+            return filter.value === null;
+        // `ne v` is `IS NULL OR <> v`; `ne null` is `IS NOT NULL`.
+        case 'notEquals':
+            return filter.value !== null;
+        // `in` matches an absent row only when the list carries a `null`.
+        case 'in':
+            return listsNull;
+        // `notIn` unions `IS NULL` unless a `null` is listed, which excludes it.
+        case 'notIn':
+            return !listsNull;
+        case 'isNull':
+            return true;
+        case 'isNotNull':
+            return false;
+        // `like` and every ordered comparison are UNKNOWN for NULL, so no row with
+        // no value takes part in one.
+        case 'contains':
+        case 'startsWith':
+        case 'endsWith':
+        case 'gt':
+        case 'gte':
+        case 'lt':
+        case 'lte':
+            return false;
+        // `notContains` has no server form — the executor refuses a negated
+        // `like` and the translator drops it — so there is nothing to align to.
+        // Keep the local set-complement reading.
+        case 'notContains':
+            return true;
+        default:
+            return false;
+    }
+}
 function matchesContentListFilter(row, column, filter) {
     if (column.filterable === false)
         return true;
-    const value = getNestedValue(row, String(column.accessor ?? column.id));
+    // Absence is decided before any text comparison, because the flattened row
+    // cannot represent it. The arms below stay correct for a value that is
+    // present; none of them can see an absent one.
+    if (isAbsentContentValue(row, column)) {
+        return matchesAbsentContentValue(filter);
+    }
+    const value = comparisonValue(row, column);
     const expected = filter.value;
     const valueText = textValue(value);
     const expectedText = textValue(expected);
+    // A literal `null` in a filter names ABSENCE, and the flattened row cannot
+    // express it — an absent author reads as empty text, which is not the same
+    // thing. `in`/`notIn` lists reach here from a data-surface `set-filters`
+    // command, and the executor lowers a listed null to `IS NULL` / `IS NOT
+    // NULL`; matching that here is what keeps the two modes agreeing.
+    const matchesEntry = (entry) => entry === null
+        ? isAbsentContentValue(row, column)
+        : sameFilterValue(value, entry);
     switch (filter.operator) {
         case 'equals':
-            return sameFilterValue(value, expected);
+            return matchesEntry(expected);
         case 'notEquals':
-            return !sameFilterValue(value, expected);
+            return !matchesEntry(expected);
         case 'contains':
             return valueText.includes(expectedText);
         case 'notContains':
@@ -467,23 +713,36 @@ function matchesContentListFilter(row, column, filter) {
         case 'endsWith':
             return valueText.endsWith(expectedText);
         case 'in':
-            return (Array.isArray(expected) &&
-                expected.some((entry) => sameFilterValue(value, entry)));
+            return Array.isArray(expected) && expected.some(matchesEntry);
         case 'notIn':
-            return (Array.isArray(expected) &&
-                !expected.some((entry) => sameFilterValue(value, entry)));
+            return Array.isArray(expected) && !expected.some(matchesEntry);
         case 'gt':
-            return compareFilterValues(value, expected) > 0;
         case 'gte':
-            return compareFilterValues(value, expected) >= 0;
         case 'lt':
-            return compareFilterValues(value, expected) < 0;
-        case 'lte':
-            return compareFilterValues(value, expected) <= 0;
+        case 'lte': {
+            // An absent value takes part in no ordered comparison, exactly as SQL
+            // yields UNKNOWN for NULL. Without this the flattened empty string sorts
+            // below everything, so `publish_date lt X` would match every row that was
+            // never published — and disagree with the server for the same link.
+            if (isAbsentContentValue(row, column))
+                return false;
+            const comparison = compareFilterValues(value, expected);
+            if (filter.operator === 'gt')
+                return comparison > 0;
+            if (filter.operator === 'gte')
+                return comparison >= 0;
+            if (filter.operator === 'lt')
+                return comparison < 0;
+            return comparison <= 0;
+        }
         case 'isNull':
-            return value === null || value === undefined;
+            return (isAbsentContentValue(row, column) ||
+                value === null ||
+                value === undefined);
         case 'isNotNull':
-            return value !== null && value !== undefined;
+            return !(isAbsentContentValue(row, column) ||
+                value === null ||
+                value === undefined);
         default:
             return false;
     }
@@ -498,7 +757,7 @@ export function selectContentListRows(rows, state, columns = buildContentListCol
     const filtered = rows.filter((row) => {
         if (search &&
             !columns.some((column) => column.searchable !== false &&
-                textValue(getNestedValue(row, String(column.accessor ?? column.id))).includes(search))) {
+                textValue(comparisonValue(row, column)).includes(search))) {
             return false;
         }
         return state.filters.every((filter) => {
@@ -513,6 +772,18 @@ export function selectContentListRows(rows, state, columns = buildContentListCol
             const column = columns.find((candidate) => candidate.id === rule.columnId);
             if (!column)
                 continue;
+            // Absent values sort LAST ascending and FIRST descending. Without this
+            // an absent value flattens to empty text and sorts first ascending —
+            // which silently changes which rows land on page one when the same list
+            // is served from the query endpoint. See `agents/content-list.md`: the
+            // placement matches the SQL standard and the PostgreSQL/DuckDB default,
+            // and no portable way exists to state it in an `orderBy` term.
+            const leftAbsent = isAbsentContentValue(left, column);
+            const rightAbsent = isAbsentContentValue(right, column);
+            if (leftAbsent !== rightAbsent) {
+                const absentAfter = leftAbsent ? 1 : -1;
+                return rule.direction === 'desc' ? -absentAfter : absentAfter;
+            }
             const result = defaultSort(left, right, String(column.accessor ?? column.id), rule.direction);
             if (result !== 0)
                 return result;