@chelone/core 0.1.0 → 0.2.0

package/dist/controller/calendar-events.js

@@ -1,20 +1,17 @@
+import { getAtPath } from "../resource/get-at-path.js";
 import { calendarDayKey, parseCalendarDate } from "./calendar-dates.js";
-const readPath = (record, path) => path.split(".").reduce(
-  (value, key) => value == null ? void 0 : value[key],
-  record
-);
 const midnight = (date, dayOffset = 0) => new Date(date.getFullYear(), date.getMonth(), date.getDate() + dayOffset);
 const isMidnight = (date) => date.getTime() === midnight(date).getTime();
 function toCalendarEvents(records, options) {
   const events = [];
   for (const record of records) {
-    const start = parseCalendarDate(readPath(record, options.startSource));
+    const start = parseCalendarDate(getAtPath(record, options.startSource));
     if (!start) continue;
-    const parsedEnd = options.endSource ? parseCalendarDate(readPath(record, options.endSource)) : void 0;
+    const parsedEnd = options.endSource ? parseCalendarDate(getAtPath(record, options.endSource)) : void 0;
     const end = parsedEnd && parsedEnd.getTime() >= start.getTime() ? parsedEnd : void 0;
-    const titleValue = options.titleSource ? readPath(record, options.titleSource) : void 0;
+    const titleValue = options.titleSource ? getAtPath(record, options.titleSource) : void 0;
     const title = (typeof titleValue === "string" || typeof titleValue === "number") && titleValue !== "" ? String(titleValue) : options.getTitle(record);
-    const colorValue = options.colorSource ? readPath(record, options.colorSource) : void 0;
+    const colorValue = options.colorSource ? getAtPath(record, options.colorSource) : void 0;
     const color = colorValue == null ? void 0 : options.colorMap?.[String(colorValue)];
     const event = { record, start, title };
     if (end) event.end = end;

package/dist/controller/client-list-controller.js

@@ -1,3 +1,4 @@
+import { getAtPath } from "../resource/get-at-path.js";
 import { createMicroStore } from "../store/micro-store.js";
 import { removeFilterPath, listParamsFromPatch } from "./list-controller.js";
 const DEFAULT_PER_PAGE = 1e3;
@@ -15,16 +16,6 @@ function removeEmpty(filter) {
   }
   return result;
 }
-function getByPath(record, path) {
-  if (record == null) return void 0;
-  if (!path.includes(".")) return record[path];
-  let current = record;
-  for (const segment of path.split(".")) {
-    if (current == null || typeof current !== "object") return void 0;
-    current = current[segment];
-  }
-  return current;
-}
 function flattenFilter(filter, prefix = "") {
   const result = {};
   for (const [key, value] of Object.entries(filter)) {
@@ -39,7 +30,7 @@ function flattenFilter(filter, prefix = "") {
 }
 function matchesFilter(record, flatFilter) {
   return Object.entries(flatFilter).every(([filterName, filterValue]) => {
-    const recordValue = getByPath(record, filterName);
+    const recordValue = getAtPath(record, filterName);
     if (Array.isArray(recordValue)) {
       return Array.isArray(filterValue) ? recordValue.some((item) => filterValue.includes(item)) : recordValue.includes(filterValue);
     }
@@ -67,8 +58,8 @@ function applyFilterAndSort(records, filter, sort, filterCallback) {
     result = [...result].sort((a, b) => {
       for (const { field, order } of keys) {
         const asc = order === "ASC";
-        const av = getByPath(a, field);
-        const bv = getByPath(b, field);
+        const av = getAtPath(a, field);
+        const bv = getAtPath(b, field);
         if (av === bv || av == null && bv == null) continue;
         if (av == null) return asc ? -1 : 1;
         if (bv == null) return asc ? 1 : -1;

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

@@ -39,6 +39,8 @@ export interface ListParamsPatch {
     page?: number;
 }
 export interface ListController<TRecord> extends MicroStore<ListControllerState<TRecord>> {
+    /** The `perPage` the list starts at when nothing is persisted or in the URL. Optional so other list controllers and fakes need not set it. */
+    readonly defaultPerPage?: number;
     setPage(page: number): void;
     setPerPage(perPage: number): void;
     /** Single payload on the SAME single-sorted field toggles order; anything else replaces. */
@@ -136,4 +138,24 @@ export declare function resetPageTarget(s: Pick<ListControllerState<unknown>, "p
  * action path and are guarded to run only on SETTLED results, so they
  * cannot ping-pong.
  */
+/**
+ * The actions of a list controller, for an adapter to spread next to its own
+ * reactive state. They are the same functions across state changes.
+ */
+export declare function listControllerActions(controller: Omit<ListController<unknown>, keyof MicroStore<ListControllerState<unknown>> | "defaultPerPage">): {
+    setPage: (page: number) => void;
+    setPerPage: (perPage: number) => void;
+    setSort: (sort: SortPayload | SortPayload[]) => void;
+    setFilters: (filter: FilterPayload, displayedFilters?: Record<string, boolean>, debounced?: boolean) => void;
+    setParams: (patch: ListParamsPatch) => void;
+    showFilter: (name: string, defaultValue?: unknown) => void;
+    hideFilter: (name: string) => void;
+    select: (ids: Identifier[]) => void;
+    toggleItem: (id: Identifier) => void;
+    unselectAll: () => void;
+    selectAll: (options?: {
+        limit?: number;
+    }) => Promise<void>;
+    refetch: () => void;
+};
 export declare function createListController<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: ListControllerContext<TResources>, resource: TName, options?: ListControllerOptions): ListController<RecordOf<TResources, TName>>;

package/dist/controller/list-controller.js

@@ -121,6 +121,22 @@ function resetPageTarget(s) {
   if (s.page > 1 && s.data !== void 0 && s.data.length === 0) return 1;
   return void 0;
 }
+function listControllerActions(controller) {
+  return {
+    setPage: controller.setPage,
+    setPerPage: controller.setPerPage,
+    setSort: controller.setSort,
+    setFilters: controller.setFilters,
+    setParams: controller.setParams,
+    showFilter: controller.showFilter,
+    hideFilter: controller.hideFilter,
+    select: controller.select,
+    toggleItem: controller.toggleItem,
+    unselectAll: controller.unselectAll,
+    selectAll: controller.selectAll,
+    refetch: controller.refetch
+  };
+}
 function createListController(ctx, resource, options = {}) {
   const storeKey = options.storeKey === false ? null : options.storeKey ?? resource;
   const paramsKey = storeKey ? `${storeKey}.listParams` : null;
@@ -377,6 +393,7 @@ function createListController(ctx, resource, options = {}) {
   }
   return {
     ...store,
+    defaultPerPage: defaults.perPage,
     setPage,
     setPerPage,
     setSort,
@@ -397,6 +414,7 @@ export {
   createErrorAnnouncer,
   createListController,
   errorMessageKey,
+  listControllerActions,
   listParamsFromPatch,
   notifyFetchError,
   notifySelectAllLimit,

package/dist/controller/record-tree.js

@@ -1,7 +1,4 @@
-const readPath = (record, path) => path.split(".").reduce(
-  (value, key) => value == null ? void 0 : value[key],
-  record
-);
+import { getAtPath } from "../resource/get-at-path.js";
 function buildRecordTree(records, parentSource) {
   const nodes = /* @__PURE__ */ new Map();
   const order = /* @__PURE__ */ new Map();
@@ -13,7 +10,7 @@ function buildRecordTree(records, parentSource) {
   }
   const parents = /* @__PURE__ */ new Map();
   for (const [id, node] of nodes) {
-    const value = readPath(node.record, parentSource);
+    const value = getAtPath(node.record, parentSource);
     const parent = value == null || value === "" ? null : String(value);
     parents.set(
       id,

package/dist/data/undoable.d.ts

@@ -1,4 +1,7 @@
 import { type QueryClient, type QueryKey } from "@tanstack/query-core";
+import type { Identifier } from "../resource/identifier.js";
+import type { ResourceRecord } from "../resource/record.js";
+import type { DeleteParams, UpdateManyParams, UpdateParams } from "./types.js";
 /**
  * A snapshot of the query cache taken BEFORE an optimistic apply: an array of
  * `[query key, data-at-that-key]` tuples. Rolling back writes each value back.
@@ -57,6 +60,53 @@ export interface UndoableHandle<TResult = unknown> {
  * `commit()` settle it. React/Vue-free — pure query-core.
  */
 export declare function startUndoableMutation<TResult = unknown>(config: UndoableMutationConfig<TResult>): UndoableHandle<TResult>;
+/**
+ * The callbacks an undoable `mutate` takes as its second argument. They are
+ * not TanStack Query's: the server call is deferred, so `onSuccess` fires with
+ * the optimistic result and `onError`/`onSettled` follow the deferred commit.
+ */
+export interface UndoableCallbacks<TData, TParams> {
+    /** Runs right after the optimistic cache change, not after the undo window. */
+    onSuccess?: (data: TData, params: TParams) => void;
+    /** Runs when the deferred commit fails, after the rollback and error notification. */
+    onError?: (error: unknown, params: TParams) => void;
+    /** Runs once the commit ends, whether it succeeded or failed. Never after an Undo. */
+    onSettled?: (params: TParams) => void;
+}
+/** What an undoable `useUpdate` hands `onSuccess`: the patched record. */
+export type UndoableUpdateCallbacks<TRecord extends ResourceRecord> = UndoableCallbacks<TRecord, UpdateParams<TRecord>>;
+/** What an undoable `useDelete` hands `onSuccess`: the previous record, when given. */
+export type UndoableDeleteCallbacks<TRecord extends ResourceRecord> = UndoableCallbacks<TRecord | undefined, DeleteParams<TRecord>>;
+/** What an undoable `useUpdateMany` hands `onSuccess`: the ids. */
+export type UndoableUpdateManyCallbacks<TRecord extends ResourceRecord> = UndoableCallbacks<Identifier[], UpdateManyParams<TRecord>>;
+/** The calls an undoable `mutate` makes for its callbacks; see {@link undoableCallbacks}. */
+export interface UndoableSettler<TData> {
+    /** Wraps the deferred `commit` so `onError` and `onSettled` run when it ends. */
+    commit<TResult>(commit: () => Promise<TResult>): () => Promise<TResult>;
+    /** Runs `onSuccess`: call it once the optimistic change is applied. */
+    success(data: TData): void;
+}
+/**
+ * Bind an undoable `mutate`'s callbacks to its `params`. The wrapped commit
+ * rethrows a failure, so the handle still rolls back and the adapter still
+ * notifies; the callbacks wait a macrotask to run after both.
+ */
+export declare function undoableCallbacks<TData, TParams>(params: TParams, callbacks?: UndoableCallbacks<TData, TParams>): UndoableSettler<TData>;
+/** What an adapter's `runUndoable` needs besides the deferred `commit`. */
+export interface UndoableCacheOptions {
+    queryKeys: QueryKey[];
+    applyOptimistic: () => void;
+    message: string;
+    messageArgs: {
+        smart_count: number;
+    };
+}
+/** Patch `ids` in the `resource` caches now; the notification reads "updated". */
+export declare function undoableUpdateOptions(queryClient: QueryClient, resource: string, ids: Identifier[], data: object): UndoableCacheOptions;
+/** Remove `ids` from the `resource` caches now; the notification reads "deleted". */
+export declare function undoableDeleteOptions(queryClient: QueryClient, resource: string, ids: Identifier[]): UndoableCacheOptions;
+/** The record an undoable update shows at once: the previous one with the patch on top. */
+export declare function patchedRecord<TRecord extends ResourceRecord>(params: UpdateParams<TRecord>): TRecord;
 /** True while at least one undoable mutation is still awaiting commit/undo. */
 export declare function hasPendingUndoables(): boolean;
 /** True while an undoable is pending or its committed server call is still in flight. */

package/dist/data/undoable.js

@@ -1,4 +1,5 @@
 import { partialMatchKey } from "@tanstack/query-core";
+import { removeRecordsFromCache, updateRecordsInCache } from "./cache-ops.js";
 const pendingUndoables = /* @__PURE__ */ new Set();
 const settledListeners = /* @__PURE__ */ new Set();
 let inFlightCommits = 0;
@@ -23,10 +24,10 @@ function keysOverlap(a, b) {
     (x) => b.some((y) => partialMatchKey(x, y) || partialMatchKey(y, x))
   );
 }
-function entriesToReplay(later, entry) {
+function entriesToReplay(later2, entry) {
   const affectedKeys = [...entry.queryKeys];
   const affected = [];
-  for (const other of later) {
+  for (const other of later2) {
     if (!keysOverlap(affectedKeys, other.queryKeys)) continue;
     affected.push(other);
     affectedKeys.push(...other.queryKeys);
@@ -59,12 +60,12 @@ function startUndoableMutation(config) {
   const rollback = () => {
     const open = order;
     const index = open.indexOf(entry);
-    const later = entriesToReplay(open.slice(index + 1), entry);
+    const later2 = entriesToReplay(open.slice(index + 1), entry);
     open.splice(index, 1);
-    for (const other of [...later].reverse())
+    for (const other of [...later2].reverse())
       restore(queryClient, other.snapshot);
     restore(queryClient, entry.snapshot);
-    for (const other of later) {
+    for (const other of later2) {
       other.snapshot = takeSnapshot(queryClient, other.queryKeys);
       other.applyOptimistic();
     }
@@ -111,6 +112,61 @@ function startUndoableMutation(config) {
   pendingUndoables.add(handle);
   return handle;
 }
+function later(run) {
+  setTimeout(() => {
+    try {
+      run();
+    } catch (error) {
+      console.error(error);
+    }
+  }, 0);
+}
+function undoableCallbacks(params, callbacks = {}) {
+  const { onSuccess, onError, onSettled } = callbacks;
+  return {
+    success: (data) => onSuccess?.(data, params),
+    // The callbacks run in a timer, never inside the commit's promise: one that
+    // throws must not read as a failed commit and roll the cache back.
+    commit: (commit) => async () => {
+      let result;
+      try {
+        result = await commit();
+      } catch (error) {
+        later(() => {
+          onError?.(error, params);
+          onSettled?.(params);
+        });
+        throw error;
+      }
+      later(() => onSettled?.(params));
+      return result;
+    }
+  };
+}
+function undoableUpdateOptions(queryClient, resource, ids, data) {
+  return {
+    queryKeys: [[resource]],
+    applyOptimistic: () => updateRecordsInCache(
+      queryClient,
+      resource,
+      ids,
+      data
+    ),
+    message: "chelone.notification.updated",
+    messageArgs: { smart_count: ids.length }
+  };
+}
+function undoableDeleteOptions(queryClient, resource, ids) {
+  return {
+    queryKeys: [[resource]],
+    applyOptimistic: () => removeRecordsFromCache(queryClient, resource, ids),
+    message: "chelone.notification.deleted",
+    messageArgs: { smart_count: ids.length }
+  };
+}
+function patchedRecord(params) {
+  return { ...params.previousData, ...params.data, id: params.id };
+}
 function hasPendingUndoables() {
   return pendingUndoables.size > 0;
 }
@@ -132,5 +188,9 @@ export {
   hasPendingUndoables,
   hasUnsettledUndoables,
   onUndoablesSettled,
-  startUndoableMutation
+  patchedRecord,
+  startUndoableMutation,
+  undoableCallbacks,
+  undoableDeleteOptions,
+  undoableUpdateOptions
 };

package/dist/form/source.d.ts

@@ -5,9 +5,10 @@
  * identical path/label composition.
  *
  * Paths follow form-core's OWN syntax: array indices use brackets
- * (`items[0].sku`), object members use dots. Labels are translation-key
- * fragments and NEVER contain indices (`items.sku`), so one catalog entry
- * covers every row.
+ * (`items[0].sku`), object members use dots. A source written the other way
+ * (`items.0.sku`) is normalized to it — see {@link normalizeSource}. Labels
+ * are translation-key fragments and NEVER contain indices (`items.sku`), so
+ * one catalog entry covers every row.
  */
 export interface SourceScope {
     /** The final field path for a child source (`''` = the scope itself). */
@@ -20,7 +21,24 @@ export interface SourceScope {
  * directly (form-core index syntax), everything else joins with a dot.
  */
 export declare function composeSource(parent: string, child: string): string;
-/** The identity scope — what a top-level form provides. */
+/**
+ * Rewrite a dot-spelled array index as form-core's bracket spelling:
+ * `tags.0.label` -> `tags[0].label`. Without it an input written with a dot
+ * index binds a field named `tags.0.label`, which no validator, error or
+ * field group matches, while the same path read as data (a `DataTable.Col`)
+ * works — form-core's `getBy`/`setBy` accept both spellings, so only the
+ * FIELD NAME differs.
+ *
+ * Only a digits-only member that FOLLOWS another member is an index: a
+ * leading numeral (`0.a`) is a field name, and bracket spellings, non-numeric
+ * members and the empty string pass through untouched. Labels never go
+ * through this — translation keys keep the spelling as written.
+ */
+export declare function normalizeSource(source: string): string;
+/**
+ * What a top-level form provides: the identity scope for everything but a
+ * dot-spelled index, which it rewrites to form-core's bracket spelling.
+ */
 export declare const rootSourceScope: SourceScope;
 /**
  * The scope an array input provides to its iterator: sources nest under the

package/dist/form/source.js

@@ -3,14 +3,43 @@ function composeSource(parent, child) {
   if (!parent) return child;
   return child.startsWith("[") ? `${parent}${child}` : `${parent}.${child}`;
 }
+function normalizeSource(source) {
+  let out = "";
+  let depth = 0;
+  let afterMember = false;
+  for (let i = 0; i < source.length; i++) {
+    const char = source[i];
+    if (char === "[") depth++;
+    if (char === "]") depth--;
+    if (char === "." && depth === 0 && afterMember) {
+      let end = i + 1;
+      while (end < source.length && source[end] !== "." && source[end] !== "[") {
+        end++;
+      }
+      const member = source.slice(i + 1, end);
+      if (/^\d+$/.test(member)) {
+        out += `[${member}]`;
+        i = end - 1;
+        continue;
+      }
+    }
+    out += char;
+    if (char !== ".") afterMember = true;
+  }
+  return out;
+}
 const rootSourceScope = {
-  getSource: (source) => source,
+  getSource: (source) => normalizeSource(source),
   getLabel: (source) => source
 };
 function createArraySourceScope(parent, arraySource) {
   const arrayPath = parent.getSource(arraySource);
   return {
-    getSource: (source) => composeSource(arrayPath, source),
+    // Normalizing the JOIN, not just the child: a child of `0` composes to
+    // `tags.0`, where the index only follows a member once the array is there.
+    // Row and locale scopes need neither — they hand the whole path to a
+    // parent that normalizes it.
+    getSource: (source) => normalizeSource(composeSource(arrayPath, source)),
     getLabel: (source) => parent.getLabel(composeSource(arraySource, source))
   };
 }
@@ -42,5 +71,6 @@ export {
   createArraySourceScope,
   createLocaleSourceScope,
   createRowSourceScope,
+  normalizeSource,
   rootSourceScope
 };

package/dist/i18n/english-messages.d.ts

@@ -0,0 +1,250 @@
+/**
+ * The English catalog an `<Admin>` with no `i18n` prop reads from, and the base
+ * an app extends: spread it, then add or override entries.
+ *
+ * The ported shadcn components translate `ra.*` keys (the react-admin namespace
+ * they were ported from): page titles, list pagination, the bulk-action bar,
+ * menu a11y labels, boolean fields. Chelone's i18n never throws on a missing key
+ * (it returns the key or a `_` fallback), so a partial catalog shows raw
+ * `ra.page.list`-style keys.
+ *
+ * Interpolation is single-brace `{name}` (not react-admin's `%{name}`). Plural
+ * strings are `{ one, other }` objects keyed by Intl.PluralRules categories
+ * (react-admin's `a |||| b` form).
+ *
+ * `defaultMessages` (the `chelone.*` keys the core controllers emit) and
+ * `mapMessages` (the maps add-on's labels) sit underneath.
+ */
+export declare const englishMessages: {
+    readonly "ra.page.list": "{name}";
+    readonly "ra.page.create": "Create {name}";
+    readonly "ra.page.edit": "{name} {recordRepresentation}";
+    readonly "ra.page.show": "{name} {recordRepresentation}";
+    readonly "ra.page.dashboard": "Dashboard";
+    readonly "ra.page.error": "Something went wrong";
+    readonly "ra.page.not_found": "Not Found";
+    readonly "ra.page.loading": "Loading";
+    readonly "ra.page.empty": "No {name} yet.";
+    readonly "ra.page.access_denied": "Access denied";
+    readonly "ra.page.authentication_error": "Authentication error";
+    readonly "ra.action.add": "Add";
+    readonly "ra.action.add_filter": "Add filter";
+    readonly "ra.action.bulk_actions": {
+        readonly one: "1 item selected";
+        readonly other: "{count} items selected";
+    };
+    readonly "ra.action.cancel": "Cancel";
+    readonly "ra.action.clear_input_value": "Clear value";
+    readonly "ra.action.clear_search": "Clear search";
+    readonly "ra.action.close": "Close";
+    readonly "ra.action.close_menu": "Close menu";
+    readonly "ra.action.confirm": "Confirm";
+    readonly "ra.action.create": "Create";
+    readonly "ra.action.delete": "Delete";
+    readonly "ra.action.edit": "Edit";
+    readonly "ra.action.export": "Export";
+    readonly "ra.action.list": "List";
+    readonly "ra.action.open_menu": "Open menu";
+    readonly "ra.action.refresh": "Refresh";
+    readonly "ra.action.remove": "Remove";
+    readonly "ra.action.remove_filter": "Remove this filter";
+    readonly "ra.action.save": "Save";
+    readonly "ra.action.search": "Search";
+    readonly "ra.action.select_all": "Select all";
+    readonly "ra.action.select_row": "Select this row";
+    readonly "ra.action.show": "Show";
+    readonly "ra.action.sort": "Sort";
+    readonly "ra.action.toggle_theme": "Toggle light/dark mode";
+    readonly "ra.action.undo": "Undo";
+    readonly "ra.action.unselect": "Unselect";
+    readonly "ra.action.update": "Update";
+    readonly "ra.boolean.true": "Yes";
+    readonly "ra.boolean.false": "No";
+    readonly "ra.boolean.null": " ";
+    readonly "ra.auth.logout": "Logout";
+    readonly "ra.auth.sign_in": "Sign in";
+    readonly "ra.auth.sign_in_error": "Authentication failed, please retry";
+    readonly "ra.auth.user_menu": "Profile";
+    readonly "ra.auth.username": "Username";
+    readonly "ra.auth.password": "Password";
+    readonly "ra.auth.auth_check_error": "Please login to continue";
+    readonly "ra.message.access_denied": "You don't have the right permissions to access this page";
+    readonly "ra.message.auth_error": "An error occurred while validating the authentication token.";
+    readonly "ra.message.authentication_error": "The authentication server returned an error and your credentials could not be checked.";
+    readonly "ra.message.error": "A client error occurred and your request couldn't be completed.";
+    readonly "ra.message.invalid_form": "The form is not valid. Please check for errors";
+    readonly "ra.message.loading": "Please wait";
+    readonly "ra.message.not_found": "Either you typed a wrong URL, or you followed a bad link.";
+    readonly "ra.navigation.next": "Go to next page";
+    readonly "ra.navigation.previous": "Go to previous page";
+    readonly "ra.navigation.first": "Go to first page";
+    readonly "ra.navigation.last": "Go to last page";
+    readonly "ra.navigation.no_results": "No results found";
+    readonly "ra.navigation.no_filtered_results": "No results found with the current filters.";
+    readonly "ra.navigation.page_range_info": "{offsetBegin}-{offsetEnd} of {total}";
+    readonly "ra.navigation.partial_page_range_info": "{offsetBegin}-{offsetEnd} of more than {offsetEnd}";
+    readonly "ra.navigation.page_rows_per_page": "Rows per page:";
+    readonly "ra.navigation.current_page": "Page {page}";
+    readonly "ra.navigation.skip_nav": "Skip to content";
+    readonly "ra.input.file.upload_several": "Drop some files to upload, or click to select one.";
+    readonly "ra.input.file.upload_single": "Drop a file to upload, or click to select it.";
+    readonly "ra.input.image.upload_several": "Drop some pictures to upload, or click to select one.";
+    readonly "ra.input.image.upload_single": "Drop a picture to upload, or click to select it.";
+    readonly "ra.input.password.toggle_visible": "Hide password";
+    readonly "ra.input.password.toggle_hidden": "Show password";
+    readonly "ra.theme.light": "Light";
+    readonly "ra.theme.dark": "Dark";
+    readonly "ra.theme.system": "System";
+    readonly "ra.validation.required": "Required";
+    readonly "ra.validation.minLength": "Must be {min} characters at least";
+    readonly "ra.validation.maxLength": "Must be {max} characters or less";
+    readonly "ra.validation.minValue": "Must be at least {min}";
+    readonly "ra.validation.maxValue": "Must be {max} or less";
+    readonly "ra.validation.number": "Must be a number";
+    readonly "ra.validation.email": "Must be a valid email";
+    readonly "ra.action.back": "Back";
+    readonly "ra.action.bulk_edit_apply": {
+        readonly one: "Apply to 1 record";
+        readonly other: "Apply to {count} records";
+    };
+    readonly "ra.action.change_locale": "Change locale";
+    readonly "ra.action.clear_array_input": "Clear the array";
+    readonly "ra.action.clone": "Clone";
+    readonly "ra.action.collapse": "Collapse";
+    readonly "ra.action.expand": "Expand";
+    readonly "ra.action.move_column_down": "Move down";
+    readonly "ra.action.move_column_up": "Move up";
+    readonly "ra.action.move_down": "Move down";
+    readonly "ra.action.move_up": "Move up";
+    readonly "ra.action.reload": "Reload";
+    readonly "ra.action.remove_all_filters": "Remove all filters";
+    readonly "ra.action.reset": "Reset";
+    readonly "ra.action.reset_columns": "Reset";
+    readonly "ra.action.search_columns": "Search columns";
+    readonly "ra.action.select_columns": "Columns";
+    readonly "ra.auth.or": "or";
+    readonly "ra.calendar.agenda": "Agenda";
+    readonly "ra.calendar.month": "Month";
+    readonly "ra.calendar.week": "Week";
+    readonly "ra.calendar.next": "Next";
+    readonly "ra.calendar.previous": "Previous";
+    readonly "ra.calendar.today": "Today";
+    readonly "ra.calendar.view": "View";
+    readonly "ra.calendar.no_events": "No events";
+    readonly "ra.csv_import.back": "Back";
+    readonly "ra.csv_import.close": "Close";
+    readonly "ra.csv_import.complete": "Import complete";
+    readonly "ra.csv_import.counts": "{created} created · {failed} failed · {total} total";
+    readonly "ra.csv_import.download_errors": "Download error report";
+    readonly "ra.csv_import.drop": "Drop a CSV file here, or click to choose one";
+    readonly "ra.csv_import.import": "Import";
+    readonly "ra.csv_import.issues": "Issues";
+    readonly "ra.csv_import.next": "Next";
+    readonly "ra.csv_import.not_utf8": "This file is not UTF-8, so some letters may be wrong. Save it as CSV UTF-8 and try again.";
+    readonly "ra.csv_import.preview_summary": "{valid} valid · {errors} errors · {total} total";
+    readonly "ra.csv_import.required_unmapped": "Required fields are not mapped";
+    readonly "ra.csv_import.rows_parsed": "{count} rows parsed";
+    readonly "ra.csv_import.step.commit": "Importing";
+    readonly "ra.csv_import.step.map": "Map columns";
+    readonly "ra.csv_import.step.preview": "Preview";
+    readonly "ra.csv_import.step.upload": "Upload";
+    readonly "ra.csv_import.unmapped": "Not mapped";
+    readonly "ra.csv_import.wrong_file": "Choose a .csv file";
+    readonly "ra.message.bulk_delete_content": {
+        readonly one: "Are you sure you want to delete this item?";
+        readonly other: "Are you sure you want to delete these {count} items?";
+    };
+    readonly "ra.message.bulk_delete_title": {
+        readonly one: "Delete 1 item";
+        readonly other: "Delete {count} items";
+    };
+    readonly "ra.message.bulk_edit_description": {
+        readonly one: "Only the fields you change are applied to the selected record.";
+        readonly other: "Only the fields you change are applied to the {count} selected records.";
+    };
+    readonly "ra.message.bulk_edit_nested_source": "Bulk edit takes flat sources only, but {source} is nested.";
+    readonly "ra.message.bulk_update_content": {
+        readonly one: "Are you sure you want to update this item?";
+        readonly other: "Are you sure you want to update these {count} items?";
+    };
+    readonly "ra.message.bulk_update_title": {
+        readonly one: "Update 1 item";
+        readonly other: "Update {count} items";
+    };
+    readonly "ra.message.clear_array_input": "Are you sure you want to clear the whole array?";
+    readonly "ra.message.delete_content": "Are you sure you want to delete this item?";
+    readonly "ra.message.delete_title": "Delete {name} {recordRepresentation}";
+    readonly "ra.navigation.clear_filters": "Clear filters";
+    readonly "ra.notification.application_update_available": "A new version of the application is available";
+    readonly "ra.notification.http_error": "Error";
+    readonly "ra.notification.offline": "You are offline";
+    readonly "ra.saved_queries.new_label": "Save current query";
+    readonly "ra.saved_queries.query_name": "Query name";
+    readonly "ra.saved_queries.remove_label_with_name": "Remove saved query \"{name}\"";
+    readonly "chelone.map.load_failed": "The map could not be loaded";
+    readonly "chelone.map.no_coordinates": "No coordinates";
+    readonly "chelone.map.no_geometry": "No geometry";
+    readonly "chelone.map.shape_not_shown": "Part of this shape cannot be shown on the map";
+    readonly "chelone.map.snap_failed": "The line could not be snapped to roads";
+    readonly "chelone.map.toolbar": "Map tools";
+    readonly "chelone.map.tool.draw_point": "Draw a point";
+    readonly "chelone.map.tool.draw_line": "Draw a line";
+    readonly "chelone.map.tool.draw_polygon": "Draw a polygon";
+    readonly "chelone.map.tool.draw_rectangle": "Draw a rectangle";
+    readonly "chelone.map.tool.draw_circle": "Draw a circle";
+    readonly "chelone.map.tool.edit": "Edit";
+    readonly "chelone.map.tool.move": "Move";
+    readonly "chelone.map.tool.delete": "Delete";
+    readonly "chelone.map.tool.cut": "Cut a hole";
+    readonly "chelone.map.search_placeholder": "Search for a place";
+    readonly "chelone.map.search_button": "Search";
+    readonly "chelone.map.searching": "Searching...";
+    readonly "chelone.map.no_results": "No results";
+    readonly "chelone.map.search_failed": "The search failed, try again shortly";
+    readonly "chelone.map.simplify.tolerance": "Tolerance: {value}";
+    readonly "chelone.map.simplify.default": "Default";
+    readonly "chelone.map.simplify.high": "High";
+    readonly "chelone.map.osm.subtract": "Subtract OpenStreetMap areas";
+    readonly "chelone.map.osm.add": "Add OpenStreetMap areas";
+    readonly "chelone.map.osm.no_sources": "No OpenStreetMap sources configured";
+    readonly "chelone.map.osm.no_polygon": "Draw a polygon first";
+    readonly "chelone.map.osm.no_match": "No matching OpenStreetMap area found";
+    readonly "chelone.map.osm.covered": "The polygon is already covered";
+    readonly "chelone.map.osm.subtracted": "Subtracted {area}";
+    readonly "chelone.map.osm.added": "Added {area}";
+    readonly "chelone.map.osm.would_split": "The result has more than one piece, so the polygon was left as it was";
+    readonly "chelone.map.osm.union_empty": "The union is empty";
+    readonly "chelone.map.osm.error": "OpenStreetMap request failed";
+    readonly "chelone.map.osm.rate_limited": "OpenStreetMap is rate limiting requests, try again shortly";
+    readonly "chelone.validation.latitude": "Must be a latitude between -90 and 90";
+    readonly "chelone.validation.longitude": "Must be a longitude between -180 and 180";
+    readonly "chelone.validation.minVertices": "Must have at least {min} vertices";
+    readonly "chelone.validation.maxVertices": "Must have {max} vertices or fewer";
+    readonly "chelone.validation.minArea": "Area {area} is below the minimum of {min}";
+    readonly "chelone.validation.selfIntersection": "Must not cross itself";
+    readonly "chelone.auth.auth_check_error": "Please login to continue";
+    readonly "chelone.auth.logout": "Logout";
+    readonly "chelone.message.access_denied": "You don't have access to this page";
+    readonly "chelone.message.authentication_error": "The authentication server returned an error";
+    readonly "chelone.message.invalid_form": "The form is not valid. Please check for errors";
+    readonly "chelone.message.loading": "The page is loading, just a moment please";
+    readonly "chelone.message.not_found": "Either you typed a wrong URL, or you followed a bad link.";
+    readonly "chelone.message.select_all_limit_reached": "There are too many elements to select them all. Only the first {max} elements were selected";
+    readonly "chelone.message.unsaved_changes": "Some of your changes weren't saved. Are you sure you want to ignore them?";
+    readonly "chelone.notification.created": "Element created";
+    readonly "chelone.notification.deleted": "Element deleted";
+    readonly "chelone.notification.http_error": "Server communication error";
+    readonly "chelone.notification.item_doesnt_exist": "Element does not exist";
+    readonly "chelone.notification.logged_out": "Your session has ended, please reconnect";
+    readonly "chelone.notification.not_authorized": "You are not authorized to access this resource";
+    readonly "chelone.notification.updated": "Element updated";
+    readonly "chelone.validation.email": "Must be a valid email";
+    readonly "chelone.validation.maxLength": "Must be {max} characters or less";
+    readonly "chelone.validation.maxValue": "Must be {max} or less";
+    readonly "chelone.validation.minLength": "Must be {min} characters at least";
+    readonly "chelone.validation.minValue": "Must be at least {min}";
+    readonly "chelone.validation.number": "Must be a number";
+    readonly "chelone.validation.oneOf": "Must be one of: {options}";
+    readonly "chelone.validation.regex": "Must match a specific format (regexp): {pattern}";
+    readonly "chelone.validation.required": "Required";
+};

package/dist/i18n/english-messages.js

@@ -0,0 +1,193 @@
+import { mapMessages } from "../geo/messages.js";
+import { defaultMessages } from "./default-messages.js";
+import { defineMessages } from "./messages.js";
+const englishMessages = defineMessages({
+  ...defaultMessages,
+  ...mapMessages,
+  // Pages
+  "ra.page.list": "{name}",
+  "ra.page.create": "Create {name}",
+  "ra.page.edit": "{name} {recordRepresentation}",
+  "ra.page.show": "{name} {recordRepresentation}",
+  "ra.page.dashboard": "Dashboard",
+  "ra.page.error": "Something went wrong",
+  "ra.page.not_found": "Not Found",
+  "ra.page.loading": "Loading",
+  "ra.page.empty": "No {name} yet.",
+  "ra.page.access_denied": "Access denied",
+  "ra.page.authentication_error": "Authentication error",
+  // Actions
+  "ra.action.add": "Add",
+  "ra.action.add_filter": "Add filter",
+  "ra.action.bulk_actions": {
+    one: "1 item selected",
+    other: "{count} items selected"
+  },
+  "ra.action.cancel": "Cancel",
+  "ra.action.clear_input_value": "Clear value",
+  "ra.action.clear_search": "Clear search",
+  "ra.action.close": "Close",
+  "ra.action.close_menu": "Close menu",
+  "ra.action.confirm": "Confirm",
+  "ra.action.create": "Create",
+  "ra.action.delete": "Delete",
+  "ra.action.edit": "Edit",
+  "ra.action.export": "Export",
+  "ra.action.list": "List",
+  "ra.action.open_menu": "Open menu",
+  "ra.action.refresh": "Refresh",
+  "ra.action.remove": "Remove",
+  "ra.action.remove_filter": "Remove this filter",
+  "ra.action.save": "Save",
+  "ra.action.search": "Search",
+  "ra.action.select_all": "Select all",
+  "ra.action.select_row": "Select this row",
+  "ra.action.show": "Show",
+  "ra.action.sort": "Sort",
+  "ra.action.toggle_theme": "Toggle light/dark mode",
+  "ra.action.undo": "Undo",
+  "ra.action.unselect": "Unselect",
+  "ra.action.update": "Update",
+  // Booleans
+  "ra.boolean.true": "Yes",
+  "ra.boolean.false": "No",
+  "ra.boolean.null": " ",
+  // Auth
+  "ra.auth.logout": "Logout",
+  "ra.auth.sign_in": "Sign in",
+  "ra.auth.sign_in_error": "Authentication failed, please retry",
+  "ra.auth.user_menu": "Profile",
+  "ra.auth.username": "Username",
+  "ra.auth.password": "Password",
+  "ra.auth.auth_check_error": "Please login to continue",
+  // Messages
+  "ra.message.access_denied": "You don't have the right permissions to access this page",
+  "ra.message.auth_error": "An error occurred while validating the authentication token.",
+  "ra.message.authentication_error": "The authentication server returned an error and your credentials could not be checked.",
+  "ra.message.error": "A client error occurred and your request couldn't be completed.",
+  "ra.message.invalid_form": "The form is not valid. Please check for errors",
+  "ra.message.loading": "Please wait",
+  "ra.message.not_found": "Either you typed a wrong URL, or you followed a bad link.",
+  // Navigation / pagination
+  "ra.navigation.next": "Go to next page",
+  "ra.navigation.previous": "Go to previous page",
+  "ra.navigation.first": "Go to first page",
+  "ra.navigation.last": "Go to last page",
+  // No `{name}`: the list and input call sites pass no params for these.
+  "ra.navigation.no_results": "No results found",
+  "ra.navigation.no_filtered_results": "No results found with the current filters.",
+  "ra.navigation.page_range_info": "{offsetBegin}-{offsetEnd} of {total}",
+  "ra.navigation.partial_page_range_info": "{offsetBegin}-{offsetEnd} of more than {offsetEnd}",
+  "ra.navigation.page_rows_per_page": "Rows per page:",
+  "ra.navigation.current_page": "Page {page}",
+  "ra.navigation.skip_nav": "Skip to content",
+  // Inputs
+  "ra.input.file.upload_several": "Drop some files to upload, or click to select one.",
+  "ra.input.file.upload_single": "Drop a file to upload, or click to select it.",
+  "ra.input.image.upload_several": "Drop some pictures to upload, or click to select one.",
+  "ra.input.image.upload_single": "Drop a picture to upload, or click to select it.",
+  "ra.input.password.toggle_visible": "Hide password",
+  "ra.input.password.toggle_hidden": "Show password",
+  // Theme
+  "ra.theme.light": "Light",
+  "ra.theme.dark": "Dark",
+  "ra.theme.system": "System",
+  // Validation (ra namespace — some ported inputs read these)
+  "ra.validation.required": "Required",
+  "ra.validation.minLength": "Must be {min} characters at least",
+  "ra.validation.maxLength": "Must be {max} characters or less",
+  "ra.validation.minValue": "Must be at least {min}",
+  "ra.validation.maxValue": "Must be {max} or less",
+  "ra.validation.number": "Must be a number",
+  "ra.validation.email": "Must be a valid email",
+  // Actions the components translate beyond the base set
+  "ra.action.back": "Back",
+  "ra.action.bulk_edit_apply": {
+    one: "Apply to 1 record",
+    other: "Apply to {count} records"
+  },
+  "ra.action.change_locale": "Change locale",
+  "ra.action.clear_array_input": "Clear the array",
+  "ra.action.clone": "Clone",
+  "ra.action.collapse": "Collapse",
+  "ra.action.expand": "Expand",
+  "ra.action.move_column_down": "Move down",
+  "ra.action.move_column_up": "Move up",
+  "ra.action.move_down": "Move down",
+  "ra.action.move_up": "Move up",
+  "ra.action.reload": "Reload",
+  "ra.action.remove_all_filters": "Remove all filters",
+  "ra.action.reset": "Reset",
+  "ra.action.reset_columns": "Reset",
+  "ra.action.search_columns": "Search columns",
+  "ra.action.select_columns": "Columns",
+  // Auth
+  "ra.auth.or": "or",
+  // Calendar
+  "ra.calendar.agenda": "Agenda",
+  "ra.calendar.month": "Month",
+  "ra.calendar.week": "Week",
+  "ra.calendar.next": "Next",
+  "ra.calendar.previous": "Previous",
+  "ra.calendar.today": "Today",
+  "ra.calendar.view": "View",
+  "ra.calendar.no_events": "No events",
+  // CSV import
+  "ra.csv_import.back": "Back",
+  "ra.csv_import.close": "Close",
+  "ra.csv_import.complete": "Import complete",
+  "ra.csv_import.counts": "{created} created · {failed} failed · {total} total",
+  "ra.csv_import.download_errors": "Download error report",
+  "ra.csv_import.drop": "Drop a CSV file here, or click to choose one",
+  "ra.csv_import.import": "Import",
+  "ra.csv_import.issues": "Issues",
+  "ra.csv_import.next": "Next",
+  "ra.csv_import.not_utf8": "This file is not UTF-8, so some letters may be wrong. Save it as CSV UTF-8 and try again.",
+  "ra.csv_import.preview_summary": "{valid} valid · {errors} errors · {total} total",
+  "ra.csv_import.required_unmapped": "Required fields are not mapped",
+  "ra.csv_import.rows_parsed": "{count} rows parsed",
+  "ra.csv_import.step.commit": "Importing",
+  "ra.csv_import.step.map": "Map columns",
+  "ra.csv_import.step.preview": "Preview",
+  "ra.csv_import.step.upload": "Upload",
+  "ra.csv_import.unmapped": "Not mapped",
+  "ra.csv_import.wrong_file": "Choose a .csv file",
+  // Confirmation dialogs and other messages
+  "ra.message.bulk_delete_content": {
+    one: "Are you sure you want to delete this item?",
+    other: "Are you sure you want to delete these {count} items?"
+  },
+  "ra.message.bulk_delete_title": {
+    one: "Delete 1 item",
+    other: "Delete {count} items"
+  },
+  "ra.message.bulk_edit_description": {
+    one: "Only the fields you change are applied to the selected record.",
+    other: "Only the fields you change are applied to the {count} selected records."
+  },
+  "ra.message.bulk_edit_nested_source": "Bulk edit takes flat sources only, but {source} is nested.",
+  "ra.message.bulk_update_content": {
+    one: "Are you sure you want to update this item?",
+    other: "Are you sure you want to update these {count} items?"
+  },
+  "ra.message.bulk_update_title": {
+    one: "Update 1 item",
+    other: "Update {count} items"
+  },
+  "ra.message.clear_array_input": "Are you sure you want to clear the whole array?",
+  "ra.message.delete_content": "Are you sure you want to delete this item?",
+  "ra.message.delete_title": "Delete {name} {recordRepresentation}",
+  // More navigation
+  "ra.navigation.clear_filters": "Clear filters",
+  // Notifications
+  "ra.notification.application_update_available": "A new version of the application is available",
+  "ra.notification.http_error": "Error",
+  "ra.notification.offline": "You are offline",
+  // Saved queries
+  "ra.saved_queries.new_label": "Save current query",
+  "ra.saved_queries.query_name": "Query name",
+  "ra.saved_queries.remove_label_with_name": 'Remove saved query "{name}"'
+});
+export {
+  englishMessages
+};

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export { isFilterSelected, toggleFilterValue, } from "./controller/filter-toggle
 export type { InfiniteListController, InfiniteListControllerState, } from "./controller/infinite-list-controller.js";
 export { createInfiniteListController } from "./controller/infinite-list-controller.js";
 export type { ListController, ListControllerContext, ListControllerOptions, ListControllerState, ListParamsPatch, } from "./controller/list-controller.js";
-export { createListController } from "./controller/list-controller.js";
+export { createListController, listControllerActions, } from "./controller/list-controller.js";
 export type { ListParamsQuery, ListUrlState, } from "./controller/list-params.js";
 export { hasCustomParams, listPatchFromSearch, parseListParams, serializeListParams, serializeListState, } from "./controller/list-params.js";
 export type { PrevNextOptions, PrevNextPage, PrevNextParams, PrevNextResolution, PrevNextStoredParams, } from "./controller/prev-next.js";
@@ -61,8 +61,8 @@ export { createMutationOptions, deleteMutationOptions, updateMutationOptions, }
 export type { DataContext } from "./data/query-options.js";
 export { getInfiniteListOptions, getListOptions, getManyOptions, getManyReferenceOptions, getOneOptions, } from "./data/query-options.js";
 export type { CreateParams, CreateResult, CursorPagination, DataProvider, DeleteManyParams, DeleteManyResult, DeleteParams, DeleteResult, FilterPayload, GetListParams, GetListResult, GetManyParams, GetManyReferenceParams, GetManyReferenceResult, GetManyResult, GetOneParams, GetOneResult, InfiniteListParams, PageInfo, PagePagination, Pagination, SortPayload, UpdateManyParams, UpdateManyResult, UpdateParams, UpdateResult, } from "./data/types.js";
-export type { UndoableHandle, UndoableMutationConfig, UndoableSnapshot, } from "./data/undoable.js";
-export { commitAllUndoables, hasPendingUndoables, startUndoableMutation, } from "./data/undoable.js";
+export type { UndoableCacheOptions, UndoableCallbacks, UndoableDeleteCallbacks, UndoableHandle, UndoableMutationConfig, UndoableSettler, UndoableSnapshot, UndoableUpdateCallbacks, UndoableUpdateManyCallbacks, } from "./data/undoable.js";
+export { commitAllUndoables, hasPendingUndoables, patchedRecord, startUndoableMutation, undoableCallbacks, undoableDeleteOptions, undoableUpdateOptions, } from "./data/undoable.js";
 export type { LifecycleCallbacks, LifecycleHandler, } from "./data/with-lifecycle-callbacks.js";
 export { withLifecycleCallbacks } from "./data/with-lifecycle-callbacks.js";
 export type { ApplicationUpdateSnapshot, ApplicationUpdateStoreOptions, } from "./environment/application-update-store.js";
@@ -118,6 +118,7 @@ export { featuresToShape, heldFeatures, shapeToFeatures, } from "./geo/shape-val
 export type { OsrmProviderOptions, RoutingProvider } from "./geo/snap-to-roads.js";
 export { createOsrmProvider } from "./geo/snap-to-roads.js";
 export { defaultMessages } from "./i18n/default-messages.js";
+export { englishMessages } from "./i18n/english-messages.js";
 export type { AnyCheloneI18n, CheloneI18n } from "./i18n/i18n.js";
 export { createI18n } from "./i18n/i18n.js";
 export type { ExtractParams, MessageCatalog, MessageKey, MessageValue, PluralMessage, TranslateParams, } from "./i18n/messages.js";
@@ -150,12 +151,15 @@ export type { SubscribeUnreadCountOptions } from "./realtime/unread-count.js";
 export { clearUnread, subscribeUnreadCount, unreadKey, } from "./realtime/unread-count.js";
 export type { FieldComponentName, FieldDescriptor, FieldKind, InputComponentName, ResourceDescriptor, } from "./resource/describe-resource.js";
 export { describeResource } from "./resource/describe-resource.js";
+export { getAtPath } from "./resource/get-at-path.js";
 export type { Identifier } from "./resource/identifier.js";
 export type { LooseRecord, ResourceRecord } from "./resource/record.js";
+export type { Register, RegisteredRecord, RegisteredResourceName, RegisteredResources, } from "./resource/register.js";
 export type { RecordOf, ResourceConfig, ResourceMap, } from "./resource/registry.js";
 export { defineResources } from "./resource/registry.js";
 export type { ComputeDefinitionProps, ResourceDefinition, ResourceDefinitionMap, ResourceRegistry, ResourceRegistryListener, } from "./resource/registry-store.js";
 export { computeDefinition, createResourceRegistry, } from "./resource/registry-store.js";
+export type { AnySourcePath, AnySourcePathOf, FilterSourceKey, RowSourcePath, SourceKey, SourcePath, SourceProp, SourceValue, } from "./resource/source-path.js";
 export type { CheloneLocation, NavigateOpts } from "./router/location.js";
 export { parseLocation } from "./router/location.js";
 export type { PathMatch } from "./router/match.js";

package/dist/index.js

@@ -10,7 +10,7 @@ import { createClientListController } from "./controller/client-list-controller.
 import { arrangeColumns, columnLabelMatches, dataTableColumnKeys, defaultDataTableStoreKey, getDataTableColumnId, moveColumn, toggleHiddenColumn } from "./controller/data-table-columns.js";
 import { isFilterSelected, toggleFilterValue } from "./controller/filter-toggle.js";
 import { createInfiniteListController } from "./controller/infinite-list-controller.js";
-import { createListController } from "./controller/list-controller.js";
+import { createListController, listControllerActions } from "./controller/list-controller.js";
 import { hasCustomParams, listPatchFromSearch, parseListParams, serializeListParams, serializeListState } from "./controller/list-params.js";
 import { canUseCachedPage, getPrevNextParams, resolvePrevNext } from "./controller/prev-next.js";
 import { createCreateController, createDeleteController, createEditController, createShowController } from "./controller/record-controllers.js";
@@ -36,7 +36,7 @@ import { HttpError } from "./data/http-error.js";
 import { infiniteListKey, listKey, lockKey, locksKey, manyKey, manyReferenceKey, oneKey, resourceKey } from "./data/keys.js";
 import { createMutationOptions, deleteMutationOptions, updateMutationOptions } from "./data/mutation-options.js";
 import { getInfiniteListOptions, getListOptions, getManyOptions, getManyReferenceOptions, getOneOptions } from "./data/query-options.js";
-import { commitAllUndoables, hasPendingUndoables, startUndoableMutation } from "./data/undoable.js";
+import { commitAllUndoables, hasPendingUndoables, patchedRecord, startUndoableMutation, undoableCallbacks, undoableDeleteOptions, undoableUpdateOptions } from "./data/undoable.js";
 import { withLifecycleCallbacks } from "./data/with-lifecycle-callbacks.js";
 import { createApplicationUpdateStore } from "./environment/application-update-store.js";
 import { createOfflineStore } from "./environment/offline-store.js";
@@ -69,6 +69,7 @@ import { OverpassError, OverpassRateLimitError, OverpassTimeoutError, createOver
 import { featuresToShape, heldFeatures, shapeToFeatures } from "./geo/shape-value.js";
 import { createOsrmProvider } from "./geo/snap-to-roads.js";
 import { defaultMessages } from "./i18n/default-messages.js";
+import { englishMessages } from "./i18n/english-messages.js";
 import { createI18n } from "./i18n/i18n.js";
 import { defineMessages } from "./i18n/messages.js";
 import { createTranslatableController, getRecordForLocale } from "./i18n/translatable.js";
@@ -87,6 +88,7 @@ import { lockResourceTopic, lockTopic, presenceTopic, recordTopic, resourceTopic
 import { LockConflictError } from "./realtime/types.js";
 import { clearUnread, subscribeUnreadCount, unreadKey } from "./realtime/unread-count.js";
 import { describeResource } from "./resource/describe-resource.js";
+import { getAtPath } from "./resource/get-at-path.js";
 import { defineResources } from "./resource/registry.js";
 import { computeDefinition, createResourceRegistry } from "./resource/registry-store.js";
 import { parseLocation } from "./router/location.js";
@@ -191,6 +193,7 @@ export {
   downloadCSV,
   editorStyles,
   email,
+  englishMessages,
   expandTileUrl,
   extractValidSavedQueries,
   fakeDataProvider,
@@ -206,6 +209,7 @@ export {
   geocodeQueryOptions,
   getAllowedTransitions,
   getApprovalState,
+  getAtPath,
   getDataTableColumnId,
   getDirtyFormValues,
   getFilterFormValues,
@@ -246,6 +250,7 @@ export {
   joinBasename,
   latLngToLngLat,
   latitude,
+  listControllerActions,
   listKey,
   listPatchFromSearch,
   lngLatToLatLng,
@@ -283,6 +288,7 @@ export {
   parseCsvWith,
   parseListParams,
   parseLocation,
+  patchedRecord,
   permissionsQueryOptions,
   polygonToBBox,
   presenceTopic,
@@ -330,6 +336,9 @@ export {
   toPresenceUser,
   toggleFilterValue,
   toggleHiddenColumn,
+  undoableCallbacks,
+  undoableDeleteOptions,
+  undoableUpdateOptions,
   unreadKey,
   updateMutationOptions,
   updateRecordsInCache,

package/dist/resource/get-at-path.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The one path grammar chelone reads a record with. Dot members (`a.b`),
+ * bracket indices (`a[0].b`) and numeric-dot indices (`a.0.b`) all resolve to
+ * the same value, matching `lodash/get`'s relevant semantics.
+ *
+ * The core tree, calendar and client-list readers read through this, so a
+ * `source` written one way reads the same record everywhere. The adapters'
+ * `useFieldValue` reads the same grammar and moves onto this helper next.
+ */
+/**
+ * Read the value at `source` off `record`. An empty `source` returns the record
+ * itself; a step that is null, undefined or a primitive returns `undefined`.
+ *
+ * An own key equal to the whole `source` wins before any split, as in
+ * `lodash/get`: a record that literally holds a `"nested.level"` key — a
+ * flattened filter payload, for instance — still reads.
+ */
+export declare function getAtPath(record: unknown, source: string): unknown;

package/dist/resource/get-at-path.js

@@ -0,0 +1,23 @@
+const PATH_SEGMENT = /\[([^\]]*)\]|[^.[\]]+/g;
+const toPathSegments = (source) => {
+  const segments = [];
+  for (const match of source.matchAll(PATH_SEGMENT)) {
+    segments.push(match[1] !== void 0 ? match[1] : match[0]);
+  }
+  return segments;
+};
+function getAtPath(record, source) {
+  if (source === "") return record;
+  if (record !== null && typeof record === "object" && Object.hasOwn(record, source)) {
+    return record[source];
+  }
+  let current = record;
+  for (const key of toPathSegments(source)) {
+    if (current === null || typeof current !== "object") return void 0;
+    current = current[key];
+  }
+  return current;
+}
+export {
+  getAtPath
+};

package/dist/resource/register.d.ts

@@ -0,0 +1,26 @@
+import type { RecordOf, ResourceMap } from "./registry.js";
+/**
+ * The app's augmentation point: the one place a Chelone program tells core
+ * which resources it has, so `source` props can be typed against a registered
+ * resource's record instead of a plain `string`.
+ *
+ * ```ts
+ * const resources = defineResources({ posts: { schema: postSchema } });
+ * declare module "@chelone/core" {
+ *   interface Register { resources: typeof resources }
+ * }
+ * ```
+ *
+ * Augmenting `Register` is global to a TypeScript program. Without it every
+ * `Registered*` type below resolves to its loose fallback and nothing breaks.
+ */
+export interface Register {
+}
+/** The registered resource map, or {@link ResourceMap} when nothing is registered. */
+export type RegisteredResources = Register extends {
+    resources: infer TResources extends ResourceMap;
+} ? TResources : ResourceMap;
+/** The registered resource names, or `string` when nothing is registered. */
+export type RegisteredResourceName = keyof RegisteredResources & string;
+/** The record type of a registered resource, or {@link LooseRecord} when it has no schema. */
+export type RegisteredRecord<TName extends RegisteredResourceName> = RecordOf<RegisteredResources, TName>;

package/dist/resource/source-path.d.ts

@@ -0,0 +1,114 @@
+import type { Get, Paths } from "dot.paths";
+import type { LooseRecord } from "./record.js";
+import type { RegisteredResources } from "./register.js";
+import type { RecordOf, ResourceMap } from "./registry.js";
+/**
+ * Source-path types for a registered resource's record.
+ *
+ * Every path prop in Chelone is composed at runtime (`source.ts`,
+ * `input-binding.ts`); these types say which paths are legal for a given
+ * record, so `<TextInput source="titel" />` stops compiling once an app
+ * registers its resources. They are built on `dot.paths`' `Paths` and `Get`,
+ * and accept the bracket grammar only (`tags[0].label`) — the syntax
+ * `composeSource` and form-core's `DeepKeys` use. A dot index
+ * (`tags.0.label`) still works at runtime but is not a legal prop type.
+ */
+/** Object levels walked while looking for arrays in a record. */
+type _WalkDepth = 8;
+/** How deep `RowSourcePath` follows nested arrays. */
+type _MaxArrayNesting = 3;
+/** Decrement tables for the two counters above (`_Prev[N]` is `N - 1`). */
+type _PrevWalk = [never, 0, 1, 2, 3, 4, 5, 6, 7];
+type _PrevNesting = [never, 0, 1, 2];
+/**
+ * The item type of every array reachable in `T`. Object members are walked up
+ * to `_WalkDepth` levels; array nesting up to `_MaxArrayNesting`, so a
+ * recursive record type terminates and the resulting path union stays small.
+ *
+ * The union is walked one member at a time (`T extends unknown` distributes,
+ * and object members are walked per key) because `any` absorbs a union: walked
+ * as one type, a single `any`-typed field would turn every array in the record
+ * into `any`.
+ */
+type _ArrayItems<T, Walk extends number, Nesting extends number> = [
+    Walk
+] extends [0] ? never : [Nesting] extends [0] ? never : T extends unknown ? _ItemsOf<T, Walk, Nesting> : never;
+type _ItemsOf<T, Walk extends number, Nesting extends number> = 0 extends 1 & T ? never : T extends readonly unknown[] ? T extends readonly [] ? never : _Row<NonNullable<T[number]>> | _ArrayItems<NonNullable<T[number]>, _PrevWalk[Walk], _PrevNesting[Nesting]> : T extends object ? {
+    [K in keyof T]: _ArrayItems<T[K], _PrevWalk[Walk], Nesting>;
+}[keyof T] : never;
+/**
+ * The item type of an array, minus `any` (it names no key set) and minus any
+ * member that is itself an array: a row that is an array has no named path
+ * under it, and `Paths` of it is a wall of `[${number}]` patterns.
+ */
+type _Row<T> = Exclude<0 extends 1 & T ? never : T, readonly unknown[]>;
+/**
+ * Every legal `source` path into `TRecord`: dotted object paths and bracket
+ * array indices (`items[0].sku`).
+ *
+ * The `unknown` guard is load-bearing: `Paths<unknown>` is `never`, which would
+ * reject every source of a resource with no schema, while
+ * `Paths<LooseRecord, { arrays: "bracket" }>` is `string`.
+ */
+export type SourcePath<TRecord> = unknown extends TRecord ? string : Paths<TRecord, {
+    arrays: "bracket";
+}>;
+/**
+ * The value type at `TPath`, including the `null`/`undefined` of every parent
+ * along it — what reading `record.author?.name` gives. `unknown` for a loose
+ * record.
+ */
+export type SourceValue<TRecord, TPath extends string> = unknown extends TRecord ? unknown : Get<TRecord, TPath, {
+    nullish: "path";
+}>;
+/**
+ * The top-level keys of `TRecord`, for props that read or write one flat key
+ * (a filter's field, a reference's target). `string` for a loose record.
+ */
+export type SourceKey<TRecord> = unknown extends TRecord ? string : keyof TRecord & string;
+/**
+ * The paths *relative to an array item* of every array in `TRecord`: `sku` is
+ * one for a record with `items: { sku: string }[]`.
+ *
+ * Children of an `ArrayInput` bind a path relative to their row
+ * (`createRowSourceScope`), so a root-only path type would reject every
+ * iterator child.
+ *
+ * A row whose type names no keys contributes nothing, and it is filtered per
+ * member so it cannot poison the rest: a `z.record` column, a jsonb `Json`
+ * member and a `z.any()` field all give `Paths` = `string`, and one `string`
+ * here would swallow every other array's paths and let every typo through
+ * again. A record that wants its jsonb rows checked gives them a schema.
+ */
+export type RowSourcePath<TRecord> = unknown extends TRecord ? string : string extends keyof TRecord ? string : _ArrayItems<TRecord, _WalkDepth, _MaxArrayNesting> extends infer TItem ? TItem extends unknown ? Paths<TItem, {
+    arrays: "bracket";
+}> extends infer TPath extends string ? string extends TPath ? never : TPath : never : never : never;
+/**
+ * A filter key: the free-text `q`, or a source path with an operator suffix —
+ * the keys Chelone writes itself (`calendarRangeFilter` builds
+ * `` `${startSource}_gte` ``) and a filter input's `source` is named with.
+ */
+export type FilterSourceKey<TRecord> = "q" | `${SourcePath<TRecord>}_${string}`;
+/** The source props one record accepts: its paths, its row paths, its filter keys. */
+type _RecordSourcePath<TRecord> = SourcePath<TRecord> | RowSourcePath<TRecord> | FilterSourceKey<TRecord>;
+/**
+ * The union of every registered resource's source paths.
+ *
+ * `string` when the name set is `string` — the unregistered case, and the one
+ * that keeps `AnySourcePath` from recursing on itself through
+ * {@link SourceProp} — and `string` when any resource has no schema.
+ */
+export type AnySourcePathOf<TResources extends ResourceMap> = string extends keyof TResources ? string : {
+    [TName in keyof TResources & string]: _RecordSourcePath<RecordOf<TResources, TName>>;
+}[keyof TResources & string];
+/** {@link AnySourcePathOf} over the app's registered resources. */
+export type AnySourcePath = AnySourcePathOf<RegisteredResources>;
+/**
+ * The type a `source` prop takes.
+ *
+ * A loose record (the default, and every app that registers nothing) gets
+ * {@link AnySourcePath}, which is `string` until `Register` is augmented; a
+ * typed record gets its own paths.
+ */
+export type SourceProp<TRecord = LooseRecord> = LooseRecord extends TRecord ? AnySourcePath : _RecordSourcePath<TRecord>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/core",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -43,6 +43,9 @@
     "vitest": "^3.0.0",
     "zod": "^3.25.0"
   },
+  "dependencies": {
+    "dot.paths": "^0.2.0"
+  },
   "scripts": {
     "build": "vite build && tsc -p tsconfig.build.json && node ../../scripts/dts-extensions.mjs dist",
     "check:pack": "publint --pack pnpm --strict && d=$(mktemp -d) && trap 'rm -rf $d' EXIT && pnpm pack --pack-destination $d && attw $d/*.tgz --profile esm-only",