sg-widgets-core 0.1.0 → 0.3.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { A as OPERATORS, B as operatorsFor, C as isEmptyFilter, D as walk, E as toFilterArray, F as isFilterable, I as isLinkType, L as isNumericType, M as TIME_UNITS, N as VALUE_SHAPE, O as DATA_TYPES, P as isDataType, R as isOperator, S as isBlankCondition, T as toApi3Hash, V as supportsOperator, a as hierarchyEntity, b as fromWire, c as DISPLAY_NAME_FIELDS, d as fieldSchemaOverride, f as normalizeField, g as undeclaredField, h as statusFieldNameFor, i as eventLogFilters, j as OPERATORS_BY_TYPE, k as NEGATING_OPERATORS, l as FIELD_SCHEMA_OVERRIDES, m as statusFieldFor, n as RestClient, o as normalizeEventLogEntry, p as normalizeFields, r as SgApiError, s as normalizeHierarchyNode, t as EVENT_LOG_FIELDS, u as displayNameOf, v as condition, w as referencedPaths, x as group, y as emptyFilter, z as isTemporalType } from "./client-DwN_-UuF.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)}`);
 	}
@@ -3700,6 +3701,22 @@ function createQueryCache(client, options = {}) {
 	function invalidateThreads() {
 		drop("threadContents");
 	}
+	/**
+	* A delete retires and unlinks rows of other types, a Shot's Versions (probe 060)
+	* and a Task's dependencies, `Version.sg_task` and `PublishedFile.task`, and a
+	* revive puts them back (089_task_delete_side_effects). Every row read goes.
+	*/
+	function invalidateAllRows() {
+		for (const prefix of [
+			"search",
+			"read",
+			"textSearch",
+			"summarize",
+			"threadContents",
+			"hierarchyExpand",
+			"hierarchySearch"
+		]) drop(prefix);
+	}
 	return {
 		entityTypes() {
 			return run("entityTypes", [], () => client.entityTypes());
@@ -3717,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,
@@ -3768,6 +3792,22 @@ function createQueryCache(client, options = {}) {
 			invalidateThreads();
 			return row;
 		},
+		async delete(entityType, id) {
+			await client.delete(entityType, id);
+			invalidateAllRows();
+		},
+		async revive(entityType, id) {
+			const revived = await client.revive(entityType, id);
+			invalidateAllRows();
+			return revived;
+		},
+		async batch(requests) {
+			const results = await client.batch(requests);
+			if (requests.some((r) => r.request_type === "delete")) invalidateAllRows();
+			else for (const type of new Set(requests.map((r) => r.entity))) invalidateSearches(type);
+			invalidateThreads();
+			return results;
+		},
 		invalidate(prefix) {
 			if (prefix === void 0) {
 				entries.clear();
@@ -4679,6 +4719,7 @@ const PROXY_METHODS = [
 	"fields",
 	"fieldWithProject",
 	"search",
+	"read",
 	"textSearch",
 	"statuses",
 	"create",
@@ -4689,7 +4730,10 @@ const PROXY_METHODS = [
 	"summarize",
 	"threadContents",
 	"eventLog",
-	"following"
+	"following",
+	"delete",
+	"revive",
+	"batch"
 ];
 function isProxyMethod(value) {
 	return PROXY_METHODS.includes(value);
@@ -4739,6 +4783,12 @@ function entityRef(value, name) {
 		id: num(ref.id, `${name}.id`)
 	};
 }
+/** The list is passed on as sent; the API names what is wrong with a request (recipes/002). */
+function requestList(value, name) {
+	if (!Array.isArray(value)) throw new BadRequest(`'${name}' must be a list`);
+	for (const [i, request] of value.entries()) obj(request, `${name}[${i}]`);
+	return value;
+}
 function str(value, name) {
 	if (typeof value !== "string" || value.length === 0) throw new BadRequest(`'${name}' must be a non-empty string`);
 	return value;
@@ -4788,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"));
@@ -4799,6 +4850,9 @@ function call(client, method, p) {
 		case "threadContents": return client.threadContents(num(p.noteId, "noteId"), p.entityFields ?? void 0);
 		case "eventLog": return client.eventLog(p.options ?? {});
 		case "following": return client.following(num(p.userId, "userId"), p.options ?? {});
+		case "delete": return client.delete(str(p.entityType, "entityType"), num(p.id, "id")).then(() => null);
+		case "revive": return client.revive(str(p.entityType, "entityType"), num(p.id, "id"));
+		case "batch": return client.batch(requestList(p.requests, "requests"));
 	}
 }
 //#endregion
@@ -4862,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,
@@ -4878,6 +4939,21 @@ var ProxyClient = class {
 			body
 		});
 	}
+	async delete(entityType, id) {
+		await this.post("delete", {
+			entityType,
+			id
+		});
+	}
+	revive(entityType, id) {
+		return this.post("revive", {
+			entityType,
+			id
+		});
+	}
+	batch(requests) {
+		return this.post("batch", { requests });
+	}
 	/** The bytes cross the protocol base64-encoded; the handler runs the three calls. */
 	upload(entityType, id, file) {
 		return this.post("upload", {
@@ -6417,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",
@@ -6503,7 +6579,9 @@ function createEntitySource(options) {
 	}
 	const source = {
 		entityType,
-		fields,
+		get fields() {
+			return fields;
+		},
 		get rows() {
 			return state.rows;
 		},
@@ -6556,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();
@@ -6954,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";
 /**
@@ -7929,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, 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 { D as UploadFile, E as ThreadRow, Et as TextSearchFilter, O as UploadResult, R as StatusRecord, _ as SgClient, a as EventLogOptions, bt as EntityRef, c as HierarchyNode, ct as FieldSchema, h as SearchResult, l as HierarchyPath, m as SearchOptions, n as EntityRow, o as EventLogResult, r as EntityTypeInfo, s as FollowingOptions, v as SummarizeOptions, w as TextSearchRow, y as SummarizeResult } from "./client-BhHppzTV.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 {
@@ -34,6 +34,15 @@ export declare class MockClient implements SgClient {
   private readonly latencyMs;
   private readonly clock;
   private pendingFailure;
+  /** Rows a delete retired, by `Type:id`. Reads skip them and a revive puts them back. */
+  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);
   /**
    * Make the next call reject with an `SgApiError`, for demoing an error state.
@@ -48,11 +57,13 @@ 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;
   }): Promise<TextSearchRow[]>;
   update(entityType: string, id: number, patch: Record<string, unknown>): Promise<EntityRow>;
+  private updateRow;
   /**
    * Counts without paging rows.
    *
@@ -104,6 +115,66 @@ export declare class MockClient implements SgClient {
    * entity_types/Note). Nothing is unique, so two identical creates make two rows.
    */
   create(entityType: string, body: Record<string, unknown>): Promise<EntityRow>;
+  /**
+   * A create, alone or inside a batch. The batch skips the `project` check and stores
+   * the row where no read reaches it (report 001), and it spells an unknown field its
+   * own way (recipes/002).
+   */
+  private createRow;
+  /**
+   * Retire one row: reads skip it and a second delete is 404 (delete_entity_type_id).
+   * 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). 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.
+   */
+  batch(requests: BatchRequest[]): Promise<BatchResult[]>;
+  private batchOne;
+  /** Everything a batch can change, and a function that puts it back. */
+  private snapshot;
   /**
    * Put a file on a row, as the three-call handshake leaves the site.
    *
@@ -118,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`. */