sg-widgets-core 0.3.1 → 0.4.0

package/dist/index.d.mts

@@ -1,4 +1,28 @@
-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";
+import { $ as SummaryField, $t as STOCK_SPRITE_PATH, A as BatchRequest, An as isFilterable, At as toApi3Hash, B as HierarchyPath, Bt as intersectStatuses, C as SchemaProxyMethod, Cn as OPERATORS_BY_TYPE, Ct as condition, D as toSchemaProperties, Dn as VALUE_SHAPE, Dt as isBlankCondition, E as isSchemaProxyMethod, En as TimeUnit, Et as group, F as EventLogEntry, Fn as operatorsFor, Ft as StatusIcon, G as RestClient, Gt as statusLabel, H as RawBatchRow, Ht as relativeLuminance, I as EventLogOptions, In as supportsOperator, It as StatusOption, J as SearchResult, Jt as NATIVE_STATUSES, K as RestClientOptions, Kt as statusPaint, L as EventLogResult, Lt as StatusPaint, M as EVENT_LOG_FIELDS, Mn as isNumericType, Mt as walk, N as EntityRow, Nn as isOperator, Nt as Rgb, O as ProxyClient, On as ValueShape, Ot as isEmptyFilter, P as EntityTypeInfo, Pn as isTemporalType, Pt as StatusGlyph, Q as SummarizeResult, Qt as STOCK_ICON_KEYS, R as FollowingOptions, Rt as StatusRecord, S as SchemaProperty, Sn as OPERATORS, St as WireGroup, T as fieldFromRaw, Tn as TIME_UNITS, Tt as fromWire, U as RawHierarchyNode, Ut as rgbToCss, V as HierarchyRef, Vt as parseBgColor, W as ReadOptions, Wt as statusGlyph, X as SgClient, Xt as STOCK_ICON_CELLS, Y as SgApiError, Yt as NativeStatus, Z as SummarizeOptions, Zt as STOCK_ICON_DATA_URLS, _ as ReviveFieldResult, _n as statusFieldNameFor, _t as FilterNode, a as ProxyHandlerOptions, an as stockIconSource, at as ThreadRow, b as SchemaClient, bn as DataType, bt as TextSearchFilter, c as base64ToBytes, cn as FieldSchema, ct as batchResults, d as isProxyMethod, dn as RawProperty, dt as normalizeEventLogEntry, en as SpriteCell, et as SummaryGroup, f as CreateFieldInput, fn as displayNameOf, ft as normalizeHierarchyNode, g as RestSchemaClient, gn as statusFieldFor, gt as FilterGroup, h as ProxySchemaClient, hn as normalizeFields, ht as FilterCondition, i as ProxyHandler, in as spriteStyle, it as ThreadAuthor, j as BatchResult, jn as isLinkType, jt as toFilterArray, k as ProxyClientOptions, kn as isDataType, kt as referencedPaths, l as bytesToBase64, ln as RawFieldSchema, lt as eventLogFilters, m as FieldReadResult, mn as normalizeField, mt as EntityRef, n as ProxyBody, nn as isNativeStatus, nt as SummaryType, o as ProxyMethod, on as DISPLAY_NAME_FIELDS, ot as UploadFile, p as CreatedField, pn as fieldSchemaOverride, pt as ConditionValue, q as SearchOptions, qt as usableStatuses, r as ProxyError, rn as nativeStatus, rt as TextSearchRow, s as ProxyResult, sn as FIELD_SCHEMA_OVERRIDES, st as UploadResult, t as PROXY_METHODS, tn as StockIconSource, tt as SummaryGrouping, u as createProxyHandler, un as RawFieldsResponse, ut as hierarchyEntity, v as SCHEMA_PROXY_METHODS, vn as undeclaredField, vt as LogicalOperator, w as createSchemaProxyHandler, wn as Operator, wt as emptyFilter, x as SchemaProperties, xn as NEGATING_OPERATORS, xt as WireCondition, y as SchemaApiError, yn as DATA_TYPES, yt as Scalar, z as HierarchyNode, zt as foregroundFor } from "./proxy-handler-C6XB6gss.mjs";
+//#region src/field-name.d.ts
+/** The prefix the server puts in front of every custom field it creates. */
+export declare const CUSTOM_FIELD_PREFIX = "sg_";
+/**
+ * Whether a display name holds a character outside ASCII. The server discards such a name
+ * whole when it derives the programmatic name (findings/117_field_types_and_names).
+ */
+export declare function hasNonAscii(displayName: string): boolean;
+/**
+ * The programmatic name the server derives from a display name, or null when it cannot be
+ * predicted: a blank display name, or a non-ASCII one without its data type.
+ *
+ * An ASCII display name gives the prefix, then the name lowercased with each character
+ * outside `[a-z0-9_]` replaced by one underscore. Nothing is trimmed, collapsed or cut, a
+ * leading digit stays, and a prefix already there is doubled (findings/019_create_fields,
+ * findings/117_field_types_and_names).
+ *
+ * One non-ASCII character anywhere and the server ignores the display name: the field is
+ * `sg_<data_type>`. That is measured on a `currency` field and inferred for the other types.
+ * A name already taken comes back suffixed `_1`, `_2`, and a name a retired field holds is
+ * refused; neither is predicted here.
+ */
+export declare function predictFieldName(displayName: string, dataType?: string): string | null;
+//#endregion
 //#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";
