sg-widgets-core 0.2.0 → 0.3.0

package/dist/{client-B2PCySg9.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). */
@@ -639,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
@@ -796,6 +820,7 @@ 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;
@@ -817,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 { NativeStatus as $, isDataType as $t, UploadFile as A, TextSearchFilter as At, StatusOption as B, toApi3Hash as Bt, SummaryField as C, ConditionValue as Ct, TextSearchRow as D, FilterNode as Dt, SummaryType as E, FilterGroup as Et, normalizeEventLogEntry as F, fromWire as Ft, parseBgColor as G, NEGATING_OPERATORS as Gt, StatusRecord as H, walk as Ht, normalizeHierarchyNode as I, group as It, statusGlyph as J, Operator as Jt, relativeLuminance as K, OPERATORS as Kt, Rgb as L, isBlankCondition as Lt, batchResults as M, WireGroup as Mt, eventLogFilters as N, condition as Nt, ThreadAuthor as O, LogicalOperator as Ot, hierarchyEntity as P, emptyFilter as Pt, NATIVE_STATUSES as Q, ValueShape as Qt, StatusGlyph as R, isEmptyFilter as Rt, SummarizeResult as S, undeclaredField as St, SummaryGrouping as T, FilterCondition as Tt, foregroundFor as U, DATA_TYPES as Ut, StatusPaint as V, toFilterArray as Vt, intersectStatuses as W, DataType as Wt, statusPaint as X, TimeUnit as Xt, statusLabel as Y, TIME_UNITS as Yt, usableStatuses as Z, VALUE_SHAPE as Zt, SearchOptions as _, fieldSchemaOverride as _t, EntityTypeInfo as a, operatorsFor as an, StockIconSource as at, SgClient as b, statusFieldFor as bt, EventLogResult as c, spriteStyle as ct, HierarchyPath as d, FIELD_SCHEMA_OVERRIDES as dt, isFilterable as en, STOCK_ICON_CELLS as et, HierarchyRef as f, FieldSchema as ft, RestClientOptions as g, displayNameOf as gt, RestClient as h, RawProperty as ht, EntityRow as i, isTemporalType as in, SpriteCell as it, UploadResult as j, WireCondition as jt, ThreadRow as k, Scalar as kt, FollowingOptions as l, stockIconSource as lt, RawHierarchyNode as m, RawFieldsResponse as mt, BatchResult as n, isNumericType as nn, STOCK_ICON_KEYS as nt, EventLogEntry as o, supportsOperator as on, isNativeStatus as ot, RawBatchRow as p, RawFieldSchema as pt, rgbToCss as q, OPERATORS_BY_TYPE as qt, EVENT_LOG_FIELDS as r, isOperator as rn, STOCK_SPRITE_PATH as rt, EventLogOptions as s, nativeStatus as st, BatchRequest as t, isLinkType as tn, STOCK_ICON_DATA_URLS as tt, HierarchyNode as u, DISPLAY_NAME_FIELDS as ut, SearchResult as v, normalizeField as vt, SummaryGroup as w, EntityRef as wt, SummarizeOptions as x, statusFieldNameFor as xt, SgApiError as y, normalizeFields as yt, StatusIcon as z, referencedPaths 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-BdePDloQ.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)
@@ -760,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);

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $ as NativeStatus, $t as isDataType, A as UploadFile, At as TextSearchFilter, B as StatusOption, Bt as toApi3Hash, C as SummaryField, Ct as ConditionValue, D as TextSearchRow, Dt as FilterNode, E as SummaryType, Et as FilterGroup, F as normalizeEventLogEntry, Ft as fromWire, G as parseBgColor, Gt as NEGATING_OPERATORS, H as StatusRecord, Ht as walk, I as normalizeHierarchyNode, It as group, J as statusGlyph, Jt as Operator, K as relativeLuminance, Kt as OPERATORS, L as Rgb, Lt as isBlankCondition, M as batchResults, Mt as WireGroup, N as eventLogFilters, Nt as condition, O as ThreadAuthor, Ot as LogicalOperator, P as hierarchyEntity, Pt as emptyFilter, Q as NATIVE_STATUSES, Qt as ValueShape, R as StatusGlyph, Rt as isEmptyFilter, S as SummarizeResult, St as undeclaredField, T as SummaryGrouping, Tt as FilterCondition, U as foregroundFor, Ut as DATA_TYPES, V as StatusPaint, Vt as toFilterArray, W as intersectStatuses, Wt as DataType, X as statusPaint, Xt as TimeUnit, Y as statusLabel, Yt as TIME_UNITS, Z as usableStatuses, Zt as VALUE_SHAPE, _ as SearchOptions, _t as fieldSchemaOverride, a as EntityTypeInfo, an as operatorsFor, at as StockIconSource, b as SgClient, bt as statusFieldFor, c as EventLogResult, ct as spriteStyle, d as HierarchyPath, dt as FIELD_SCHEMA_OVERRIDES, en as isFilterable, et as STOCK_ICON_CELLS, f as HierarchyRef, ft as FieldSchema, g as RestClientOptions, gt as displayNameOf, h as RestClient, ht as RawProperty, i as EntityRow, in as isTemporalType, it as SpriteCell, j as UploadResult, jt as WireCondition, k as ThreadRow, kt as Scalar, l as FollowingOptions, lt as stockIconSource, m as RawHierarchyNode, mt as RawFieldsResponse, n as BatchResult, nn as isNumericType, nt as STOCK_ICON_KEYS, o as EventLogEntry, on as supportsOperator, ot as isNativeStatus, p as RawBatchRow, pt as RawFieldSchema, q as rgbToCss, qt as OPERATORS_BY_TYPE, r as EVENT_LOG_FIELDS, rn as isOperator, rt as STOCK_SPRITE_PATH, s as EventLogOptions, st as nativeStatus, t as BatchRequest, tn as isLinkType, tt as STOCK_ICON_DATA_URLS, u as HierarchyNode, ut as DISPLAY_NAME_FIELDS, v as SearchResult, vt as normalizeField, w as SummaryGroup, wt as EntityRef, x as SummarizeOptions, xt as statusFieldNameFor, y as SgApiError, yt as normalizeFields, z as StatusIcon, zt as referencedPaths } from "./client-B2PCySg9.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,6 +1771,7 @@ 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;
@@ -1788,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', 'delete', 'revive', 'batch'];
+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 {
@@ -2357,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. */
@@ -2726,4 +2820,4 @@ export declare function markOverflow(list: HTMLElement | null | undefined): bool
  */
 export declare function watchOverflow(list: HTMLElement | null | undefined): () => void;
 //#endregion
-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, 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 };
+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 };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as NEGATING_OPERATORS, B as isTemporalType, C as isBlankCondition, D as toFilterArray, E as toApi3Hash, F as isDataType, H as supportsOperator, I as isFilterable, L as isLinkType, M as OPERATORS_BY_TYPE, N as TIME_UNITS, O as walk, P as VALUE_SHAPE, R as isNumericType, S as group, T as referencedPaths, V as operatorsFor, _ as undeclaredField, a as eventLogFilters, b as emptyFilter, c as normalizeHierarchyNode, d as displayNameOf, f as fieldSchemaOverride, g as statusFieldNameFor, h as statusFieldFor, i as batchResults, j as OPERATORS, k as DATA_TYPES, l as DISPLAY_NAME_FIELDS, m as normalizeFields, n as RestClient, o as hierarchyEntity, p as normalizeField, r as SgApiError, s as normalizeEventLogEntry, t as EVENT_LOG_FIELDS, u as FIELD_SCHEMA_OVERRIDES, w as isEmptyFilter, x as fromWire, y as condition, z as isOperator } from "./client-BdePDloQ.mjs";
+import { A as NEGATING_OPERATORS, B as isTemporalType, C as isBlankCondition, D as toFilterArray, E as toApi3Hash, F as isDataType, H as supportsOperator, I as isFilterable, L as isLinkType, M as OPERATORS_BY_TYPE, N as TIME_UNITS, O as walk, P as VALUE_SHAPE, R as isNumericType, S as group, T as referencedPaths, V as operatorsFor, _ as undeclaredField, a as eventLogFilters, b as emptyFilter, c as normalizeHierarchyNode, d as displayNameOf, f as fieldSchemaOverride, g as statusFieldNameFor, h as statusFieldFor, i as batchResults, j as OPERATORS, k as DATA_TYPES, l as DISPLAY_NAME_FIELDS, m as normalizeFields, n as RestClient, o as hierarchyEntity, p as normalizeField, r as SgApiError, s as normalizeEventLogEntry, t as EVENT_LOG_FIELDS, u as FIELD_SCHEMA_OVERRIDES, w as isEmptyFilter, x as fromWire, y as condition, z as isOperator } from "./client-izKszX7l.mjs";
 //#region src/field-icons.ts
 const ICONS = {
 	text: "type",
@@ -3689,6 +3689,7 @@ function createQueryCache(client, options = {}) {
 	}
 	function invalidateSearches(entityType) {
 		drop(`search:[${JSON.stringify(entityType)}`);
+		drop(`read:[${JSON.stringify(entityType)}`);
 		drop("textSearch");
 		drop(`summarize:[${JSON.stringify(entityType)}`);
 	}
@@ -3708,6 +3709,7 @@ function createQueryCache(client, options = {}) {
 	function invalidateAllRows() {
 		for (const prefix of [
 			"search",
+			"read",
 			"textSearch",
 			"summarize",
 			"threadContents",
@@ -3732,6 +3734,13 @@ function createQueryCache(client, options = {}) {
 		search(entityType, searchOptions) {
 			return run("search", [entityType, searchOptions], () => client.search(entityType, searchOptions));
 		},
+		read(entityType, id, readOptions) {
+			return run("read", [
+				entityType,
+				id,
+				readOptions ?? null
+			], () => client.read(entityType, id, readOptions));
+		},
 		textSearch(text, entityTypes, page) {
 			return run("textSearch", [
 				text,
@@ -4710,6 +4719,7 @@ const PROXY_METHODS = [
 	"fields",
 	"fieldWithProject",
 	"search",
+	"read",
 	"textSearch",
 	"statuses",
 	"create",
@@ -4828,6 +4838,7 @@ function call(client, method, p) {
 		case "fields": return client.fields(str(p.entityType, "entityType"), optionalNum(p.projectId, "projectId"));
 		case "fieldWithProject": return client.fieldWithProject(str(p.entityType, "entityType"), str(p.field, "field"), num(p.projectId, "projectId"));
 		case "search": return client.search(str(p.entityType, "entityType"), p.options ?? {});
+		case "read": return client.read(str(p.entityType, "entityType"), num(p.id, "id"), p.options ?? {});
 		case "textSearch": return client.textSearch(str(p.text, "text"), p.entityTypes ?? {}, p.page ?? void 0);
 		case "statuses": return client.statuses();
 		case "create": return client.create(str(p.entityType, "entityType"), obj(p.body, "body"));
@@ -4905,6 +4916,13 @@ var ProxyClient = class {
 			options
 		});
 	}
+	read(entityType, id, options = {}) {
+		return this.post("read", {
+			entityType,
+			id,
+			options
+		});
+	}
 	textSearch(text, entityTypes, page) {
 		return this.post("textSearch", {
 			text,
@@ -6475,7 +6493,7 @@ function asError$1(value) {
 }
 function createEntitySource(options) {
 	const { client, entityType } = options;
-	const fields = [.../* @__PURE__ */ new Set(["id", ...options.fields])];
+	let fields = [.../* @__PURE__ */ new Set(["id", ...options.fields])];
 	let state = {
 		rows: [],
 		status: "idle",
@@ -6561,7 +6579,9 @@ function createEntitySource(options) {
 	}
 	const source = {
 		entityType,
-		fields,
+		get fields() {
+			return fields;
+		},
 		get rows() {
 			return state.rows;
 		},
@@ -6614,6 +6634,15 @@ function createEntitySource(options) {
 			set({ total: null });
 			return run(() => read(pages, "loading", [], 1));
 		},
+		addFields(paths) {
+			const added = paths.filter((path) => path && !fields.includes(path));
+			if (added.length === 0) return Promise.resolve();
+			fields = [...fields, ...new Set(added)];
+			if (state.status === "idle") return Promise.resolve();
+			if (state.mode === "pages") return run(() => read(1, "loading", [], state.page));
+			const pages = Math.max(1, Math.ceil(state.rows.length / state.pageSize));
+			return run(() => read(pages, "loading", [], 1));
+		},
 		setFilters(filters) {
 			set({ filters: toWireGroup(filters) });
 			return source.load();
@@ -7012,6 +7041,175 @@ function sameCollapse(a, b) {
 	return a.all === b.all && sameIds(a.except, b.except);
 }
 //#endregion
+//#region src/selection.ts
+const refOf = (row) => ({
+	type: row.type,
+	id: row.id
+});
+/** Shift ranges; a plain press and Cmd or Ctrl both toggle. */
+function gestureOf(event) {
+	return event.shiftKey ? "range" : "toggle";
+}
+/** Space toggles, Shift+ArrowUp and Shift+ArrowDown extend, Cmd or Ctrl+A takes every loaded row. */
+function selectionKeyIntent(event) {
+	const command = event.metaKey || event.ctrlKey;
+	if (event.key === " " && !command && !event.altKey) return "toggle";
+	if (event.shiftKey && !command && !event.altKey) {
+		if (event.key === "ArrowDown") return "extend-down";
+		if (event.key === "ArrowUp") return "extend-up";
+	}
+	if (command && !event.shiftKey && !event.altKey && event.key.toLowerCase() === "a") return "all";
+	return null;
+}
+/** `selection` with every ref of `refs` added, or every one of them dropped. */
+function setRefs(selection, refs, on) {
+	const named = new Set(refs.map(rowKey));
+	if (!on) return selection.filter((entry) => !named.has(rowKey(entry)));
+	const held = new Set(selection.map(rowKey));
+	return [...selection, ...refs.filter((entry) => !held.has(rowKey(entry))).map((entry) => ({ ...entry }))];
+}
+/** Toggle the row at `index` and anchor on it. A disabled row refuses. */
+function toggleRow(selection, anchor, rows, index, isRowDisabled) {
+	const row = rows[index];
+	if (!row || rowIsDisabled(row, isRowDisabled)) return {
+		selection: [...selection],
+		anchor
+	};
+	const key = rowKey(row);
+	const on = !selection.some((entry) => rowKey(entry) === key);
+	const next = setRefs(selection, [refOf(row)], on);
+	return {
+		selection: next,
+		anchor: {
+			key,
+			on,
+			base: next,
+			last: next
+		}
+	};
+}
+/**
+* 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.
+*/
+function extendRange(selection, anchor, rows, index, isRowDisabled) {
+	const row = rows[index];
+	if (!row) return {
+		selection: [...selection],
+		anchor
+	};
+	const from = anchor ? rows.findIndex((entry) => rowKey(entry) === anchor.key) : -1;
+	if (!anchor || from < 0) {
+		if (rowIsDisabled(row, isRowDisabled)) return {
+			selection: [...selection],
+			anchor
+		};
+		const next = setRefs(selection, [refOf(row)], true);
+		return {
+			selection: next,
+			anchor: {
+				key: rowKey(row),
+				on: true,
+				base: next,
+				last: next
+			}
+		};
+	}
+	const base = sameRefs(selection, anchor.last) ? anchor.base : [...selection];
+	const [lo, hi] = from <= index ? [from, index] : [index, from];
+	const next = setRefs(base, rows.slice(lo, hi + 1).filter((entry) => !rowIsDisabled(entry, isRowDisabled)).map(refOf), anchor.on);
+	return {
+		selection: next,
+		anchor: {
+			...anchor,
+			base,
+			last: next
+		}
+	};
+}
+/**
+* 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.
+*/
+function extendByStep(selection, anchor, rows, from, to, isRowDisabled) {
+	const start = rows[from];
+	return extendRange(selection, anchor !== null && rows.some((entry) => rowKey(entry) === anchor.key) || !start ? anchor : {
+		key: rowKey(start),
+		on: true,
+		base: [...selection],
+		last: [...selection]
+	}, rows, to, isRowDisabled);
+}
+/**
+* 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.
+*/
+function matchingOffer(state) {
+	const { allLoaded, loaded, selected, hasMore, total } = state;
+	return {
+		show: allLoaded && (hasMore || total !== null && total > loaded) && !(total !== null && selected >= total),
+		total
+	};
+}
+//#endregion
+//#region src/column-choice.ts
+const PREFIX = "sg-widgets:columns:";
+/** Where a choice is kept: the caller's key, or one per entity type. */
+function columnsStorageKey(entityType, key) {
+	return key ? key : `${PREFIX}${entityType}`;
+}
+/** A stored choice as paths. Null for nothing, an empty list, or anything that is not a list of paths. */
+function parseColumnChoice(raw) {
+	if (!raw) return null;
+	let value;
+	try {
+		value = JSON.parse(raw);
+	} catch {
+		return null;
+	}
+	if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) return null;
+	const paths = [...new Set(value.map((entry) => entry.trim()).filter(Boolean))];
+	return paths.length > 0 ? paths : null;
+}
+/** The string a choice is kept as. */
+function serializeColumnChoice(paths) {
+	return JSON.stringify(paths);
+}
+/** The paths of a column list, in order. */
+function columnPaths(columns) {
+	return columns.map((column) => column.path);
+}
+/** True when two path lists name the same columns in the same order. */
+function sameColumnPaths(a, b) {
+	return a.length === b.length && a.every((path, at) => path === b[at]);
+}
+/** The paths a source with `fields` does not read yet. */
+function unreadPaths(fields, paths) {
+	const read = new Set(fields);
+	return paths.filter((path) => !read.has(path));
+}
+/** The known columns in the order `paths` names them. A path none of them carries is dropped. */
+function arrangeColumns(paths, known) {
+	const byPath = /* @__PURE__ */ new Map();
+	for (const column of known) if (!byPath.has(column.path)) byPath.set(column.path, column);
+	return paths.flatMap((path) => {
+		const column = byPath.get(path);
+		return column ? [column] : [];
+	});
+}
+/**
+* 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.
+*/
+async function resolveColumnChoice(schema, entityType, paths, known) {
+	const have = new Set(known.map((column) => column.path));
+	const missing = paths.filter((path) => !have.has(path));
+	const resolved = await Promise.all(missing.map((path) => resolveColumns(schema, entityType, [path]).then((columns) => columns, () => [])));
+	return arrangeColumns(paths, [...known, ...resolved.flat()]);
+}
+//#endregion
 //#region src/entity-card.ts
 const DEFAULT_IMAGE_PATH = "image";
 /**
@@ -7987,4 +8185,4 @@ function watchOverflow(list) {
 	};
 }
 //#endregion
-export { AppSessionError, COLOR_SENTINEL, DATA_TYPES, DEFAULT_FIELD_ICON, DISPLAY_NAME_FIELDS, ELLIPSIS_CHIPS, ERROR_LABEL, EVENT_LOG_FIELDS, FIELD_ICON_NAMES, FIELD_SCHEMA_OVERRIDES, FLOAT_PRECISION, HIERARCHY_LEAF_LIMIT, INT32_MAX, INT32_MIN, LOADING_LABEL, NAME_HUES, NATIVE_STATUSES, NEGATING_OPERATORS, NOTHING_CHOSEN_LABEL, NO_MATCH_LABEL, NO_ROWS_LABEL, OPERATORS, OPERATORS_BY_TYPE, OPERATOR_LABELS, OVERFLOW_END_VAR, OVERFLOW_START_VAR, PATH_SEPARATOR, PRESS_WINDOW_MS, PROJECT_PICKER_FIELDS, PROXY_METHODS, ProxyClient, RestClient, SCROLL_THRESHOLD, SEARCHING_LABEL, SEARCH_DEBOUNCE_MS, SEARCH_PAGE_SIZE, SORTABLE_HANDLE_ATTRIBUTE, SORTABLE_ID_ATTRIBUTE, STOCK_ICON_CELLS, STOCK_ICON_DATA_URLS, STOCK_ICON_KEYS, STOCK_SPRITE_PATH, SgApiError, THUMBNAIL_PENDING_PATH, TIME_UNITS, TIME_UNIT_LABELS, TREE_STATUS_FIELDS, UNRESOLVED_PATH_LABEL, USER_PICKER_FIELDS, VALUE_SHAPE, appendAt, applyPreset, asCollapseState, asFilterGroup, base64ToBytes, batchResults, breadcrumb, bytesToBase64, canLoadNext, cellValue, clearableForField, collapseAll, collapseStateFrom, collapsedKeys, collectionBottom, collectionView, colorToHex, condition, conditionArity, conditionList, conditionParts, conditionValues, contextFromClient, countActiveConditions, countConditions, countLine, createEntitySearch, createEntitySource, createProxyHandler, createQueryCache, createSchemaService, createSessionTokenAuth, createSgContext, createSortable, createSortableController, createStatusService, createTree, currentPlatform, currentType, defaultCondition, defaultValueFor, deriveFieldOptions, describeCondition, describeEntityCard, describePaging, displayNameOf, editorKindFor, editorNeedsContext, editorPlacementFor, emptyFilter, emptyValueFor, entityCardFields, entityCardSlot, entityDetailUrl, entityKey, entityTypeOptions, errorText, eventLogFilters, expandAll, facetCounts, facetLists, facetPresets, facetScopes, facetShape, facetValues, facetValuesFromGroups, fieldOperators, fieldPathOf, fieldSchemaOverride, fieldText, fileHref, fileNameFromUrl, filterEntityTypes, filterableFields, findCondition, findFacet, firstEnabledIndex, fitChips, flattenRow, focusChip, foregroundFor, formatCurrency, formatDate, formatDateTime, formatDuration, formatFloat, formatNumberInput, formatPercent, formatTimecode, friendlyFieldPath, fromApiDateTime, fromSortString, fromWire, group, groupKeyText, groupRows, groupRowsKeyed, hasFailedPage, hasMorePage, hierarchyEntity, hierarchyLoader, hierarchySearcher, hydrate, iconNameFor, idsForRefs, imageState, initialsOf, intersectStatuses, isBareRef, isBlankCondition, isCollapsed, isDataType, isEditableType, isEmptyFilter, isEmptyValue, isFilterable, isGroupingRefusal, isHiddenPath, isLinkType, isNativeStatus, isNumericType, isOperator, isParseError, isPinned, isProxyMethod, isSortable, isTemporalType, isValidListValue, isoDay, isoDayParts, listStatus, loadEntityCard, loadsOnArrowDown, markOverflow, matchRuns, matchesEveryWord, measureSortable, mergeFilters, moveAt, moveFieldPath, nameColorIndex, nameHue, nameSearchFilter, nativeStatus, nextEnabledIndex, nodeAt, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, normalizeSiteUrl, numberDigits, numberDraft, numberSteps, numberWire, operatorLabel, operatorMenu, operatorsFor, overflowEdges, parseBgColor, parseColorInput, parseDurationInput, parseFloatInput, parseInteger, parseNumberInput, parseTextInput, parseTimecodeInput, parseUrlInput, pathLabel, pathOf, pathRefs, pathTypes, pickerKeyIntent, placeholderName, playSortableFlip, pollAppSession, preferencesOf, prependRecent, presetById, presetIdOf, presetsFor, pressGate, projectOfPath, projectPickerFilters, pruneFilterToFields, queryPlan, reachedEnd, referencedPaths, refsForIds, relativeFrom, relativeLuminance, relativeOperator, relativeValue, relativeWindow, removeAt, renderKindFor, replaceAt, requestAppSession, requestGate, resolveColumns, resolveFieldPathOptions, resolveRowFields, resolveTreeFields, rgbToCss, rowCode, rowFields, rowIdOf, rowIsDisabled, rowKey, rowSecondary, rowSubLabel, rowThumbnail, sameCollapse, sameFilters, sameIds, sameRefs, sameSort, scopeToProject, scrollHighlightedIntoView, searchFieldOptions, searchFieldPathOptions, searchKeyIntent, searchTypeMap, searchView, searchWords, secondaryType, selectableRefs, selectionState, serializeSort, setFacet, setFacetPreset, settleStep, shouldLoadNext, sortableAnnouncements, sortableDropIndex, sortableFields, sortableScrollStep, sortableStride, sourceModeFor, spriteStyle, stateLine, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, stepNumber, stockIconSource, storedNumber, subLabelType, summariseSelection, supportsEmpty, supportsOperator, thumbnailField, timeUnitField, timeUnitLabel, timeZoneName, toApi3Hash, toApiDate, toApiDateTime, toApiFloat, toColumn, toFilterArray, toRef, toSearchHit, toSortKeys, toSortSpecs, toSortString, toWireGroup, toggleCollapsed, toggleFieldPath, toggleId, toggleRef, traversalTargets, undeclaredField, unformatNumberInput, urlLink, usableStatuses, userPickerFilters, userPickerSearchFields, userPickerSubLabel, userPickerTypes, userSearchFields, validateCondition, valueArity, valueEditorFor, walk, watchHighlight, watchOverflow, withAddedListValue, withListValue, withRelativeWindow, withSelectedPinned, withoutListValue, withoutPaths };
+export { AppSessionError, COLOR_SENTINEL, DATA_TYPES, DEFAULT_FIELD_ICON, DISPLAY_NAME_FIELDS, ELLIPSIS_CHIPS, ERROR_LABEL, EVENT_LOG_FIELDS, FIELD_ICON_NAMES, FIELD_SCHEMA_OVERRIDES, FLOAT_PRECISION, HIERARCHY_LEAF_LIMIT, INT32_MAX, INT32_MIN, LOADING_LABEL, NAME_HUES, NATIVE_STATUSES, NEGATING_OPERATORS, NOTHING_CHOSEN_LABEL, NO_MATCH_LABEL, NO_ROWS_LABEL, OPERATORS, OPERATORS_BY_TYPE, OPERATOR_LABELS, OVERFLOW_END_VAR, OVERFLOW_START_VAR, PATH_SEPARATOR, PRESS_WINDOW_MS, PROJECT_PICKER_FIELDS, PROXY_METHODS, ProxyClient, RestClient, SCROLL_THRESHOLD, SEARCHING_LABEL, SEARCH_DEBOUNCE_MS, SEARCH_PAGE_SIZE, SORTABLE_HANDLE_ATTRIBUTE, SORTABLE_ID_ATTRIBUTE, STOCK_ICON_CELLS, STOCK_ICON_DATA_URLS, STOCK_ICON_KEYS, STOCK_SPRITE_PATH, SgApiError, THUMBNAIL_PENDING_PATH, TIME_UNITS, TIME_UNIT_LABELS, TREE_STATUS_FIELDS, UNRESOLVED_PATH_LABEL, USER_PICKER_FIELDS, VALUE_SHAPE, appendAt, applyPreset, arrangeColumns, asCollapseState, asFilterGroup, base64ToBytes, batchResults, breadcrumb, bytesToBase64, canLoadNext, cellValue, clearableForField, collapseAll, collapseStateFrom, collapsedKeys, collectionBottom, collectionView, colorToHex, columnPaths, columnsStorageKey, condition, conditionArity, conditionList, conditionParts, conditionValues, contextFromClient, countActiveConditions, countConditions, countLine, createEntitySearch, createEntitySource, createProxyHandler, createQueryCache, createSchemaService, createSessionTokenAuth, createSgContext, createSortable, createSortableController, createStatusService, createTree, currentPlatform, currentType, defaultCondition, defaultValueFor, deriveFieldOptions, describeCondition, describeEntityCard, describePaging, displayNameOf, editorKindFor, editorNeedsContext, editorPlacementFor, emptyFilter, emptyValueFor, entityCardFields, entityCardSlot, entityDetailUrl, entityKey, entityTypeOptions, errorText, eventLogFilters, expandAll, extendByStep, extendRange, facetCounts, facetLists, facetPresets, facetScopes, facetShape, facetValues, facetValuesFromGroups, fieldOperators, fieldPathOf, fieldSchemaOverride, fieldText, fileHref, fileNameFromUrl, filterEntityTypes, filterableFields, findCondition, findFacet, firstEnabledIndex, fitChips, flattenRow, focusChip, foregroundFor, formatCurrency, formatDate, formatDateTime, formatDuration, formatFloat, formatNumberInput, formatPercent, formatTimecode, friendlyFieldPath, fromApiDateTime, fromSortString, fromWire, gestureOf, group, groupKeyText, groupRows, groupRowsKeyed, hasFailedPage, hasMorePage, hierarchyEntity, hierarchyLoader, hierarchySearcher, hydrate, iconNameFor, idsForRefs, imageState, initialsOf, intersectStatuses, isBareRef, isBlankCondition, isCollapsed, isDataType, isEditableType, isEmptyFilter, isEmptyValue, isFilterable, isGroupingRefusal, isHiddenPath, isLinkType, isNativeStatus, isNumericType, isOperator, isParseError, isPinned, isProxyMethod, isSortable, isTemporalType, isValidListValue, isoDay, isoDayParts, listStatus, loadEntityCard, loadsOnArrowDown, markOverflow, matchRuns, matchesEveryWord, matchingOffer, measureSortable, mergeFilters, moveAt, moveFieldPath, nameColorIndex, nameHue, nameSearchFilter, nativeStatus, nextEnabledIndex, nodeAt, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, normalizeSiteUrl, numberDigits, numberDraft, numberSteps, numberWire, operatorLabel, operatorMenu, operatorsFor, overflowEdges, parseBgColor, parseColorInput, parseColumnChoice, parseDurationInput, parseFloatInput, parseInteger, parseNumberInput, parseTextInput, parseTimecodeInput, parseUrlInput, pathLabel, pathOf, pathRefs, pathTypes, pickerKeyIntent, placeholderName, playSortableFlip, pollAppSession, preferencesOf, prependRecent, presetById, presetIdOf, presetsFor, pressGate, projectOfPath, projectPickerFilters, pruneFilterToFields, queryPlan, reachedEnd, referencedPaths, refsForIds, relativeFrom, relativeLuminance, relativeOperator, relativeValue, relativeWindow, removeAt, renderKindFor, replaceAt, requestAppSession, requestGate, resolveColumnChoice, resolveColumns, resolveFieldPathOptions, resolveRowFields, resolveTreeFields, rgbToCss, rowCode, rowFields, rowIdOf, rowIsDisabled, rowKey, rowSecondary, rowSubLabel, rowThumbnail, sameCollapse, sameColumnPaths, sameFilters, sameIds, sameRefs, sameSort, scopeToProject, scrollHighlightedIntoView, searchFieldOptions, searchFieldPathOptions, searchKeyIntent, searchTypeMap, searchView, searchWords, secondaryType, selectableRefs, selectionKeyIntent, selectionState, serializeColumnChoice, serializeSort, setFacet, setFacetPreset, setRefs, settleStep, shouldLoadNext, sortableAnnouncements, sortableDropIndex, sortableFields, sortableScrollStep, sortableStride, sourceModeFor, spriteStyle, stateLine, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, stepNumber, stockIconSource, storedNumber, subLabelType, summariseSelection, supportsEmpty, supportsOperator, thumbnailField, timeUnitField, timeUnitLabel, timeZoneName, toApi3Hash, toApiDate, toApiDateTime, toApiFloat, toColumn, toFilterArray, toRef, toSearchHit, toSortKeys, toSortSpecs, toSortString, toWireGroup, toggleCollapsed, toggleFieldPath, toggleId, toggleRef, toggleRow, traversalTargets, undeclaredField, unformatNumberInput, unreadPaths, urlLink, usableStatuses, userPickerFilters, userPickerSearchFields, userPickerSubLabel, userPickerTypes, userSearchFields, validateCondition, valueArity, valueEditorFor, walk, watchHighlight, watchOverflow, withAddedListValue, withListValue, withRelativeWindow, withSelectedPinned, withoutListValue, withoutPaths };

package/dist/mock.d.mts

@@ -1,4 +1,4 @@
-import { A as UploadFile, At as TextSearchFilter, D as TextSearchRow, H as StatusRecord, S as SummarizeResult, _ as SearchOptions, a as EntityTypeInfo, b as SgClient, c as EventLogResult, d as HierarchyPath, ft as FieldSchema, i as EntityRow, j as UploadResult, k as ThreadRow, l as FollowingOptions, n as BatchResult, s as EventLogOptions, t as BatchRequest, u as HierarchyNode, v as SearchResult, wt as EntityRef, x as SummarizeOptions } from "./client-B2PCySg9.mjs";
+import { A as ThreadRow, C as SummarizeResult, M as UploadResult, O as TextSearchRow, S as SummarizeOptions, Tt as EntityRef, U as StatusRecord, a as EntityTypeInfo, c as EventLogResult, d as HierarchyPath, h as ReadOptions, i as EntityRow, j as UploadFile, jt as TextSearchFilter, l as FollowingOptions, n as BatchResult, pt as FieldSchema, s as EventLogOptions, t as BatchRequest, u as HierarchyNode, v as SearchOptions, x as SgClient, y as SearchResult } from "./client-CP9sWEVZ.mjs";
 //#region src/mock.d.ts
 /** What the next call should throw instead of answering. */
 export interface MockFailure {
@@ -38,6 +38,10 @@ export declare class MockClient implements SgClient {
   private readonly retired;
   /** Rows a batch created with no `project`: no read reaches them, a delete does (report 001). */
   private readonly unreadable;
+  /** What a Task delete did to other rows, by `Task:id`, for its revive to undo (089_task_delete_side_effects). */
+  private readonly cascades;
+  /** The highest id handed out per type, so an erased row's id is never reused. */
+  private readonly issued;
   private deletes;
   constructor(options?: MockClientOptions);
   /**
@@ -53,6 +57,7 @@ export declare class MockClient 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;
@@ -118,13 +123,50 @@ export declare class MockClient implements SgClient {
   private createRow;
   /**
    * Retire one row: reads skip it and a second delete is 404 (delete_entity_type_id).
-   * The mock retires only the row; what a delete does to rows that link to it
-   * (probe 060, 089_task_delete_side_effects) is not modelled.
+   * A Task takes its TaskDependency rows with it and leaves `Version.sg_task` and
+   * `PublishedFile.task` null until its revive (089_task_delete_side_effects), alone or
+   * in a batch (103_batch_delete_revive). A TaskTemplate retires its tasks
+   * (entity_types/TaskTemplate). What a Shot delete does to its Versions (probe 060)
+   * is not modelled.
    */
   delete(entityType: string, id: number): Promise<void>;
   private deleteRow;
-  /** Bring a retired row back with its values; `false` for a row that is already live (post_entity_type_id). */
+  /**
+   * Bring a retired row back with its values; `false` for a row that is already live
+   * (post_entity_type_id). A Task gets back what its delete took (089_task_delete_side_effects).
+   * A TaskDependency whose pair is linked again refuses, the pair being a unique index
+   * (095_dependency_remove_undo). A TaskTemplate's tasks stay retired: unmeasured.
+   */
   revive(entityType: string, id: number): Promise<boolean>;
+  private retire;
+  private unretire;
+  /** Remove a row for good: no read reaches it and no revive brings it back. */
+  private erase;
+  private live;
+  /** The live TaskDependency rows with this Task at either end. */
+  private edgesOf;
+  /** Whether a live row already links this row's pair. */
+  private pairTaken;
+  /** Whether `from` depends on `target`, directly or through other Tasks. */
+  private dependsOn;
+  /**
+   * The checks a TaskDependency create makes: one of four types, one row per pair, and
+   * no loop of any length (085_task_dependency_types, 107_dependency_three_task_loop).
+   */
+  private checkEdge;
+  /**
+   * A write to `upstream_tasks` or `downstream_tasks`: a new neighbour gets a row of the
+   * default type and no offset, a dropped one's row is erased, not retired
+   * (086_batch_tasks_with_dependencies, 095_dependency_remove_undo).
+   */
+  private writeEdges;
+  /** Where the written field is one side of a two-sided link, make the other side agree. */
+  private mirror;
+  /**
+   * What the server derives from other rows: a Task's two edge lists from the
+   * TaskDependency rows, their ids and name, and a template's task count, a string.
+   */
+  private derive;
   /**
    * Apply the requests in order, and undo all of them when one fails (recipes/002).
    * A create or update row carries the record under `data`; a delete row is flat.
@@ -147,6 +189,13 @@ export declare class MockClient implements SgClient {
    * missing key (field_types/entity).
    */
   private checkLink;
+  /**
+   * Values the server checks beyond their shape. A status code must be in the site-wide
+   * `valid_values`, hidden ones included, and a create or any batch request wraps the
+   * refusal (field_types/status_list, recipes/002, 094_permission_preflight). A
+   * TaskTemplate's `entity_type` must name a type (entity_types/TaskTemplate).
+   */
+  private checkValue;
   /** The next free id of a type, which is what a create takes. */
   private nextId;
   /** The reverse view of a link the server fills in: a Reply lands in `Note.replies`. */