@chelone/core 0.7.0 → 0.10.0

package/dist/auth/auth-options.d.ts

@@ -1,5 +1,7 @@
 import { type SkipToken } from "@tanstack/query-core";
 import type { AuthProvider, CanAccessParams, UserIdentity } from "./types.js";
+/** The path a logged-out session is sent to when no `redirectTo` is given. */
+export declare const DEFAULT_LOGIN_PATH = "/login";
 /** The option shape of the factories that skip with no provider. */
 interface SkippableQueryOptions<TKey, TData> {
     queryKey: TKey;

package/dist/auth/auth-options.js

@@ -1,6 +1,8 @@
 import { isRecord } from "../guards.js";
 import { skipToken } from "@tanstack/query-core";
 // src/auth/auth-options.ts
+/** The path a logged-out session is sent to when no `redirectTo` is given. */
+var DEFAULT_LOGIN_PATH = "/login";
 /** `skipToken` (the query never runs) with no provider, else `read` bound to it. */
 function queryFnFor(authProvider, read) {
 	return authProvider ? () => read(authProvider) : skipToken;
@@ -89,4 +91,4 @@ async function checkError(authProvider, error) {
 		};
 	}
 }
-export { authStateQueryOptions, canAccessQueryOptions, checkError, identityQueryOptions, permissionsQueryOptions };
+export { DEFAULT_LOGIN_PATH, authStateQueryOptions, canAccessQueryOptions, checkError, identityQueryOptions, permissionsQueryOptions };

package/dist/block-editor/block-document.d.ts

@@ -1,5 +1,9 @@
 import type { StandardSchemaV1 } from "@tanstack/form-core";
 import { type FieldDescriptor } from "../resource/describe-resource.js";