@@ -7,6 +31,19 @@ export declare function iconNameFor(dataType: string): string;
 /** Every icon name this module can return, for a UI package's name-to-component map. */
 export declare const FIELD_ICON_NAMES: readonly string[];
 //#endregion
+//#region src/data-type-labels.d.ts
+export declare const DATA_TYPE_LABELS: Readonly<Record<DataType, string>>;
+/** The label of a data type: the caller's, else this build's, else the name as given. */
+export declare function dataTypeLabel(dataType: string, labels?: Readonly<Record<string, string>>): string;
+export interface DataTypeOptionsConfig {
+  /** The held type. Outside the set, it is kept as a last option, since a row may hold it. */
+  value?: string | null;
+  /** Labels of the caller's own, which win over this build's. */
+  labels?: Readonly<Record<string, string>>;
+}
+/** The options a picker offers for a set of data types, in the order given, each once. */
+export declare function dataTypeOptions(types: readonly string[], config?: DataTypeOptionsConfig): StatusOption[];
+//#endregion
 //#region src/filter-ux.d.ts
 /** One label per raw operator, for a type that has no wording of its own. */
 export declare const OPERATOR_LABELS: Readonly<Record<Operator, string>>;
@@ -1753,75 +1790,40 @@ export declare function scrollHighlightedIntoView(list: Element | null | undefin
  */
 export declare function watchHighlight(list: Element | null | undefined): () => void;
 //#endregion
-//#region src/proxy-client.d.ts
-export interface ProxyClientOptions {
-  /** Where the endpoints live, e.g. `/sg` or `https://app.example.com/api/sg`. */
-  basePath: string;
-  fetch?: typeof fetch;
-  /** Extra request headers. Called per request, so a caller can rotate a CSRF or auth header. */
-  headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
-}
-export declare class ProxyClient implements SgClient {
-  private readonly options;
-  private readonly base;
-  private readonly fetchFn;
-  constructor(options: ProxyClientOptions);
-  private post;
-  entityTypes(): Promise<EntityTypeInfo[]>;
-  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>;
-  hierarchySearch(rootPath: string, entity: EntityRef): Promise<HierarchyPath[]>;
-  hierarchyExpand(path: string): Promise<HierarchyNode>;
-  summarize(entityType: string, options?: SummarizeOptions): Promise<SummarizeResult>;
-  threadContents(noteId: number, entityFields?: Record<string, string[]>): Promise<ThreadRow[]>;
-  eventLog(options?: EventLogOptions): Promise<EventLogResult>;
-  following(userId: number, options?: FollowingOptions): Promise<EntityRef[]>;
-}
-//#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', '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 {
-  status: number;
-  message: string;
-  body: unknown;
-}
-export type ProxyBody = {
-  data: unknown;
-} | {
-  error: ProxyError;
-};
-export interface ProxyResult {
-  /** HTTP status the wrapper writes. */
-  status: number;
-  body: ProxyBody;
+//#region src/valid-values.d.ts
+export interface ListValueOptions {
+  /** Keep the first of a repeated value and drop the rest. Off: a repeat is kept. */
+  unique?: boolean;
+}
+/** The values trimmed, the blank ones dropped, in the order given. */
+export declare function normalizeListValues(values: readonly string[], options?: ListValueOptions): string[];
+/** One value per line of a typed or pasted text. */
+export declare function splitListValues(text: string, options?: ListValueOptions): string[];
+/**
+ * The list with the value at `index` rewritten as `text`. A blank text removes it, a
+ * text of several lines puts each line in its place, and the index past the end appends.
+ */
+export declare function replaceListValue(values: readonly string[], index: number, text: string, options?: ListValueOptions): string[];
+/** The list with every line of `text` appended. */
+export declare function addListValues(values: readonly string[], text: string, options?: ListValueOptions): string[];
+/** The list with the value at `from` moved to `to`. A place outside the list leaves it alone. */
+export declare function moveListValue(values: readonly string[], from: number, to: number): string[];
+/** One row of the editor: a value, and a key that outlives an edit and a move. */
+export interface ListRow {
+  key: string;
+  value: string;
 }
-export type ProxyHandler = (method: string, body: unknown) => Promise<ProxyResult>;
-export declare function isProxyMethod(value: string): value is ProxyMethod;
 /**
- * Bytes as base64. The protocol is one JSON object per call, so an upload's bytes
- * cross it encoded and are decoded here.
+ * The rows for `values`, keeping the keys of `rows` wherever a row is still there.
+ *
+ * Values may repeat, so a value cannot be its row's key. A row is matched where it
+ * stands, then by its value wherever it went, then by its place when its value was
+ * edited; what is left is new and takes a key no row holds. Unchanged values answer
+ * the rows as given.
  */
-export declare function bytesToBase64(bytes: Uint8Array): string;
-export declare function base64ToBytes(value: string): Uint8Array;
-/** Wraps a client so a host app can expose it over its own HTTP endpoints. */
-export declare function createProxyHandler(client: SgClient): ProxyHandler;
+export declare function syncListRows(rows: readonly ListRow[], values: readonly string[]): ListRow[];
+/** Every status of the site as an option: its code, and its name as the label. */
+export declare function statusTableOptions(records: readonly StatusRecord[]): StatusOption[];
 //#endregion
 //#region src/session-auth.d.ts
 export interface SessionTokenAuthOptions {
@@ -2128,6 +2130,21 @@ export declare function resolveFieldPathOptions(schema: Pick<SchemaService, 'res
 /** Rows matching the search box, read on what the row shows and on the path behind it. */
 export declare function searchFieldPathOptions(options: readonly FieldPathOption[], query: string): FieldPathOption[];
 //#endregion
+//#region src/project-eligibility.d.ts
+/** The Project checkboxes eligibility reads; request them with the projects. */
+export declare const PROJECT_ELIGIBILITY_FIELDS: readonly ['is_template', 'archived', 'is_demo'];
+/** A project row holding the eligibility checkboxes by programmatic name. */
+export type EligibilityFlags = { readonly [K in (typeof PROJECT_ELIGIBILITY_FIELDS)[number]]?: unknown; };
+/**
+ * Whether a project is eligible for field visibility: not a template, not archived, not
+ * a demo project. Status is never read: `sg_status` is null on most working projects
+ * (findings/018_project_listing). Only a flag that is `true` excludes; the probed site
+ * never returned a null checkbox.
+ */
+export declare function isEligibleProject<T extends EligibilityFlags>(project: T): boolean;
+/** The eligible projects, in their order. */
+export declare function eligibleProjects<T extends EligibilityFlags>(projects: readonly T[]): T[];
+//#endregion
 //#region src/sortable.d.ts
 /**
  * Ordered lists that reorder by pointer and by keyboard.
@@ -2825,4 +2842,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, 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 };
+export { BatchRequest, BatchResult, ConditionValue, CreateFieldInput, CreatedField, DATA_TYPES, DISPLAY_NAME_FIELDS, DataType, EVENT_LOG_FIELDS, EntityRef, EntityRow, EntityTypeInfo, EventLogEntry, EventLogOptions, EventLogResult, FIELD_SCHEMA_OVERRIDES, FieldReadResult, FieldSchema, FilterCondition, FilterGroup, FilterNode, FollowingOptions, HierarchyNode, HierarchyPath, HierarchyRef, LogicalOperator, NATIVE_STATUSES, NEGATING_OPERATORS, NativeStatus, OPERATORS, OPERATORS_BY_TYPE, Operator, PROXY_METHODS, ProxyBody, ProxyClient, ProxyClientOptions, ProxyError, ProxyHandler, ProxyHandlerOptions, ProxyMethod, ProxyResult, ProxySchemaClient, RawBatchRow, RawFieldSchema, RawFieldsResponse, RawHierarchyNode, RawProperty, ReadOptions, RestClient, RestClientOptions, RestSchemaClient, ReviveFieldResult, Rgb, SCHEMA_PROXY_METHODS, STOCK_ICON_CELLS, STOCK_ICON_DATA_URLS, STOCK_ICON_KEYS, STOCK_SPRITE_PATH, Scalar, SchemaApiError, SchemaClient, SchemaProperties, SchemaProperty, SchemaProxyMethod, 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, base64ToBytes, batchResults, bytesToBase64, condition, createProxyHandler, createSchemaProxyHandler, displayNameOf, emptyFilter, eventLogFilters, fieldFromRaw, fieldSchemaOverride, foregroundFor, fromWire, group, hierarchyEntity, intersectStatuses, isBlankCondition, isDataType, isEmptyFilter, isFilterable, isLinkType, isNativeStatus, isNumericType, isOperator, isProxyMethod, isSchemaProxyMethod, isTemporalType, nativeStatus, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, operatorsFor, parseBgColor, referencedPaths, relativeLuminance, rgbToCss, spriteStyle, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, stockIconSource, supportsOperator, toApi3Hash, toFilterArray, toSchemaProperties, 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-izKszX7l.mjs";
+import { $ as supportsOperator, A as group, B as DATA_TYPES, C as statusFieldFor, D as condition, F as toFilterArray, G as VALUE_SHAPE, H as OPERATORS, I as walk, J as isLinkType, K as isDataType, L as CUSTOM_FIELD_PREFIX, M as isEmptyFilter, N as referencedPaths, O as emptyFilter, P as toApi3Hash, Q as operatorsFor, R as hasNonAscii, S as normalizeFields, T as undeclaredField, U as OPERATORS_BY_TYPE, V as NEGATING_OPERATORS, W as TIME_UNITS, X as isOperator, Y as isNumericType, Z as isTemporalType, _ as DISPLAY_NAME_FIELDS, a as createSchemaProxyHandler, b as fieldSchemaOverride, c as toSchemaProperties, d as SgApiError, f as batchResults, g as normalizeHierarchyNode, h as normalizeEventLogEntry, i as SchemaApiError, j as isBlankCondition, k as fromWire, l as EVENT_LOG_FIELDS, m as hierarchyEntity, n as RestSchemaClient, o as fieldFromRaw, p as eventLogFilters, q as isFilterable, r as SCHEMA_PROXY_METHODS, s as isSchemaProxyMethod, t as ProxySchemaClient, u as RestClient, v as FIELD_SCHEMA_OVERRIDES, w as statusFieldNameFor, x as normalizeField, y as displayNameOf, z as predictFieldName } from "./schema-write-D_WfMYW8.mjs";
 //#region src/field-icons.ts
 const ICONS = {
 	text: "type",
@@ -38,6 +38,52 @@ function iconNameFor(dataType) {
 /** Every icon name this module can return, for a UI package's name-to-component map. */
 const FIELD_ICON_NAMES = [.../* @__PURE__ */ new Set([...Object.values(ICONS), DEFAULT_FIELD_ICON])].sort();
 //#endregion
+//#region src/data-type-labels.ts
+const DATA_TYPE_LABELS = {
+	text: "Text",
+	number: "Number",
+	float: "Float",
+	percent: "Percent",
+	currency: "Currency",
+	duration: "Duration",
+	timecode: "Timecode",
+	footage: "Footage",
+	checkbox: "Checkbox",
+	date: "Date",
+	date_time: "Date and time",
+	list: "List",
+	status_list: "Status list",
+	entity: "Entity",
+	multi_entity: "Multi-entity",
+	tag_list: "Tag list",
+	entity_type: "Entity type",
+	image: "Image",
+	url: "URL",
+	color: "Color",
+	uuid: "UUID",
+	jsonb: "JSON",
+	calculated: "Calculated",
+	summary: "Summary",
+	serializable: "Serializable",
+	password: "Password",
+	pivot_column: "Pivot column"
+};
+/** The label of a data type: the caller's, else this build's, else the name as given. */
+function dataTypeLabel(dataType, labels) {
+	if (labels && Object.hasOwn(labels, dataType)) return labels[dataType];
+	return Object.hasOwn(DATA_TYPE_LABELS, dataType) ? DATA_TYPE_LABELS[dataType] : dataType;
+}
+/** The options a picker offers for a set of data types, in the order given, each once. */
+function dataTypeOptions(types, config = {}) {
+	const codes = new Set(types);
+	if (config.value) codes.add(config.value);
+	codes.delete("");
+	return [...codes].map((code) => ({
+		code,
+		label: dataTypeLabel(code, config.labels)
+	}));
+}
+//#endregion
 //#region src/filter-ux.ts
 /** One label per raw operator, for a type that has no wording of its own. */
 const OPERATOR_LABELS = {
@@ -4712,6 +4758,94 @@ function createStatusService(client) {
 	};
 }
 //#endregion
+//#region src/valid-values.ts
+/** The values trimmed, the blank ones dropped, in the order given. */
+function normalizeListValues(values, options = {}) {
+	const kept = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const raw of values) {
+		const value = raw.trim();
+		if (value === "") continue;
+		if (options.unique && seen.has(value)) continue;
+		seen.add(value);
+		kept.push(value);
+	}
+	return kept;
+}
+/** One value per line of a typed or pasted text. */
+function splitListValues(text, options = {}) {
+	return normalizeListValues(text.split(/\r\n|\r|\n/), options);
+}
+/**
+* The list with the value at `index` rewritten as `text`. A blank text removes it, a
+* text of several lines puts each line in its place, and the index past the end appends.
+*/
+function replaceListValue(values, index, text, options = {}) {
+	if (index < 0 || index > values.length) return [...values];
+	const next = [...values];
+	next.splice(index, 1, ...splitListValues(text));
+	return normalizeListValues(next, options);
+}
+/** The list with every line of `text` appended. */
+function addListValues(values, text, options = {}) {
+	return replaceListValue(values, values.length, text, options);
+}
+/** The list with the value at `from` moved to `to`. A place outside the list leaves it alone. */
+function moveListValue(values, from, to) {
+	const next = [...values];
+	if (from < 0 || from >= next.length || to < 0 || to >= next.length || from === to) return next;
+	const [moved] = next.splice(from, 1);
+	next.splice(to, 0, moved);
+	return next;
+}
+/**
+* The rows for `values`, keeping the keys of `rows` wherever a row is still there.
+*
+* Values may repeat, so a value cannot be its row's key. A row is matched where it
+* stands, then by its value wherever it went, then by its place when its value was
+* edited; what is left is new and takes a key no row holds. Unchanged values answer
+* the rows as given.
+*/
+function syncListRows(rows, values) {
+	if (rows.length === values.length && rows.every((row, index) => row.value === values[index])) return rows;
+	const keys = values.map(() => void 0);
+	const used = /* @__PURE__ */ new Set();
+	const take = (at, from) => {
+		keys[at] = rows[from].key;
+		used.add(from);
+	};
+	values.forEach((value, at) => {
+		if (rows[at]?.value === value) take(at, at);
+	});
+	values.forEach((value, at) => {
+		if (keys[at] !== void 0) return;
+		const from = rows.findIndex((row, index) => !used.has(index) && row.value === value);
+		if (from >= 0) take(at, from);
+	});
+	values.forEach((_, at) => {
+		if (keys[at] === void 0 && at < rows.length && !used.has(at)) take(at, at);
+	});
+	let minted = rows.reduce((most, row) => Math.max(most, Number(row.key.slice(1)) || 0), 0);
+	return values.map((value, at) => ({
+		key: keys[at] ?? `r${++minted}`,
+		value
+	}));
+}
+/** Every status of the site as an option: its code, and its name as the label. */
+function statusTableOptions(records) {
+	const seen = /* @__PURE__ */ new Set();
+	const options = [];
+	for (const record of records) {
+		if (record.code === "" || seen.has(record.code)) continue;
+		seen.add(record.code);
+		options.push({
+			code: record.code,
+			label: record.name || record.code
+		});
+	}
+	return options;
+}
+//#endregion
 //#region src/proxy-handler.ts
 /** The methods the protocol carries, one POST each. */
 const PROXY_METHODS = [
@@ -4815,8 +4949,10 @@ function fail(status, message, body = null) {
 	};
 }
 /** Wraps a client so a host app can expose it over its own HTTP endpoints. */
-function createProxyHandler(client) {
+function createProxyHandler(client, options = {}) {
+	const schema = options.schema ? createSchemaProxyHandler(options.schema) : null;
 	return async function handle(method, body) {
+		if (schema && isSchemaProxyMethod(method)) return schema(method, body);
 		if (!isProxyMethod(method)) return fail(404, `Unknown method '${method}'`);
 		if (body !== void 0 && body !== null && typeof body !== "object") return fail(400, "Body must be a JSON object");
 		const p = body ?? {};
@@ -6014,6 +6150,27 @@ function searchFieldPathOptions(options, query) {
 	return options.filter((option) => matchesEveryWord(haystack(option.label, option.path), query));
 }
 //#endregion
+//#region src/project-eligibility.ts
+/** The Project checkboxes eligibility reads; request them with the projects. */
+const PROJECT_ELIGIBILITY_FIELDS = [
+	"is_template",
+	"archived",
+	"is_demo"
+];
+/**
+* Whether a project is eligible for field visibility: not a template, not archived, not
+* a demo project. Status is never read: `sg_status` is null on most working projects
+* (findings/018_project_listing). Only a flag that is `true` excludes; the probed site
+* never returned a null checkbox.
+*/
+function isEligibleProject(project) {
+	return PROJECT_ELIGIBILITY_FIELDS.every((field) => project[field] !== true);
+}
+/** The eligible projects, in their order. */
+function eligibleProjects(projects) {
+	return projects.filter(isEligibleProject);
+}
+//#endregion
 //#region src/sortable.ts
 /** The attribute carrying an item's id. It is what the controller walks the list by. */
 const SORTABLE_ID_ATTRIBUTE = "data-sortable-id";
@@ -6385,6 +6542,22 @@ function createSortableController(options) {
 		window.removeEventListener("keydown", onDragKey, true);
 	}
 	let keyboard = null;
+	/**
+	* A move is drawn after the key that made it, and a row moved in the document
+	* loses the focus it held. That is the redraw, not the caret leaving: a carry
+	* goes on, and the grip takes the focus back once the list is drawn, unless
+	* the caret has gone somewhere else by then.
+	*/
+	function holdThroughRedraw(handle) {
+		const carried = keyboard;
+		if (carried) carried.redrawing = true;
+		setTimeout(() => {
+			if (carried) carried.redrawing = false;
+			if (keyboard !== carried || !container.contains(handle)) return;
+			const active = handle.ownerDocument.activeElement;
+			if (active === null || active === handle.ownerDocument.body) handle.focus({ preventScroll: true });
+		}, 0);
+	}
 	function endKeyboard() {
 		keyboard = null;
 		clearMarks();
@@ -6402,7 +6575,8 @@ function createSortableController(options) {
 			event.preventDefault();
 			keyboard = {
 				id,
-				origin: [...order()]
+				origin: [...order()],
+				redrawing: false
 			};
 			item.setAttribute("data-dragging", "true");
 			setActive(id);
@@ -6416,6 +6590,7 @@ function createSortableController(options) {
 			const next = held.keyboardMove(id, event.key === "ArrowUp" ? "up" : "down");
 			const to = next.indexOf(id);
 			if (to === held.indexOf(id)) return;
+			holdThroughRedraw(handle);
 			onOrderChange(next, id);
 			say(held.movedTo(id, to));
 			handle.scrollIntoView({ block: "nearest" });
@@ -6432,13 +6607,14 @@ function createSortableController(options) {
 			event.stopPropagation();
 			const restored = keyboard.origin;
 			endKeyboard();
+			holdThroughRedraw(handle);
 			onOrderChange([...restored], id);
 			say(sortableAnnouncements.cancel());
 		}
 	}
 	/** Focus leaving the list drops what it was carrying rather than stranding it. */
 	function onFocusOut(event) {
-		if (!keyboard) return;
+		if (!keyboard || keyboard.redrawing) return;
 		const next = event.relatedTarget;
 		if (next instanceof Node && container.contains(next)) return;
 		say(model().dropped(keyboard.id));
@@ -8195,4 +8371,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, 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, repeatedLabels, 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 };
+export { AppSessionError, COLOR_SENTINEL, CUSTOM_FIELD_PREFIX, DATA_TYPES, DATA_TYPE_LABELS, 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_ELIGIBILITY_FIELDS, PROJECT_PICKER_FIELDS, PROXY_METHODS, ProxyClient, ProxySchemaClient, RestClient, RestSchemaClient, SCHEMA_PROXY_METHODS, 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, SchemaApiError, SgApiError, THUMBNAIL_PENDING_PATH, TIME_UNITS, TIME_UNIT_LABELS, TREE_STATUS_FIELDS, UNRESOLVED_PATH_LABEL, USER_PICKER_FIELDS, VALUE_SHAPE, addListValues, 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, createSchemaProxyHandler, createSchemaService, createSessionTokenAuth, createSgContext, createSortable, createSortableController, createStatusService, createTree, currentPlatform, currentType, dataTypeLabel, dataTypeOptions, defaultCondition, defaultValueFor, deriveFieldOptions, describeCondition, describeEntityCard, describePaging, displayNameOf, editorKindFor, editorNeedsContext, editorPlacementFor, eligibleProjects, emptyFilter, emptyValueFor, entityCardFields, entityCardSlot, entityDetailUrl, entityKey, entityTypeOptions, errorText, eventLogFilters, expandAll, extendByStep, extendRange, facetCounts, facetLists, facetPresets, facetScopes, facetShape, facetValues, facetValuesFromGroups, fieldFromRaw, 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, hasNonAscii, hierarchyEntity, hierarchyLoader, hierarchySearcher, hydrate, iconNameFor, idsForRefs, imageState, initialsOf, intersectStatuses, isBareRef, isBlankCondition, isCollapsed, isDataType, isEditableType, isEligibleProject, isEmptyFilter, isEmptyValue, isFilterable, isGroupingRefusal, isHiddenPath, isLinkType, isNativeStatus, isNumericType, isOperator, isParseError, isPinned, isProxyMethod, isSchemaProxyMethod, isSortable, isTemporalType, isValidListValue, isoDay, isoDayParts, listStatus, loadEntityCard, loadsOnArrowDown, markOverflow, matchRuns, matchesEveryWord, matchingOffer, measureSortable, mergeFilters, moveAt, moveFieldPath, moveListValue, nameColorIndex, nameHue, nameSearchFilter, nativeStatus, nextEnabledIndex, nodeAt, normalizeEventLogEntry, normalizeField, normalizeFields, normalizeHierarchyNode, normalizeListValues, 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, predictFieldName, preferencesOf, prependRecent, presetById, presetIdOf, presetsFor, pressGate, projectOfPath, projectPickerFilters, pruneFilterToFields, queryPlan, reachedEnd, referencedPaths, refsForIds, relativeFrom, relativeLuminance, relativeOperator, relativeValue, relativeWindow, removeAt, renderKindFor, repeatedLabels, replaceAt, replaceListValue, 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, splitListValues, spriteStyle, stateLine, statusFieldFor, statusFieldNameFor, statusGlyph, statusLabel, statusPaint, statusTableOptions, stepNumber, stockIconSource, storedNumber, subLabelType, summariseSelection, supportsEmpty, supportsOperator, syncListRows, thumbnailField, timeUnitField, timeUnitLabel, timeZoneName, toApi3Hash, toApiDate, toApiDateTime, toApiFloat, toColumn, toFilterArray, toRef, toSchemaProperties, 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,42 @@
-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";
+import { A as BatchRequest, B as HierarchyPath, I as EventLogOptions, J as SearchResult, L as EventLogResult, N as EntityRow, P as EntityTypeInfo, Q as SummarizeResult, R as FollowingOptions, Rt as StatusRecord, W as ReadOptions, X as SgClient, Z as SummarizeOptions, _ as ReviveFieldResult, at as ThreadRow, b as SchemaClient, bt as TextSearchFilter, cn as FieldSchema, f as CreateFieldInput, j as BatchResult, ln as RawFieldSchema, m as FieldReadResult, mt as EntityRef, ot as UploadFile, p as CreatedField, q as SearchOptions, rt as TextSearchRow, st as UploadResult, x as SchemaProperties, z as HierarchyNode } from "./proxy-handler-C6XB6gss.mjs";
+//#region src/schema-write-mock.d.ts
+export interface MockSchemaFailure {
+  /** HTTP status. Default 500. */
+  status?: number;
+  /** `errors[0].title`. */
+  message?: string;
+}
+export interface MockSchemaClientOptions {
+  /** Where the fields this client did not create are read from. Without one, only its own fields exist. */
+  client?: Pick<SgClient, 'fields'>;
+  /** Arm a failure for the very first call. */
+  failNext?: MockSchemaFailure | null;
+}
+export declare class MockSchemaClient implements SchemaClient {
+  private readonly base;
+  /** Fields this client created or wrote, by `Type.field`. */
+  private readonly live;
+  /** Retired fields. The name stays taken and no read lists it (040_field_revive). */
+  private readonly retired;
+  /** Writes made at a project's scope, by `Type.field@project`. */
+  private readonly scoped;
+  private pendingFailure;
+  constructor(options?: MockSchemaClientOptions);
+  /** Make the next call reject with a `SchemaApiError`. Pass `null` to disarm. */
+  failNext(failure?: MockSchemaFailure | null): void;
+  private gate;
+  /** The base client's fields of a type; an unknown type is its 404. */
+  private baseFields;
+  /** Every live record of a type at a scope, this client's writes over the base client's fields. */
+  private records;
+  readField(entityType: string, field: string, projectId?: number): Promise<FieldReadResult>;
+  readRawFields(entityType: string, projectId?: number): Promise<Record<string, RawFieldSchema>>;
+  createField(entityType: string, input: CreateFieldInput): Promise<CreatedField>;
+  updateField(entityType: string, field: string, properties: SchemaProperties, projectId?: number): Promise<RawFieldSchema | null>;
+  retireField(entityType: string, field: string): Promise<void>;
+  reviveField(entityType: string, field: string): Promise<ReviveFieldResult>;
+}
+//#endregion
 //#region src/mock.d.ts
 /** What the next call should throw instead of answering. */
 export interface MockFailure {