sg-widgets-core 0.1.0 → 0.3.0

package/dist/{client-BhHppzTV.d.mts → client-CP9sWEVZ.d.mts}

@@ -115,6 +115,8 @@ interface RawFieldSchema {
   editable: RawProperty<boolean>;
   mandatory: RawProperty<boolean>;
   unique: RawProperty<boolean>;
+  /** `editable` here says whether the site may hide the field (056_stock_vs_custom_field). */
+  visible?: RawProperty<boolean>;
   properties: Record<string, RawProperty<unknown>>;
 }
 type RawFieldsResponse = {
@@ -145,6 +147,12 @@ interface FieldSchema {
   operators?: Operator[];
   defaultValue?: unknown;
   description?: string;
+  /**
+   * `visible.editable`: whether the site may hide the field. False is stock and safe to
+   * depend on; true is every custom field and a few stock ones, so a strong hint and not
+   * a proof. The `sg_` prefix decides nothing (056_stock_vs_custom_field).
+   */
+  hideable?: boolean;
 }
 /**
  * Fields the schema types one way and the API answers another, keyed
@@ -380,6 +388,13 @@ interface EntityRow {
     data: EntityRef | EntityRef[] | null;
   }>;
 }
+/** What `read` asks for. */
+interface ReadOptions {
+  /** The fields to return. Dotted paths are allowed. */
+  fields?: string[];
+  /** Read a retired row, which answers 404 otherwise; a live row then answers 404 (get_entity_type_id, 103_batch_delete_revive). */
+  retired?: boolean;
+}
 interface SearchResult {
   data: EntityRow[];
   /** True when another page exists. Computed from data length, not `links.next`, which is emitted on empty pages too (probe 006). */
@@ -577,6 +592,57 @@ interface FollowingOptions {
   entity?: string;
   projectId?: number;
 }
+/**
+ * One write of a batch, in the shape `POST /entity/_batch` takes. `entity` is the
+ * schema name, never the URL slug, and the id key is `record_id` (recipes/002).
+ */
+type BatchRequest = {
+  request_type: 'create';
+  entity: string;
+  data: Record<string, unknown>;
+} | {
+  request_type: 'update';
+  entity: string;
+  record_id: number;
+  data: Record<string, unknown>;
+} | {
+  request_type: 'delete';
+  entity: string;
+  record_id: number;
+};
+/**
+ * One row of a batch answer. A create or an update carries its record under `data`;
+ * a delete row is flat, and its `uuid` is generated per request (recipes/002).
+ */
+type BatchResult = {
+  request_type: 'create';
+  data: EntityRow;
+} | {
+  request_type: 'update';
+  data: EntityRow;
+} | {
+  request_type: 'delete';
+  type: string;
+  id: number;
+  uuid: string;
+  did_delete: boolean;
+};
+/** A row of the `_batch` answer before it is paired with its request. */
+type RawBatchRow = {
+  data: EntityRow;
+} | {
+  request_type: 'delete';
+  type: string;
+  id: number;
+  uuid: string;
+  did_delete: boolean;
+};
+/**
+ * Pair each row of a batch answer with the request at its position. Rows come back
+ * one per request in request order, so position is the key: two creates can share a
+ * `code` (recipes/002).
+ */
+declare function batchResults(requests: readonly BatchRequest[], rows: readonly RawBatchRow[]): BatchResult[];
 interface SgClient {
   /** Enabled entity types on the site with their display names. */
   entityTypes(): Promise<EntityTypeInfo[]>;
@@ -588,6 +654,15 @@ interface SgClient {
    */
   fieldWithProject(entityType: string, field: string, projectId: number): Promise<FieldSchema>;
   search(entityType: string, options: SearchOptions): Promise<SearchResult>;
+  /**
+   * One row by id, in the `_search` row shape.
+   *
+   * A row that is not there rejects 404 code 104, and a retired row answers the same
+   * 404 unless read with `retired`: only that second read tells the two apart
+   * (get_entity_type_id). A batch create with no `project` answers an id this read
+   * never reaches (recipes/002).
+   */
+  read(entityType: string, id: number, options?: ReadOptions): Promise<EntityRow>;
   /**
    * Free-text search across several types at once. Every word must match, each as
    * a case-insensitive substring of the row's name or of the linked row's name
@@ -675,6 +750,32 @@ interface SgClient {
    * (get_entity_human_users_id_following).
    */
   following(userId: number, options?: FollowingOptions): Promise<EntityRef[]>;
+  /**
+   * Retire one row. It is not erased: it reads 404 and comes back with `revive`.
+   * A second delete is 404 (delete_entity_type_id). Deleting a row changes others:
+   * a Shot retires its Versions (probe 060), and a Task retires its dependencies and
+   * nulls `Version.sg_task` and `PublishedFile.task` without saying so
+   * (089_task_delete_side_effects).
+   */
+  delete(entityType: string, id: number): Promise<void>;
+  /**
+   * Bring a retired row back with the values it had, and answer whether it was
+   * retired: `false` means it was already live (post_entity_type_id). A revived Task
+   * gets its links back and its chain rescheduled (089_task_delete_side_effects).
+   */
+  revive(entityType: string, id: number): Promise<boolean>;
+  /**
+   * Apply creates, updates and deletes in one atomic call, one result per request in
+   * request order.
+   *
+   * One failing request rolls back every other one and rejects with its status and
+   * title. A request cannot point at a row another request of the same batch creates:
+   * send one batch per level. A create inside a batch skips the `project` check a
+   * single create makes and answers the id of a row no read reaches (report 001), so
+   * validate the payload first. A read timeout says nothing about what landed; keep a
+   * batch to about 200 requests and make it re-runnable (recipes/002).
+   */
+  batch(requests: BatchRequest[]): Promise<BatchResult[]>;
 }
 /** The node shape `/hierarchy/_expand` answers, before normalising. */
 interface RawHierarchyNode {
@@ -719,12 +820,16 @@ declare class RestClient implements SgClient {
   fields(entityType: string, projectId?: number): Promise<Record<string, FieldSchema>>;
   fieldWithProject(entityType: string, field: string, projectId: number): Promise<FieldSchema>;
   search(entityType: string, options: SearchOptions): Promise<SearchResult>;
+  read(entityType: string, id: number, options?: ReadOptions): Promise<EntityRow>;
   textSearch(text: string, entityTypes: Record<string, TextSearchFilter>, page?: {
     size?: number;
     number?: number;
   }): Promise<TextSearchRow[]>;
   update(entityType: string, id: number, patch: Record<string, unknown>): Promise<EntityRow>;
   create(entityType: string, body: Record<string, unknown>): Promise<EntityRow>;
+  delete(entityType: string, id: number): Promise<void>;
+  revive(entityType: string, id: number): Promise<boolean>;
+  batch(requests: BatchRequest[]): Promise<BatchResult[]>;
   upload(entityType: string, id: number, file: UploadFile): Promise<UploadResult>;
   summarize(entityType: string, options?: SummarizeOptions): Promise<SummarizeResult>;
   threadContents(noteId: number, entityFields?: Record<string, string[]>): Promise<ThreadRow[]>;
@@ -737,4 +842,4 @@ declare class RestClient implements SgClient {
 /** One `_search` row of `EventLogEntry`, with `meta` decoded as the API returns it. */
 declare function normalizeEventLogEntry(row: EntityRow): EventLogEntry;
 //#endregion
-export { STOCK_SPRITE_PATH as $, isOperator as $t, hierarchyEntity as A, emptyFilter as At, intersectStatuses as B, DataType as Bt, SummaryType as C, FilterNode as Ct, UploadFile as D, WireCondition as Dt, ThreadRow as E, TextSearchFilter as Et, StatusIcon as F, referencedPaths as Ft, statusLabel as G, TIME_UNITS as Gt, relativeLuminance as H, OPERATORS as Ht, StatusOption as I, toApi3Hash as It, NATIVE_STATUSES as J, ValueShape as Jt, statusPaint as K, TimeUnit as Kt, StatusPaint as L, toFilterArray as Lt, normalizeHierarchyNode as M, group as Mt, Rgb as N, isBlankCondition as Nt, UploadResult as O, WireGroup as Ot, StatusGlyph as P, isEmptyFilter as Pt, STOCK_ICON_KEYS as Q, isNumericType as Qt, StatusRecord as R, walk as Rt, SummaryGrouping as S, FilterGroup as St, ThreadAuthor as T, Scalar as Tt, rgbToCss as U, OPERATORS_BY_TYPE as Ut, parseBgColor as V, NEGATING_OPERATORS as Vt, statusGlyph as W, Operator as Wt, STOCK_ICON_CELLS as X, isFilterable as Xt, NativeStatus as Y, isDataType as Yt, STOCK_ICON_DATA_URLS as Z, isLinkType as Zt, SgClient as _, statusFieldNameFor as _t, EventLogOptions as a, stockIconSource as at, SummaryField as b, EntityRef as bt, HierarchyNode as c, FieldSchema as ct, RawHierarchyNode as d, RawProperty as dt, isTemporalType as en, SpriteCell as et, RestClient as f, displayNameOf as ft, SgApiError as g, statusFieldFor as gt, SearchResult as h, normalizeFields as ht, EventLogEntry as i, spriteStyle as it, normalizeEventLogEntry as j, fromWire as jt, eventLogFilters as k, condition as kt, HierarchyPath as l, RawFieldSchema as lt, SearchOptions as m, normalizeField as mt, EntityRow as n, supportsOperator as nn, isNativeStatus as nt, EventLogResult as o, DISPLAY_NAME_FIELDS as ot, RestClientOptions as p, fieldSchemaOverride as pt, usableStatuses as q, VALUE_SHAPE as qt, EntityTypeInfo as r, nativeStatus as rt, FollowingOptions as s, FIELD_SCHEMA_OVERRIDES as st, EVENT_LOG_FIELDS as t, operatorsFor as tn, StockIconSource as tt, HierarchyRef as u, RawFieldsResponse as ut, SummarizeOptions as v, undeclaredField as vt, TextSearchRow as w, LogicalOperator as wt, SummaryGroup as x, FilterCondition as xt, SummarizeResult as y, ConditionValue as yt, foregroundFor as z, DATA_TYPES as zt };
+export { NATIVE_STATUSES as $, ValueShape as $t, ThreadRow as A, Scalar as At, StatusIcon as B, referencedPaths as Bt, SummarizeResult as C, undeclaredField as Ct, SummaryType as D, FilterGroup as Dt, SummaryGrouping as E, FilterCondition as Et, hierarchyEntity as F, emptyFilter as Ft, intersectStatuses as G, DataType as Gt, StatusPaint as H, toFilterArray as Ht, normalizeEventLogEntry as I, fromWire as It, rgbToCss as J, OPERATORS_BY_TYPE as Jt, parseBgColor as K, NEGATING_OPERATORS as Kt, normalizeHierarchyNode as L, group as Lt, UploadResult as M, WireCondition as Mt, batchResults as N, WireGroup as Nt, TextSearchRow as O, FilterNode as Ot, eventLogFilters as P, condition as Pt, usableStatuses as Q, VALUE_SHAPE as Qt, Rgb as R, isBlankCondition as Rt, SummarizeOptions as S, statusFieldNameFor as St, SummaryGroup as T, EntityRef as Tt, StatusRecord as U, walk as Ut, StatusOption as V, toApi3Hash as Vt, foregroundFor as W, DATA_TYPES as Wt, statusLabel as X, TIME_UNITS as Xt, statusGlyph as Y, Operator as Yt, statusPaint as Z, TimeUnit as Zt, RestClientOptions as _, displayNameOf as _t, EntityTypeInfo as a, isTemporalType as an, SpriteCell as at, SgApiError as b, normalizeFields as bt, EventLogResult as c, nativeStatus as ct, HierarchyPath as d, DISPLAY_NAME_FIELDS as dt, isDataType as en, NativeStatus as et, HierarchyRef as f, FIELD_SCHEMA_OVERRIDES as ft, RestClient as g, RawProperty as gt, ReadOptions as h, RawFieldsResponse as ht, EntityRow as i, isOperator as in, STOCK_SPRITE_PATH as it, UploadFile as j, TextSearchFilter as jt, ThreadAuthor as k, LogicalOperator as kt, FollowingOptions as l, spriteStyle as lt, RawHierarchyNode as m, RawFieldSchema as mt, BatchResult as n, isLinkType as nn, STOCK_ICON_DATA_URLS as nt, EventLogEntry as o, operatorsFor as on, StockIconSource as ot, RawBatchRow as p, FieldSchema as pt, relativeLuminance as q, OPERATORS as qt, EVENT_LOG_FIELDS as r, isNumericType as rn, STOCK_ICON_KEYS as rt, EventLogOptions as s, supportsOperator as sn, isNativeStatus as st, BatchRequest as t, isFilterable as tn, STOCK_ICON_CELLS as tt, HierarchyNode as u, stockIconSource as ut, SearchOptions as v, fieldSchemaOverride as vt, SummaryField as w, ConditionValue as wt, SgClient as x, statusFieldFor as xt, SearchResult as y, normalizeField as yt, StatusGlyph as z, isEmptyFilter as zt };

package/dist/{client-DwN_-UuF.mjs → client-izKszX7l.mjs}

@@ -452,6 +452,7 @@ function normalizeField(name, raw) {
 	if (defaultValue !== void 0) field.defaultValue = defaultValue;
 	const description = prop(props, "description");
 	if (description) field.description = description;
+	if (raw.visible) field.hideable = raw.visible.editable;
 	return {
 		...field,
 		...fieldSchemaOverride(field.entityType, name)
@@ -607,6 +608,30 @@ const EVENT_LOG_FIELDS = [
 	"user"
 ];
 /**
+* Pair each row of a batch answer with the request at its position. Rows come back
+* one per request in request order, so position is the key: two creates can share a
+* `code` (recipes/002).
+*/
+function batchResults(requests, rows) {
+	return rows.map((row, i) => {
+		const kind = requests[i]?.request_type;
+		if (kind === "delete" || !("data" in row)) {
+			const flat = row;
+			return {
+				request_type: "delete",
+				type: flat.type,
+				id: flat.id,
+				uuid: flat.uuid,
+				did_delete: flat.did_delete
+			};
+		}
+		return {
+			request_type: kind === "update" ? "update" : "create",
+			data: row.data
+		};
+	});
+}
+/**
 * Normalise one node and the level below it.
 *
 * The sample response gives a child a `label`, a `ref` and `has_children` but not
@@ -736,6 +761,13 @@ var RestClient = class {
 			hasMore: res.data.length === size
 		};
 	}
+	async read(entityType, id, options = {}) {
+		const params = {
+			fields: options.fields?.join(","),
+			"options[return_only]": options.retired ? "retired" : void 0
+		};
+		return (await this.request("GET", `/entity/${pluralPath(entityType)}/${id}`, void 0, params)).data;
+	}
 	async textSearch(text, entityTypes, page) {
 		const types = {};
 		for (const [t, f] of Object.entries(entityTypes)) types[t] = toHashGroup(f);
@@ -755,6 +787,15 @@ var RestClient = class {
 	async create(entityType, body) {
 		return (await this.request("POST", `/entity/${pluralPath(entityType)}`, body, void 0, "application/json")).data;
 	}
+	async delete(entityType, id) {
+		await this.request("DELETE", `/entity/${pluralPath(entityType)}/${id}`);
+	}
+	async revive(entityType, id) {
+		return (await this.request("POST", `/entity/${pluralPath(entityType)}/${id}`, void 0, { revive: 1 })).meta?.did_revive === true;
+	}
+	async batch(requests) {
+		return batchResults(requests, (await this.request("POST", "/entity/_batch", { requests }, void 0, "application/json")).data);
+	}
 	async upload(entityType, id, file) {
 		const field = file.field === void 0 ? "" : `/${file.field}`;
 		const ticket = await this.request("GET", `/entity/${pluralPath(entityType)}/${id}${field}/_upload`, void 0, { filename: file.filename });
@@ -1012,4 +1053,4 @@ function toStatusIcon(a) {
 	}
 }
 //#endregion
-export { OPERATORS as A, operatorsFor as B, isEmptyFilter as C, walk as D, toFilterArray as E, isFilterable as F, isLinkType as I, isNumericType as L, TIME_UNITS as M, VALUE_SHAPE as N, DATA_TYPES as O, isDataType as P, isOperator as R, isBlankCondition as S, toApi3Hash as T, supportsOperator as V, pluralPath as _, hierarchyEntity as a, fromWire as b, DISPLAY_NAME_FIELDS as c, fieldSchemaOverride as d, normalizeField as f, undeclaredField as g, statusFieldNameFor as h, eventLogFilters as i, OPERATORS_BY_TYPE as j, NEGATING_OPERATORS as k, FIELD_SCHEMA_OVERRIDES as l, statusFieldFor as m, RestClient as n, normalizeEventLogEntry as o, normalizeFields as p, SgApiError as r, normalizeHierarchyNode as s, EVENT_LOG_FIELDS as t, displayNameOf as u, condition as v, referencedPaths as w, group as x, emptyFilter as y, isTemporalType as z };
+export { NEGATING_OPERATORS as A, isTemporalType as B, isBlankCondition as C, toFilterArray as D, toApi3Hash as E, isDataType as F, supportsOperator as H, isFilterable as I, isLinkType as L, OPERATORS_BY_TYPE as M, TIME_UNITS as N, walk as O, VALUE_SHAPE as P, isNumericType as R, group as S, referencedPaths as T, operatorsFor as V, undeclaredField as _, eventLogFilters as a, emptyFilter as b, normalizeHierarchyNode as c, displayNameOf as d, fieldSchemaOverride as f, statusFieldNameFor as g, statusFieldFor as h, batchResults as i, OPERATORS as j, DATA_TYPES as k, DISPLAY_NAME_FIELDS as l, normalizeFields as m, RestClient as n, hierarchyEntity as o, normalizeField as p, SgApiError as r, normalizeEventLogEntry as s, EVENT_LOG_FIELDS as t, FIELD_SCHEMA_OVERRIDES as u, pluralPath as v, isEmptyFilter as w, fromWire as x, condition as y, isOperator as z };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as STOCK_SPRITE_PATH, $t as isOperator, A as hierarchyEntity, At as emptyFilter, B as intersectStatuses, Bt as DataType, C as SummaryType, Ct as FilterNode, D as UploadFile, Dt as WireCondition, E as ThreadRow, Et as TextSearchFilter, F as StatusIcon, Ft as referencedPaths, G as statusLabel, Gt as TIME_UNITS, H as relativeLuminance, Ht as OPERATORS, I as StatusOption, It as toApi3Hash, J as NATIVE_STATUSES, Jt as ValueShape, K as statusPaint, Kt as TimeUnit, L as StatusPaint, Lt as toFilterArray, M as normalizeHierarchyNode, Mt as group, N as Rgb, Nt as isBlankCondition, O as UploadResult, Ot as WireGroup, P as StatusGlyph, Pt as isEmptyFilter, Q as STOCK_ICON_KEYS, Qt as isNumericType, R as StatusRecord, Rt as walk, S as SummaryGrouping, St as FilterGroup, T as ThreadAuthor, Tt as Scalar, U as rgbToCss, Ut as OPERATORS_BY_TYPE, V as parseBgColor, Vt as NEGATING_OPERATORS, W as statusGlyph, Wt as Operator, X as STOCK_ICON_CELLS, Xt as isFilterable, Y as NativeStatus, Yt as isDataType, Z as STOCK_ICON_DATA_URLS, Zt as isLinkType, _ as SgClient, _t as statusFieldNameFor, a as EventLogOptions, at as stockIconSource, b as SummaryField, bt as EntityRef, c as HierarchyNode, ct as FieldSchema, d as RawHierarchyNode, dt as RawProperty, en as isTemporalType, et as SpriteCell, f as RestClient, ft as displayNameOf, g as SgApiError, gt as statusFieldFor, h as SearchResult, ht as normalizeFields, i as EventLogEntry, it as spriteStyle, j as normalizeEventLogEntry, jt as fromWire, k as eventLogFilters, kt as condition, l as HierarchyPath, lt as RawFieldSchema, m as SearchOptions, mt as normalizeField, n as EntityRow, nn as supportsOperator, nt as isNativeStatus, o as EventLogResult, ot as DISPLAY_NAME_FIELDS, p as RestClientOptions, pt as fieldSchemaOverride, q as usableStatuses, qt as VALUE_SHAPE, r as EntityTypeInfo, rt as nativeStatus, s as FollowingOptions, st as FIELD_SCHEMA_OVERRIDES, t as EVENT_LOG_FIELDS, tn as operatorsFor, tt as StockIconSource, u as HierarchyRef, ut as RawFieldsResponse, v as SummarizeOptions, vt as undeclaredField, w as TextSearchRow, wt as LogicalOperator, x as SummaryGroup, xt as FilterCondition, y as SummarizeResult, yt as ConditionValue, z as foregroundFor, zt as DATA_TYPES } from "./client-BhHppzTV.mjs";
+import { $ as NATIVE_STATUSES, $t as ValueShape, A as ThreadRow, At as Scalar, B as StatusIcon, Bt as referencedPaths, C as SummarizeResult, Ct as undeclaredField, D as SummaryType, Dt as FilterGroup, E as SummaryGrouping, Et as FilterCondition, F as hierarchyEntity, Ft as emptyFilter, G as intersectStatuses, Gt as DataType, H as StatusPaint, Ht as toFilterArray, I as normalizeEventLogEntry, It as fromWire, J as rgbToCss, Jt as OPERATORS_BY_TYPE, K as parseBgColor, Kt as NEGATING_OPERATORS, L as normalizeHierarchyNode, Lt as group, M as UploadResult, Mt as WireCondition, N as batchResults, Nt as WireGroup, O as TextSearchRow, Ot as FilterNode, P as eventLogFilters, Pt as condition, Q as usableStatuses, Qt as VALUE_SHAPE, R as Rgb, Rt as isBlankCondition, S as SummarizeOptions, St as statusFieldNameFor, T as SummaryGroup, Tt as EntityRef, U as StatusRecord, Ut as walk, V as StatusOption, Vt as toApi3Hash, W as foregroundFor, Wt as DATA_TYPES, X as statusLabel, Xt as TIME_UNITS, Y as statusGlyph, Yt as Operator, Z as statusPaint, Zt as TimeUnit, _ as RestClientOptions, _t as displayNameOf, a as EntityTypeInfo, an as isTemporalType, at as SpriteCell, b as SgApiError, bt as normalizeFields, c as EventLogResult, ct as nativeStatus, d as HierarchyPath, dt as DISPLAY_NAME_FIELDS, en as isDataType, et as NativeStatus, f as HierarchyRef, ft as FIELD_SCHEMA_OVERRIDES, g as RestClient, gt as RawProperty, h as ReadOptions, ht as RawFieldsResponse, i as EntityRow, in as isOperator, it as STOCK_SPRITE_PATH, j as UploadFile, jt as TextSearchFilter, k as ThreadAuthor, kt as LogicalOperator, l as FollowingOptions, lt as spriteStyle, m as RawHierarchyNode, mt as RawFieldSchema, n as BatchResult, nn as isLinkType, nt as STOCK_ICON_DATA_URLS, o as EventLogEntry, on as operatorsFor, ot as StockIconSource, p as RawBatchRow, pt as FieldSchema, q as relativeLuminance, qt as OPERATORS, r as EVENT_LOG_FIELDS, rn as isNumericType, rt as STOCK_ICON_KEYS, s as EventLogOptions, sn as supportsOperator, st as isNativeStatus, t as BatchRequest, tn as isFilterable, tt as STOCK_ICON_CELLS, u as HierarchyNode, ut as stockIconSource, v as SearchOptions, vt as fieldSchemaOverride, w as SummaryField, wt as ConditionValue, x as SgClient, xt as statusFieldFor, y as SearchResult, yt as normalizeField, z as StatusGlyph, zt as isEmptyFilter } from "./client-CP9sWEVZ.mjs";
 //#region src/field-icons.d.ts
 /** The catch-all glyph, used for a data type this build does not know. */
 export declare const DEFAULT_FIELD_ICON = "file-text";
@@ -1154,6 +1154,11 @@ export interface EntitySource {
   loadMore(): Promise<void>;
   /** Read every page already shown again, keeping the row count. */
   refresh(): Promise<void>;
+  /**
+   * Read these paths as well. The rows already shown are read again when one of them
+   * is new, keeping the row count and the total; otherwise nothing is read.
+   */
+  addFields(paths: readonly string[]): Promise<void>;
   setFilters(filters: SourceFilters): Promise<void>;
   setSort(sort: SortSpec[]): Promise<void>;
   /** Show one page of the set. `pages` mode only. */
@@ -1766,12 +1771,16 @@ export declare class ProxyClient implements SgClient {
   fields(entityType: string, projectId?: number): Promise<Record<string, FieldSchema>>;
   fieldWithProject(entityType: string, field: string, projectId: number): Promise<FieldSchema>;
   search(entityType: string, options: SearchOptions): Promise<SearchResult>;
+  read(entityType: string, id: number, options?: ReadOptions): Promise<EntityRow>;
   textSearch(text: string, entityTypes: Record<string, TextSearchFilter>, page?: {
     size?: number;
     number?: number;
   }): Promise<TextSearchRow[]>;
   statuses(): Promise<StatusRecord[]>;
   create(entityType: string, body: Record<string, unknown>): Promise<EntityRow>;
+  delete(entityType: string, id: number): Promise<void>;
+  revive(entityType: string, id: number): Promise<boolean>;
+  batch(requests: BatchRequest[]): Promise<BatchResult[]>;
   /** The bytes cross the protocol base64-encoded; the handler runs the three calls. */
   upload(entityType: string, id: number, file: UploadFile): Promise<UploadResult>;
   update(entityType: string, id: number, patch: Record<string, unknown>): Promise<EntityRow>;
@@ -1785,7 +1794,7 @@ export declare class ProxyClient implements SgClient {
 //#endregion
 //#region src/proxy-handler.d.ts
 /** The methods the protocol carries, one POST each. */
-export declare const PROXY_METHODS: readonly ['entityTypes', 'fields', 'fieldWithProject', 'search', 'textSearch', 'statuses', 'create', 'update', 'upload', 'hierarchyExpand', 'hierarchySearch', 'summarize', 'threadContents', 'eventLog', 'following'];
+export declare const PROXY_METHODS: readonly ['entityTypes', 'fields', 'fieldWithProject', 'search', 'read', 'textSearch', 'statuses', 'create', 'update', 'upload', 'hierarchyExpand', 'hierarchySearch', 'summarize', 'threadContents', 'eventLog', 'following', 'delete', 'revive', 'batch'];
 export type ProxyMethod = (typeof PROXY_METHODS)[number];
 /** An error as it crosses the wire. `ProxyClient` rebuilds an `SgApiError` from it. */
 export interface ProxyError {
@@ -2354,6 +2363,94 @@ export declare function collapseStateFrom(state: CollapseState, shut: readonly s
 /** True when two collapse states shut the same groups. */
 export declare function sameCollapse(a: CollapseState, b: CollapseState): boolean;
 //#endregion
+//#region src/selection.d.ts
+/** Where a range starts and what it is laid over. */
+export interface SelectionAnchor {
+  /** The row the range runs from, `Type:id`. */
+  key: string;
+  /** True when the range selects, false when it clears: what the anchor row became. */
+  on: boolean;
+  /** The selection the range is laid over. */
+  base: EntityRef[];
+  /** The selection the last step produced. One that no longer reads this has moved under the anchor. */
+  last: EntityRef[];
+}
+/** A selection and the anchor the next Shift gesture ranges from. */
+export interface SelectionStep {
+  selection: EntityRef[];
+  anchor: SelectionAnchor | null;
+}
+/** What a press on a row does: toggle it, or range to it. */
+export type SelectionGesture = 'toggle' | 'range';
+/** What a key does to the selection. */
+export type SelectionKeyIntent = 'toggle' | 'extend-up' | 'extend-down' | 'all';
+interface Modifiers {
+  shiftKey?: boolean;
+  metaKey?: boolean;
+  ctrlKey?: boolean;
+  altKey?: boolean;
+}
+/** Shift ranges; a plain press and Cmd or Ctrl both toggle. */
+export declare function gestureOf(event: Modifiers): SelectionGesture;
+/** Space toggles, Shift+ArrowUp and Shift+ArrowDown extend, Cmd or Ctrl+A takes every loaded row. */
+export declare function selectionKeyIntent(event: Modifiers & {
+  key: string;
+}): SelectionKeyIntent | null;
+/** `selection` with every ref of `refs` added, or every one of them dropped. */
+export declare function setRefs(selection: readonly EntityRef[], refs: readonly EntityRef[], on: boolean): EntityRef[];
+/** Toggle the row at `index` and anchor on it. A disabled row refuses. */
+export declare function toggleRow(selection: readonly EntityRef[], anchor: SelectionAnchor | null, rows: readonly EntityRow[], index: number, isRowDisabled?: RowDisabledFn | null): SelectionStep;
+/**
+ * Range from the anchor to the row at `index`, skipping disabled rows.
+ *
+ * With no anchor among the rows, the row pressed is selected and becomes the anchor.
+ */
+export declare function extendRange(selection: readonly EntityRef[], anchor: SelectionAnchor | null, rows: readonly EntityRow[], index: number, isRowDisabled?: RowDisabledFn | null): SelectionStep;
+/**
+ * Shift+arrow: move the far end of the range from row `from` to row `to`. With no
+ * anchor among the rows, the row the cursor leaves becomes one, selecting.
+ */
+export declare function extendByStep(selection: readonly EntityRef[], anchor: SelectionAnchor | null, rows: readonly EntityRow[], from: number, to: number, isRowDisabled?: RowDisabledFn | null): SelectionStep;
+/** What the line offering the whole set reads. */
+export interface MatchingOffer {
+  show: boolean;
+  /** How many rows the set holds, when something counted it. */
+  total: number | null;
+}
+/**
+ * Whether to offer every row the filter matches: once every loaded row is picked and
+ * the set holds more than is loaded, until the selection covers a counted set.
+ */
+export declare function matchingOffer(state: {
+  allLoaded: boolean;
+  loaded: number;
+  selected: number;
+  hasMore: boolean;
+  total: number | null;
+}): MatchingOffer;
+//#endregion
+//#region src/column-choice.d.ts
+/** Where a choice is kept: the caller's key, or one per entity type. */
+export declare function columnsStorageKey(entityType: string, key?: string | null): string;
+/** A stored choice as paths. Null for nothing, an empty list, or anything that is not a list of paths. */
+export declare function parseColumnChoice(raw: string | null | undefined): string[] | null;
+/** The string a choice is kept as. */
+export declare function serializeColumnChoice(paths: readonly string[]): string;
+/** The paths of a column list, in order. */
+export declare function columnPaths(columns: readonly CollectionColumn[]): string[];
+/** True when two path lists name the same columns in the same order. */
+export declare function sameColumnPaths(a: readonly string[], b: readonly string[]): boolean;
+/** The paths a source with `fields` does not read yet. */
+export declare function unreadPaths(fields: readonly string[], paths: readonly string[]): string[];
+/** The known columns in the order `paths` names them. A path none of them carries is dropped. */
+export declare function arrangeColumns(paths: readonly string[], known: readonly CollectionColumn[]): CollectionColumn[];
+/**
+ * A choice as columns: the ones already resolved are kept as they are, the rest are
+ * resolved from the schema, and a path the type does not have is skipped, so a
+ * choice kept before a field was removed still opens.
+ */
+export declare function resolveColumnChoice(schema: SchemaService, entityType: string, paths: readonly string[], known: readonly CollectionColumn[]): Promise<CollectionColumn[]>;
+//#endregion
 //#region src/entity-card.d.ts
 export interface EntityCardOptions {
   /** Dotted field paths for the grid, in order. */
@@ -2723,4 +2820,4 @@ export declare function markOverflow(list: HTMLElement | null | undefined): bool
  */
 export declare function watchOverflow(list: HTMLElement | null | undefined): () => void;
 //#endregion
-export { ConditionValue, DATA_TYPES, DISPLAY_NAME_FIELDS, DataType, EVENT_LOG_FIELDS, EntityRef, EntityRow, EntityTypeInfo, EventLogEntry, EventLogOptions, EventLogResult, FIELD_SCHEMA_OVERRIDES, FieldSchema, FilterCondition, FilterGroup, FilterNode, FollowingOptions, HierarchyNode, HierarchyPath, HierarchyRef, LogicalOperator, NATIVE_STATUSES, NEGATING_OPERATORS, NativeStatus, OPERATORS, OPERATORS_BY_TYPE, Operator, RawFieldSchema, RawFieldsResponse, RawHierarchyNode, RawProperty, RestClient, RestClientOptions, Rgb, STOCK_ICON_CELLS, STOCK_ICON_DATA_URLS, STOCK_ICON_KEYS, STOCK_SPRITE_PATH, Scalar, SearchOptions, SearchResult, SgApiError, SgClient, SpriteCell, StatusGlyph, StatusIcon, StatusOption, StatusPaint, StatusRecord, StockIconSource, SummarizeOptions, SummarizeResult, SummaryField, SummaryGroup, SummaryGrouping, SummaryType, TIME_UNITS, TextSearchFilter, TextSearchRow, ThreadAuthor, ThreadRow, TimeUnit, UploadFile, UploadResult, VALUE_SHAPE, ValueShape, WireCondition, WireGroup, condition, displayNameOf, emptyFilter, eventLogFilters, fieldSchemaOverride, foregroundFor, fromWire, group, hierarchyEntity, intersectStatuses, isBlankCondition, isDataType, isEmptyFilter, isFilterable, isLinkType, isNativeStatus, isNumericType, isOperator, isTemporalType, nativeStatus, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, operatorsFor, parseBgColor, referencedPaths, relativeLuminance, rgbToCss, spriteStyle, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, stockIconSource, supportsOperator, toApi3Hash, toFilterArray, undeclaredField, usableStatuses, walk };
+export { BatchRequest, BatchResult, ConditionValue, DATA_TYPES, DISPLAY_NAME_FIELDS, DataType, EVENT_LOG_FIELDS, EntityRef, EntityRow, EntityTypeInfo, EventLogEntry, EventLogOptions, EventLogResult, FIELD_SCHEMA_OVERRIDES, FieldSchema, FilterCondition, FilterGroup, FilterNode, FollowingOptions, HierarchyNode, HierarchyPath, HierarchyRef, LogicalOperator, NATIVE_STATUSES, NEGATING_OPERATORS, NativeStatus, OPERATORS, OPERATORS_BY_TYPE, Operator, RawBatchRow, RawFieldSchema, RawFieldsResponse, RawHierarchyNode, RawProperty, ReadOptions, RestClient, RestClientOptions, Rgb, STOCK_ICON_CELLS, STOCK_ICON_DATA_URLS, STOCK_ICON_KEYS, STOCK_SPRITE_PATH, Scalar, SearchOptions, SearchResult, SgApiError, SgClient, SpriteCell, StatusGlyph, StatusIcon, StatusOption, StatusPaint, StatusRecord, StockIconSource, SummarizeOptions, SummarizeResult, SummaryField, SummaryGroup, SummaryGrouping, SummaryType, TIME_UNITS, TextSearchFilter, TextSearchRow, ThreadAuthor, ThreadRow, TimeUnit, UploadFile, UploadResult, VALUE_SHAPE, ValueShape, WireCondition, WireGroup, batchResults, condition, displayNameOf, emptyFilter, eventLogFilters, fieldSchemaOverride, foregroundFor, fromWire, group, hierarchyEntity, intersectStatuses, isBlankCondition, isDataType, isEmptyFilter, isFilterable, isLinkType, isNativeStatus, isNumericType, isOperator, isTemporalType, nativeStatus, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, operatorsFor, parseBgColor, referencedPaths, relativeLuminance, rgbToCss, spriteStyle, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, stockIconSource, supportsOperator, toApi3Hash, toFilterArray, undeclaredField, usableStatuses, walk };