+/** The dnd-kit id of the block editor's drag handle, shared by both adapters. */
+export declare const HANDLE_ID = "block-drag-handle";
+/** Prefix of the dnd-kit id of each drop gap, followed by the gap's index. */
+export declare const GAP_PREFIX = "block-gap-";
 export type Attrs = Record<string, unknown>;
 /** The shape of tiptap JSON, with no tiptap import. */
 export interface BlockDocNode {

package/dist/block-editor/block-document.js

@@ -1,6 +1,10 @@
 import { columnLabelMatches } from "../controller/data-table-columns.js";
 import { describeField } from "../resource/describe-resource.js";
 // src/block-editor/block-document.ts
+/** The dnd-kit id of the block editor's drag handle, shared by both adapters. */
+var HANDLE_ID = "block-drag-handle";
+/** Prefix of the dnd-kit id of each drop gap, followed by the gap's index. */
+var GAP_PREFIX = "block-gap-";
 var unknownBlockType = "unknownBlock";
 var builtInNodes = /* @__PURE__ */ new Set([
 	"doc",
@@ -140,4 +144,4 @@ function toEmbedSrc(url) {
 	}
 	return null;
 }
-export { createBlockRegistry, describeBlockAttrs, emptyBlockDocument, getBlockDefaultAttrs, isBlockDoc, isEmptyBlockDocument, matchBlocks, toEmbedSrc, unknownBlockType, unwrapUnknownBlocks, wrapUnknownBlocks };
+export { GAP_PREFIX, HANDLE_ID, createBlockRegistry, describeBlockAttrs, emptyBlockDocument, getBlockDefaultAttrs, isBlockDoc, isEmptyBlockDocument, matchBlocks, toEmbedSrc, unknownBlockType, unwrapUnknownBlocks, wrapUnknownBlocks };

package/dist/command-menu/recents.d.ts

@@ -1,5 +1,9 @@
 /** Where the command menu keeps its recents in a `CheloneStore`. */
 export declare const recentsKey = "command-menu.recents";
+/** Most recents the command menu keeps when `recentsLimit` is not set. */
+export declare const DEFAULT_RECENTS_LIMIT = 10;
+/** Wait after the last keystroke, in milliseconds, when `searchDebounceMs` is not set. */
+export declare const DEFAULT_SEARCH_DEBOUNCE_MS = 250;
 /**
  * A page the user visited. It holds no `path`: the link is rebuilt from the
  * resource and id, so a basename change cannot strand a saved entry.

package/dist/command-menu/recents.js

@@ -1,6 +1,10 @@
 // src/command-menu/recents.ts
 /** Where the command menu keeps its recents in a `CheloneStore`. */
 var recentsKey = "command-menu.recents";
+/** Most recents the command menu keeps when `recentsLimit` is not set. */
+var DEFAULT_RECENTS_LIMIT = 10;
+/** Wait after the last keystroke, in milliseconds, when `searchDebounceMs` is not set. */
+var DEFAULT_SEARCH_DEBOUNCE_MS = 250;
 function sameEntry(a, b) {
 	return a.type === b.type && a.resource === b.resource && (a.id === void 0 ? void 0 : String(a.id)) === (b.id === void 0 ? void 0 : String(b.id));
 }
@@ -9,4 +13,4 @@ function rememberRecent(recents, entry, limit) {
 	if (limit < 1) return [];
 	return [entry, ...recents.filter((other) => !sameEntry(other, entry))].slice(0, limit);
 }
-export { recentsKey, rememberRecent };
+export { DEFAULT_RECENTS_LIMIT, DEFAULT_SEARCH_DEBOUNCE_MS, recentsKey, rememberRecent };

package/dist/controller/calendar-dates.d.ts

@@ -15,6 +15,18 @@ export declare function parseCalendarDate(value: unknown): Date | undefined;
 export declare function calendarRange(view: CalendarView, anchor: Date, weekStartsOn: CalendarWeekStart): CalendarRange;
 /** One local midnight per day: adding to the day of the month never skips or repeats a day when the clocks change. */
 export declare function calendarDays(range: CalendarRange): Date[];
+/** A selected day cell: the whole local day, as ISO strings. */
+export interface CalendarDaySlot {
+    startISO: string;
+    endISO: string;
+    allDay: true;
+}
+/**
+ * The slot a whole day is: its local midnight to its last millisecond, the same
+ * inclusive end {@link calendarRange} gives a range. A day carrying a time is
+ * read as its day, not that instant.
+ */
+export declare function calendarDaySlot(day: Date): CalendarDaySlot;
 export declare function shiftCalendarAnchor(view: CalendarView, anchor: Date, direction: 1 | -1): Date;
 export declare const calendarDayKey: (date: Date) => string;
 export interface CalendarLabels {

package/dist/controller/calendar-dates.js

@@ -46,6 +46,18 @@ function calendarDays(range) {
 	for (let day = first; day.getTime() <= range.end.getTime(); day = atMidnight(first, days.length)) days.push(day);
 	return days;
 }
+/**
+* The slot a whole day is: its local midnight to its last millisecond, the same
+* inclusive end {@link calendarRange} gives a range. A day carrying a time is
+* read as its day, not that instant.
+*/
+function calendarDaySlot(day) {
+	return {
+		startISO: atMidnight(day).toISOString(),
+		endISO: atEndOfDay(day).toISOString(),
+		allDay: true
+	};
+}
 function shiftCalendarAnchor(view, anchor, direction) {
 	const time = [
 		anchor.getHours(),
@@ -89,4 +101,4 @@ function calendarLabels(locale) {
 		agendaDay: (date) => agendaDay.format(date)
 	};
 }
-export { calendarDayKey, calendarDays, calendarLabels, calendarRange, parseCalendarDate, shiftCalendarAnchor };
+export { calendarDayKey, calendarDaySlot, calendarDays, calendarLabels, calendarRange, parseCalendarDate, shiftCalendarAnchor };

package/dist/controller/in-place-editor.d.ts

@@ -2,22 +2,22 @@
  * Pure rules for an in-place editor. No react, no vue: both InPlaceEditor
  * adapters step through the same states and send the same fields on a save.
  */
-import type { ResourceRecord } from "../resource/record.js";
-export type InPlaceEditorState = {
+import type { LooseRecord, ResourceRecord } from "../resource/record.js";
+export type InPlaceEditorState<R extends ResourceRecord = LooseRecord> = {
     status: "reading";
 } | {
     status: "editing";
 } | {
     status: "saving";
-    preview: Record<string, unknown>;
+    preview: R;
 };
-export type InPlaceEditorEvent = {
+export type InPlaceEditorEvent<R extends ResourceRecord = LooseRecord> = {
     type: "edit";
 } | {
     type: "cancel";
 } | {
     type: "save";
-    preview: Record<string, unknown>;
+    preview: R;
 } | {
     type: "settled";
 };
@@ -26,12 +26,13 @@ export type InPlaceEditorEvent = {
  * `cancel`, editing to saving on `save`, saving to reading on `settled`. Any
  * other pair returns the same state object, so a click while saving does nothing.
  */
-export declare function nextInPlaceEditorState(state: InPlaceEditorState, event: InPlaceEditorEvent): InPlaceEditorState;
+export declare function nextInPlaceEditorState<R extends ResourceRecord = LooseRecord>(state: InPlaceEditorState<R>, event: InPlaceEditorEvent<R>): InPlaceEditorState<R>;
 export interface InPlaceSave<R extends ResourceRecord> {
     id: R["id"];
-    data: Record<string, unknown>;
+    data: Partial<R>;
     previousData: R;
-    preview: Record<string, unknown>;
+    /** The record with the changed fields over it. */
+    preview: R;
 }
 /**
  * Plans a save from the record and the dirty form values. `data` keeps the

package/dist/controller/in-place-editor.js

@@ -27,8 +27,9 @@ function nextInPlaceEditorState(state, event) {
 */
 function planInPlaceSave(record, dirty) {
 	if (!isLooseRecord(record)) return null;
-	const data = Object.fromEntries(Object.entries(dirty).filter(([key, value]) => !deepEqual(record[key], value)));
-	if (Object.keys(data).length === 0) return null;
+	const changed = Object.entries(dirty).filter(([key, value]) => !deepEqual(record[key], value));
+	if (changed.length === 0) return null;
+	const data = Object.fromEntries(changed);
 	return {
 		id: record.id,
 		data,

package/dist/controller/inspector.d.ts

@@ -26,6 +26,12 @@ export interface Inspector<TEditor> {
 }
 export declare function createInspector<TEditor = unknown>(): Inspector<TEditor>;
 export declare const inspectorPositionKey = "chelone.inspector.position";
+/** The panel's width in pixels. */
+export declare const PANEL_WIDTH = 320;
+/** How far one arrow key moves the panel, in pixels. */
+export declare const INSPECTOR_KEY_STEP = 16;
+/** The message key a `<Configurable>`'s open button falls back to. */
+export declare const INSPECTOR_OPEN_LABEL = "chelone.inspector.customize";
 export interface InspectorPosition {
     x: number;
     y: number;

package/dist/controller/inspector.js

@@ -30,6 +30,12 @@ function createInspector() {
 	};
 }
 var inspectorPositionKey = "chelone.inspector.position";
+/** The panel's width in pixels. */
+var PANEL_WIDTH = 320;
+/** How far one arrow key moves the panel, in pixels. */
+var INSPECTOR_KEY_STEP = 16;
+/** The message key a `<Configurable>`'s open button falls back to. */
+var INSPECTOR_OPEN_LABEL = "chelone.inspector.customize";
 var clamp = (value, min, max) => Math.min(Math.max(value, min), Math.max(min, max));
 /**
 * Keeps the panel's drag handle on screen. A missing or non-finite position
@@ -61,4 +67,4 @@ function configurableInputColumns(inputs) {
 		return column;
 	});
 }
-export { clampInspectorPosition, configurableInputColumns, createInspector, defaultConfigurableInputsStoreKey, inspectorPositionKey };
+export { INSPECTOR_KEY_STEP, INSPECTOR_OPEN_LABEL, PANEL_WIDTH, clampInspectorPosition, configurableInputColumns, createInspector, defaultConfigurableInputsStoreKey, inspectorPositionKey };

package/dist/controller/job-monitor.d.ts

@@ -8,6 +8,7 @@
  */
 import type { Identifier } from "../resource/identifier.js";
 import type { ResourceRecord } from "../resource/record.js";
+import type { SourceKey } from "../resource/source-path.js";
 /** The monitor's tabs, in order. One `buildKanbanBuckets` column per status. */
 export declare const DEFAULT_JOB_TABS: readonly ["running", "queued", "failed", "done"];
 export interface JobActionOptions<TRecord extends object> {
@@ -31,9 +32,15 @@ export interface JobActions {
 /** The arguments of one `update` call, ready to hand to a data provider. */
 export interface JobPlan<TRecord> {
     id: Identifier;
-    data: Record<string, string>;
+    data: Partial<TRecord>;
     previousData: TRecord;
 }
+/**
+ * The status key a monitor reads: `source`, or `"status"`. `SourceKey` is
+ * `keyof TRecord & string` for a typed record and `string` for a loose one,
+ * whose keys are every string, so it is always a key of `TRecord`.
+ */
+export declare function jobStatusSource<TRecord extends object>(source?: SourceKey<TRecord>): keyof TRecord & string;
 export declare function getJobActions<TRecord extends object>(record: TRecord & object, options?: JobActionOptions<TRecord>): JobActions;
 /** The `update` that retries the job, or `null` when it cannot be retried. */
 export declare function planJobRetry<TRecord extends ResourceRecord = ResourceRecord>(record: TRecord, options?: JobActionOptions<TRecord>): JobPlan<TRecord> | null;

package/dist/controller/job-monitor.js

@@ -18,6 +18,14 @@ function canMove(record, source, from, to) {
 		allowed: allowed.includes(to)
 	};
 }
+/**
+* The status key a monitor reads: `source`, or `"status"`. `SourceKey` is
+* `keyof TRecord & string` for a typed record and `string` for a loose one,
+* whose keys are every string, so it is always a key of `TRecord`.
+*/
+function jobStatusSource(source) {
+	return source ?? "status";
+}
 function getJobActions(record, options = {}) {
 	const { statusSource = "status", retryFrom = ["failed"], cancelFrom = ["running", "queued"], retryValue = "queued", cancelValue = "cancelled" } = options;
 	const retry = canMove(record, statusSource, retryFrom, retryValue);
@@ -30,9 +38,10 @@ function getJobActions(record, options = {}) {
 }
 function plan(record, source, value, allowed) {
 	if (!allowed) return null;
+	const data = { [source]: value };
 	return {
 		id: record.id,
-		data: { [source]: value },
+		data,
 		previousData: record
 	};
 }
@@ -46,4 +55,4 @@ function planJobCancel(record, options = {}) {
 	const { statusSource = "status", cancelValue = "cancelled" } = options;
 	return plan(record, statusSource, cancelValue, getJobActions(record, options).canCancel);
 }
-export { DEFAULT_JOB_TABS, getJobActions, planJobCancel, planJobRetry };
+export { DEFAULT_JOB_TABS, getJobActions, jobStatusSource, planJobCancel, planJobRetry };

package/dist/controller/kanban-board.d.ts

@@ -9,6 +9,7 @@
  */
 import type { Identifier } from "../resource/identifier.js";
 import type { ResourceRecord } from "../resource/record.js";
+import type { SourceKey } from "../resource/source-path.js";
 export interface KanbanColumnDef {
     /** Value written to `groupSource` by a drop into this column. */
     id: string;
@@ -35,11 +36,11 @@ export interface KanbanMove<R> {
  * is in no bucket, and records keep list order inside a bucket. A repeated
  * column id keeps the first column's records and leaves the later one empty.
  */
-export declare function buildKanbanBuckets<R extends ResourceRecord>(records: readonly R[], groupSource: keyof R & string, columns: readonly KanbanColumnDef[]): KanbanBucket<R>[];
+export declare function buildKanbanBuckets<R extends ResourceRecord>(records: readonly R[], groupSource: SourceKey<R>, columns: readonly KanbanColumnDef[]): KanbanBucket<R>[];
 /**
  * The update a drop into `targetColumnId` asks for, or `null` when there is
  * nothing to write: the target is not a column, or the record already sits in
  * it. A drop that writes nothing still fires a data-provider `update` on every
  * board that re-renders on a dropped drag, so the adapters ask here first.
  */
-export declare function planKanbanMove<R extends ResourceRecord>(record: R, groupSource: keyof R & string, columns: readonly KanbanColumnDef[], targetColumnId: string): KanbanMove<R> | null;
+export declare function planKanbanMove<R extends ResourceRecord>(record: R, groupSource: SourceKey<R>, columns: readonly KanbanColumnDef[], targetColumnId: string): KanbanMove<R> | null;

package/dist/controller/kanban-board.js

@@ -3,9 +3,11 @@
 * The column key a record sits under: its group value as a string, with a
 * missing or null value reading as `""`. A top-level key, because a move can
 * only write `{ [source]: value }` — as in {@link getAllowedTransitions}.
+* Read through `Reflect.get`: `SourceKey<R>` of a generic record is a
+* deferred type, so `record[groupSource]` would not typecheck.
 */
 function bucketKey(record, groupSource) {
-	return String(record[groupSource] ?? "");
+	return String(Reflect.get(record, groupSource) ?? "");
 }
 /**
 * One bucket per column, in column order, empty columns included. A record

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

@@ -76,6 +76,9 @@ export interface ListControllerOptions {
     storeKey?: string | false;
     enabled?: boolean;
 }
+/** The `perPage` a list starts at when nothing is persisted or in the URL. The single definition: `prev-next` and both adapters read this. */
+export declare const DEFAULT_PER_PAGE = 10;
+/** Debounce delay for `setFilters(..., debounced=true)` when no `debounceMs` option is given. Shared with the reference-many and choices controllers. */
 export declare const DEFAULT_DEBOUNCE_MS = 500;
 export declare const DEFAULT_SELECT_ALL_LIMIT = 250;
 /**

package/dist/controller/list-controller.js

@@ -4,7 +4,10 @@ import { isRecord } from "../guards.js";
 import { createMicroStore } from "../store/micro-store.js";
 import { QueryObserver } from "@tanstack/query-core";
 // src/controller/list-controller.ts
+/** The `perPage` a list starts at when nothing is persisted or in the URL. The single definition: `prev-next` and both adapters read this. */
 var DEFAULT_PER_PAGE = 10;
+/** Debounce delay for `setFilters(..., debounced=true)` when no `debounceMs` option is given. Shared with the reference-many and choices controllers. */
+var DEFAULT_DEBOUNCE_MS = 500;
 var DEFAULT_SORT = [{
 	field: "id",
 	order: "ASC"
@@ -188,7 +191,7 @@ function createListController(ctx, resource, options = {}) {
 	const kv = ctx.store;
 	const defaults = {
 		page: 1,
-		perPage: options.perPage ?? DEFAULT_PER_PAGE,
+		perPage: options.perPage ?? 10,
 		sort: normalizeSort(options.sort, DEFAULT_SORT),
 		filter: { ...options.filterDefaultValues ?? {} },
 		displayedFilters: {}
@@ -466,4 +469,4 @@ function createListController(ctx, resource, options = {}) {
 		refetch
 	};
 }
-export { createErrorAnnouncer, createListController, errorMessageKey, listControllerActions, listParamsFromPatch, notifyFetchError, notifySelectAllLimit, pageFlags, removeFilterPath, resetPageTarget, runSelectAll };
+export { DEFAULT_DEBOUNCE_MS, DEFAULT_PER_PAGE, createErrorAnnouncer, createListController, errorMessageKey, listControllerActions, listParamsFromPatch, notifyFetchError, notifySelectAllLimit, pageFlags, removeFilterPath, resetPageTarget, runSelectAll };

package/dist/controller/pivot-grid.d.ts

@@ -3,13 +3,13 @@
  * react, no vue: both PivotGrid adapters build the same table from the same
  * records and print numbers the same way.
  */
-import type { SourcePath } from "../resource/source-path.js";
+import type { SourceProp } from "../resource/source-path.js";
 export type PivotAggregator = "count" | "sum" | "avg" | "min" | "max";
 export interface PivotOptions<R> {
-    rowSource: SourcePath<R>;
-    columnSource: SourcePath<R>;
+    rowSource: SourceProp<R>;
+    columnSource: SourceProp<R>;
     /** Read by every aggregator but `count`. */
-    valueSource?: SourcePath<R>;
+    valueSource?: SourceProp<R>;
     /** Defaults to `count`. */
     aggregator?: PivotAggregator;
 }

package/dist/controller/prev-next.js

@@ -1,6 +1,6 @@
+import "./list-controller.js";
 // src/controller/prev-next.ts
 var DEFAULT_PREV_NEXT_LIMIT = 1e3;
-var DEFAULT_PER_PAGE = 10;
 var DEFAULT_SORT = {
 	field: "id",
 	order: "ASC"
@@ -19,7 +19,7 @@ function toListSort(sort) {
 function getPrevNextParams(stored, options = {}) {
 	const persisted = options.storeKey === false ? void 0 : stored;
 	const page = persisted?.page ?? 1;
-	const perPage = persisted?.perPage ?? DEFAULT_PER_PAGE;
+	const perPage = persisted?.perPage ?? 10;
 	const sort = toListSort(persisted?.sort && (!Array.isArray(persisted.sort) || persisted.sort.length) ? persisted.sort : options.sort);
 	const filter = {
 		...persisted?.filter ?? options.filterDefaultValues,

package/dist/controller/record-diff.d.ts

@@ -2,7 +2,7 @@
  * Pure rules for a record diff. No react, no vue: both DiffViewer adapters
  * mark the same field the same way and print the same default text.
  */
-import type { SourcePath } from "../resource/source-path.js";
+import type { SourceProp } from "../resource/source-path.js";
 export type DiffStatus = "unchanged" | "added" | "removed" | "changed";
 export interface RecordDiffRow {
     source: string;
@@ -16,6 +16,6 @@ export interface RecordDiffRow {
  * `null` and `undefined` both count as missing; an empty string is a value.
  * Neither record is changed.
  */
-export declare function diffRecords<R>(before: R, after: R, sources?: readonly SourcePath<R>[]): RecordDiffRow[];
+export declare function diffRecords<R>(before: R, after: R, sources?: readonly SourceProp<R>[]): RecordDiffRow[];
 /** The text a viewer shows for a value when the app gives no renderer. */
 export declare function formatDiffValue(value: unknown): string;

package/dist/controller/record-timeline.d.ts

@@ -4,7 +4,7 @@
  * relative time text.
  */
 import type { Identifier } from "../resource/identifier.js";
-import type { SourcePath } from "../resource/source-path.js";
+import type { SourceProp } from "../resource/source-path.js";
 export interface RecordTimelineEntry<R> {
     id: Identifier;
     record: R;
@@ -15,10 +15,10 @@ export interface RecordTimelineEntry<R> {
     icon: string | undefined;
 }
 export interface ToTimelineEntriesOptions<R> {
-    messageSource: SourcePath<R>;
-    timestampSource: SourcePath<R>;
-    userSource?: SourcePath<R>;
-    iconSource?: SourcePath<R>;
+    messageSource: SourceProp<R>;
+    timestampSource: SourceProp<R>;
+    userSource?: SourceProp<R>;
+    iconSource?: SourceProp<R>;
 }
 /**
  * One entry per record, in list order: the data provider's sort decides the

package/dist/controller/reference-many-controller.d.ts

@@ -29,6 +29,8 @@ export interface ReferenceManyControllerOptions {
 }
 /** Same state and actions as {@link ListController}, so it drops into a list context. */
 export type ReferenceManyController<TRecord> = ListController<TRecord>;
+/** The `perPage` a reference list starts at when nothing is persisted. The single definition: the choices controller and Vue's `<ReferenceInput>` read this. */
+export declare const DEFAULT_REFERENCE_PER_PAGE = 25;
 /**
  * A server-paged list of the rows whose `target` equals `id`, read through
  * `getManyReference`. Params and selection live in an inner list controller

package/dist/controller/reference-many-controller.js

@@ -3,7 +3,8 @@ import { createMicroStore } from "../store/micro-store.js";
 import { createErrorAnnouncer, createListController, pageFlags, resetPageTarget, runSelectAll } from "./list-controller.js";
 import { QueryObserver } from "@tanstack/query-core";
 // src/controller/reference-many-controller.ts
-var DEFAULT_PER_PAGE = 25;
+/** The `perPage` a reference list starts at when nothing is persisted. The single definition: the choices controller and Vue's `<ReferenceInput>` read this. */
+var DEFAULT_REFERENCE_PER_PAGE = 25;
 /**
 * A server-paged list of the rows whose `target` equals `id`, read through
 * `getManyReference`. Params and selection live in an inner list controller
@@ -24,7 +25,7 @@ function createReferenceManyController(ctx, reference, options) {
 		...ctx,
 		notifications: void 0
 	}, reference, {
-		perPage: options.perPage ?? DEFAULT_PER_PAGE,
+		perPage: options.perPage ?? 25,
 		sort: options.sort,
 		filterDefaultValues: options.filterDefaultValues,
 		storeKey,
@@ -199,4 +200,4 @@ function createReferenceManyController(ctx, reference, options) {
 		refetch
 	};
 }
-export { createReferenceManyController };
+export { DEFAULT_REFERENCE_PER_PAGE, createReferenceManyController };

package/dist/csv/export.d.ts

@@ -18,14 +18,14 @@
  * passes its own `exporter` prop — the button never assumes the default.
  */
 import type { DataProvider } from "../data/types.js";
-import type { LooseRecord } from "../resource/record.js";
+import type { LooseRecord, ResourceRecord } from "../resource/record.js";
 import type { CsvRow } from "./types.js";
 /**
  * Turns a page of records into a downloaded file. Called by the export buttons
  * with the fetched rows, the raw dataProvider (for follow-up fetches), and the
  * resource name.
  */
-export type Exporter<TRecord extends LooseRecord = LooseRecord> = (data: TRecord[], dataProvider: DataProvider, resource: string) => void | Promise<void>;
+export type Exporter<TRecord extends ResourceRecord = LooseRecord> = (data: TRecord[], dataProvider: DataProvider, resource: string) => void | Promise<void>;
 /**
  * Serialize records to CSV text. Columns are the UNION of every record's keys,
  * in first-seen order — so a sparse record still lines up under the right

package/dist/csv/import-controller.d.ts

@@ -1,5 +1,9 @@
 import { type MicroStore } from "../store/micro-store.js";
 import type { CsvImportOptions, CsvImportState, ParsedCsv } from "./types.js";
+/** How many rows either adapter's preview step lists. */
+export declare const PREVIEW_ROWS = 50;
+/** What `readAsText` writes for each byte it cannot read as UTF-8. */
+export declare const REPLACEMENT_CHAR = "\uFFFD";
 export interface CsvImportController {
     store: MicroStore<CsvImportState>;
     /** Takes the file the adapter parsed. Does nothing while an import runs. */

package/dist/csv/import-controller.js

@@ -9,6 +9,10 @@ var STEPS = [
 	"preview",
 	"commit"
 ];
+/** How many rows either adapter's preview step lists. */
+var PREVIEW_ROWS = 50;
+/** What `readAsText` writes for each byte it cannot read as UTF-8. */
+var REPLACEMENT_CHAR = "�";
 var asError = (error) => error instanceof Error ? error : new Error(String(error));
 function createCsvImportController(options) {
 	const fromSchema = csvSchemaFields(options.schema);
@@ -188,4 +192,4 @@ function createCsvImportController(options) {
 		}
 	};
 }
-export { createCsvImportController };
+export { PREVIEW_ROWS, REPLACEMENT_CHAR, createCsvImportController };

package/dist/data/fake-provider.js

@@ -85,7 +85,13 @@ function fakeDataProvider(initialData) {
 		return row;
 	};
 	let nextId = 1e6;
-	const listLike = (rows, params) => paginate(applySort(applyFilter(rows, params.filter), params.sort), params.pagination);
+	const listLike = (rows, params) => {
+		const page = paginate(applySort(applyFilter(rows, params.filter), params.sort), params.pagination);
+		return {
+			...page,
+			data: structuredClone(page.data)
+		};
+	};
 	return {
 		async getList(resource, params) {
 			return listLike(table(resource), params);

package/dist/data/with-lifecycle-callbacks.d.ts

@@ -1,4 +1,4 @@
-import type { LooseRecord, ResourceRecord } from "../resource/record.js";
+import type { ResourceRecord } from "../resource/record.js";
 import type { RecordOf, ResourceMap } from "../resource/registry.js";
 import type { CreateParams, CreateResult, DataProvider, DeleteManyParams, DeleteManyResult, DeleteParams, DeleteResult, GetListParams, GetListResult, GetManyParams, GetManyReferenceParams, GetManyReferenceResult, GetManyResult, GetOneParams, GetOneResult, UpdateManyParams, UpdateManyResult, UpdateParams, UpdateResult } from "./types.js";
 type MaybePromise<T> = T | Promise<T>;
@@ -21,7 +21,7 @@ interface RecordFreeCallbacks<TResources extends ResourceMap> {
  * `dataProvider` is the provider passed to `withLifecycleCallbacks`, so
  * calling it never re-enters the callbacks.
  */
-export interface LifecycleCallbacks<TResources extends ResourceMap, TRecord extends LooseRecord> extends RecordFreeCallbacks<TResources> {
+export interface LifecycleCallbacks<TResources extends ResourceMap, TRecord extends ResourceRecord> extends RecordFreeCallbacks<TResources> {
     afterGetList?(result: GetListResult<TRecord>, dataProvider: DataProvider<TResources>): MaybePromise<GetListResult<TRecord>>;
     afterGetOne?(result: GetOneResult<TRecord>, dataProvider: DataProvider<TResources>): MaybePromise<GetOneResult<TRecord>>;
     beforeCreate?(params: CreateParams<TRecord>, dataProvider: DataProvider<TResources>): MaybePromise<CreateParams<TRecord>>;

package/dist/form/choices-controller.d.ts

@@ -4,6 +4,12 @@ import type { NotificationStore } from "../notification/notification-store.js";
 import type { RecordOf, ResourceMap } from "../resource/registry.js";
 import type { SourceKey } from "../resource/source-path.js";
 import { type MicroStore } from "../store/micro-store.js";
+/**
+ * An erased choice record: choices carry arbitrary shapes (`{id, name, ...}`),
+ * and an adapter's choice inputs are generic over one. Both adapters re-export
+ * this as their own `ChoiceRecord`.
+ */
+export type ChoiceRecord = Record<string, unknown>;
 /**
  * The choices-context state (§0b parity). A list-like base (page/perPage/sort/
  * filter) plus a status union over three record views:
@@ -94,3 +100,16 @@ export interface ChoicesControllerOptions<TResources extends ResourceMap = Resou
  * observer result subscription — the subscription only maps results into state.
  */
 export declare function createChoicesController<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: ChoicesControllerContext<TResources>, options: ChoicesControllerOptions<TResources, TName>): ChoicesController<RecordOf<TResources, TName>>;
+/** The three choice views of a state, erased to `ChoiceRecord[]`. */
+export interface ChoiceLists {
+    allChoices: ChoiceRecord[];
+    availableChoices: ChoiceRecord[];
+    selectedChoices: ChoiceRecord[];
+}
+/**
+ * The state's three choice views as the erased lists an adapter's
+ * `ChoicesContextValue` carries — the one place a record becomes a
+ * `ChoiceRecord`, so neither adapter writes the cast. The arrays are the
+ * state's own, not copies.
+ */
+export declare function choiceListsOf<TRecord>(state: ChoicesControllerState<TRecord>): ChoiceLists;

package/dist/form/choices-controller.js

@@ -1,12 +1,11 @@
 import { notifyFetchError } from "../controller/list-controller.js";
+import "../controller/reference-many-controller.js";
 import { getListOptions, getManyOptions } from "../data/query-options.js";
 import { removeEmpty } from "../data/remove-empty.js";
 import { createMicroStore } from "../store/micro-store.js";
 import { QueryObserver, keepPreviousData } from "@tanstack/query-core";
 // src/form/choices-controller.ts
 var DEFAULT_PAGE = 1;
-var DEFAULT_PER_PAGE = 25;
-var DEFAULT_DEBOUNCE_MS = 500;
 var DEFAULT_SORT = {
 	field: "id",
 	order: "DESC"
@@ -38,10 +37,10 @@ function createChoicesController(ctx, options) {
 	const lookupKey = options.lookupKey ?? "id";
 	const isIdLookup = lookupKey === "id";
 	const permanentFilter = options.filter ?? {};
-	const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+	const debounceMs = options.debounceMs ?? 500;
 	const store = createMicroStore({
 		page: options.page ?? DEFAULT_PAGE,
-		perPage: options.perPage ?? DEFAULT_PER_PAGE,
+		perPage: options.perPage ?? 25,
 		sort: { ...options.sort ?? DEFAULT_SORT },
 		filter: {},
 		allChoices: [],
@@ -305,4 +304,18 @@ function createChoicesController(ctx, options) {
 		refetch
 	};
 }
-export { createChoicesController };
+/**
+* The state's three choice views as the erased lists an adapter's
+* `ChoicesContextValue` carries — the one place a record becomes a
+* `ChoiceRecord`, so neither adapter writes the cast. The arrays are the
+* state's own, not copies.
+*/
+function choiceListsOf(state) {
+	const { allChoices, availableChoices, selectedChoices } = state;
+	return {
+		allChoices,
+		availableChoices,
+		selectedChoices
+	};
+}
+export { choiceListsOf, createChoicesController };

package/dist/form/input-binding.js

@@ -146,7 +146,9 @@ function createFieldBinding(form, options) {
 		store: field.store,
 		getValue: formatValue,
 		setValue: (input) => field.handleChange(parseInput(input)),
-		blur: () => field.handleBlur(),
+		blur: () => {
+			if (unmountField !== void 0) field.handleBlur();
+		},
 		isRequired: () => isRequired(current.validate),
 		update(next) {
 			current = {