@chelone/core 0.10.0 → 0.11.0

package/dist/i18n/english-messages.js

@@ -6,187 +6,182 @@ import { defineMessages } from "./messages.js";
 * 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.
+* Every key is `chelone.<group>.<leaf>`: the ported shadcn components used to
+* translate the react-admin `ra.*` keys they were ported from, and those keys
+* were moved under `chelone.*` with their group names kept (`page`, `action`,
+* `navigation`). Chelone's i18n never throws on a missing key (it returns the
+* key or a `_` fallback), so a partial catalog shows raw
+* `chelone.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.
+* `mapMessages` (the maps add-on's labels) sit underneath, and no entry here
+* repeats one of them. Where a moved key landed on a controller key that says
+* something different, the component's own key keeps the group and names the
+* role: `access_denied_detail`, `authentication_error_detail`,
+* `loading_detail` and `http_error_label` sit beside the controller's
+* `access_denied`, `authentication_error`, `loading` and `http_error`.
 */
 var englishMessages = defineMessages({
 	...defaultMessages,
 	...mapMessages,
-	"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",
-	"ra.action.add": "Add",
-	"ra.action.add_filter": "Add filter",
-	"ra.action.bulk_actions": {
+	"chelone.page.list": "{name}",
+	"chelone.page.create": "Create {name}",
+	"chelone.page.edit": "{name} {recordRepresentation}",
+	"chelone.page.show": "{name} {recordRepresentation}",
+	"chelone.page.dashboard": "Dashboard",
+	"chelone.page.error": "Something went wrong",
+	"chelone.page.not_found": "Not Found",
+	"chelone.page.loading": "Loading",
+	"chelone.page.empty": "No {name} yet.",
+	"chelone.page.access_denied": "Access denied",
+	"chelone.page.authentication_error": "Authentication error",
+	"chelone.action.add": "Add",
+	"chelone.action.add_filter": "Add filter",
+	"chelone.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",
-	"ra.boolean.true": "Yes",
-	"ra.boolean.false": "No",
-	"ra.boolean.null": " ",
-	"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",
-	"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.",
-	"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",
-	"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",
-	"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",
-	"ra.theme.light": "Light",
-	"ra.theme.dark": "Dark",
-	"ra.theme.system": "System",
-	"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",
-	"ra.action.back": "Back",
-	"ra.action.bulk_edit_apply": {
+	"chelone.action.cancel": "Cancel",
+	"chelone.action.clear_input_value": "Clear value",
+	"chelone.action.clear_search": "Clear search",
+	"chelone.action.close": "Close",
+	"chelone.action.close_menu": "Close menu",
+	"chelone.action.confirm": "Confirm",
+	"chelone.action.create": "Create",
+	"chelone.action.delete": "Delete",
+	"chelone.action.edit": "Edit",
+	"chelone.action.export": "Export",
+	"chelone.action.list": "List",
+	"chelone.action.open_menu": "Open menu",
+	"chelone.action.refresh": "Refresh",
+	"chelone.action.remove": "Remove",
+	"chelone.action.remove_filter": "Remove this filter",
+	"chelone.action.save": "Save",
+	"chelone.action.search": "Search",
+	"chelone.action.select_all": "Select all",
+	"chelone.action.select_row": "Select this row",
+	"chelone.action.show": "Show",
+	"chelone.action.sort": "Sort",
+	"chelone.action.toggle_theme": "Toggle light/dark mode",
+	"chelone.action.undo": "Undo",
+	"chelone.action.unselect": "Unselect",
+	"chelone.action.update": "Update",
+	"chelone.boolean.true": "Yes",
+	"chelone.boolean.false": "No",
+	"chelone.boolean.null": " ",
+	"chelone.auth.sign_in": "Sign in",
+	"chelone.auth.sign_in_error": "Authentication failed, please retry",
+	"chelone.auth.user_menu": "Profile",
+	"chelone.auth.username": "Username",
+	"chelone.auth.password": "Password",
+	"chelone.message.access_denied_detail": "You don't have the right permissions to access this page",
+	"chelone.message.auth_error": "An error occurred while validating the authentication token.",
+	"chelone.message.authentication_error_detail": "The authentication server returned an error and your credentials could not be checked.",
+	"chelone.message.error": "A client error occurred and your request couldn't be completed.",
+	"chelone.message.loading_detail": "Please wait",
+	"chelone.navigation.next": "Go to next page",
+	"chelone.navigation.previous": "Go to previous page",
+	"chelone.navigation.first": "Go to first page",
+	"chelone.navigation.last": "Go to last page",
+	"chelone.navigation.no_results": "No results found",
+	"chelone.navigation.no_filtered_results": "No results found with the current filters.",
+	"chelone.navigation.page_range_info": "{offsetBegin}-{offsetEnd} of {total}",
+	"chelone.navigation.partial_page_range_info": "{offsetBegin}-{offsetEnd} of more than {offsetEnd}",
+	"chelone.navigation.page_rows_per_page": "Rows per page:",
+	"chelone.navigation.current_page": "Page {page}",
+	"chelone.navigation.skip_nav": "Skip to content",
+	"chelone.input.file.upload_several": "Drop some files to upload, or click to select one.",
+	"chelone.input.file.upload_single": "Drop a file to upload, or click to select it.",
+	"chelone.input.image.upload_several": "Drop some pictures to upload, or click to select one.",
+	"chelone.input.image.upload_single": "Drop a picture to upload, or click to select it.",
+	"chelone.input.password.toggle_visible": "Hide password",
+	"chelone.input.password.toggle_hidden": "Show password",
+	"chelone.theme.light": "Light",
+	"chelone.theme.dark": "Dark",
+	"chelone.theme.system": "System",
+	"chelone.action.back": "Back",
+	"chelone.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",
-	"ra.auth.or": "or",
-	"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",
-	"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",
-	"ra.message.bulk_delete_content": {
+	"chelone.action.change_locale": "Change locale",
+	"chelone.action.clear_array_input": "Clear the array",
+	"chelone.action.clone": "Clone",
+	"chelone.action.collapse": "Collapse",
+	"chelone.action.expand": "Expand",
+	"chelone.action.move_column_down": "Move down",
+	"chelone.action.move_column_up": "Move up",
+	"chelone.action.move_down": "Move down",
+	"chelone.action.move_up": "Move up",
+	"chelone.action.reload": "Reload",
+	"chelone.action.remove_all_filters": "Remove all filters",
+	"chelone.action.reset": "Reset",
+	"chelone.action.reset_columns": "Reset",
+	"chelone.action.search_columns": "Search columns",
+	"chelone.action.select_columns": "Columns",
+	"chelone.auth.or": "or",
+	"chelone.calendar.agenda": "Agenda",
+	"chelone.calendar.month": "Month",
+	"chelone.calendar.week": "Week",
+	"chelone.calendar.next": "Next",
+	"chelone.calendar.previous": "Previous",
+	"chelone.calendar.today": "Today",
+	"chelone.calendar.view": "View",
+	"chelone.calendar.no_events": "No events",
+	"chelone.csv_import.back": "Back",
+	"chelone.csv_import.close": "Close",
+	"chelone.csv_import.complete": "Import complete",
+	"chelone.csv_import.counts": "{created} created · {failed} failed · {total} total",
+	"chelone.csv_import.download_errors": "Download error report",
+	"chelone.csv_import.drop": "Drop a CSV file here, or click to choose one",
+	"chelone.csv_import.import": "Import",
+	"chelone.csv_import.issues": "Issues",
+	"chelone.csv_import.next": "Next",
+	"chelone.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.",
+	"chelone.csv_import.preview_summary": "{valid} valid · {errors} errors · {total} total",
+	"chelone.csv_import.required_unmapped": "Required fields are not mapped",
+	"chelone.csv_import.rows_parsed": "{count} rows parsed",
+	"chelone.csv_import.step.commit": "Importing",
+	"chelone.csv_import.step.map": "Map columns",
+	"chelone.csv_import.step.preview": "Preview",
+	"chelone.csv_import.step.upload": "Upload",
+	"chelone.csv_import.unmapped": "Not mapped",
+	"chelone.csv_import.wrong_file": "Choose a .csv file",
+	"chelone.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": {
+	"chelone.message.bulk_delete_title": {
 		one: "Delete 1 item",
 		other: "Delete {count} items"
 	},
-	"ra.message.bulk_edit_description": {
+	"chelone.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": {
+	"chelone.message.bulk_edit_nested_source": "Bulk edit takes flat sources only, but {source} is nested.",
+	"chelone.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": {
+	"chelone.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}",
-	"ra.navigation.clear_filters": "Clear filters",
-	"ra.notification.application_update_available": "A new version of the application is available",
-	"ra.notification.http_error": "Error",
-	"ra.notification.offline": "You are offline",
-	"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}\"",
+	"chelone.message.clear_array_input": "Are you sure you want to clear the whole array?",
+	"chelone.message.delete_content": "Are you sure you want to delete this item?",
+	"chelone.message.delete_title": "Delete {name} {recordRepresentation}",
+	"chelone.navigation.clear_filters": "Clear filters",
+	"chelone.notification.application_update_available": "A new version of the application is available",
+	"chelone.notification.http_error_label": "Error",
+	"chelone.notification.offline": "You are offline",
+	"chelone.saved_queries.new_label": "Save current query",
+	"chelone.saved_queries.query_name": "Query name",
+	"chelone.saved_queries.remove_label_with_name": "Remove saved query \"{name}\"",
 	"chelone.assistant.close": "Close",
 	"chelone.assistant.confirm": "Run {name}?",
 	"chelone.assistant.error": "Something went wrong.",

package/dist/index.d.ts

@@ -45,7 +45,7 @@ export type { JobActionOptions, JobActions, JobPlan, } from "./controller/job-mo
 export { DEFAULT_JOB_TABS, getJobActions, jobStatusSource, planJobCancel, planJobRetry, } from "./controller/job-monitor.js";
 export type { KanbanBucket, KanbanColumnDef, KanbanMove, } from "./controller/kanban-board.js";
 export { buildKanbanBuckets, planKanbanMove, } from "./controller/kanban-board.js";
-export type { ListController, ListControllerContext, ListControllerOptions, ListControllerState, ListParamsPatch, } from "./controller/list-controller.js";
+export type { ListContextSurface, ListController, ListControllerContext, ListControllerOptions, ListControllerState, ListControllerSurface, ListParamsPatch, LooseListParamsPatch, } from "./controller/list-controller.js";
 export { createListController, DEFAULT_DEBOUNCE_MS, DEFAULT_PER_PAGE, 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";
@@ -93,7 +93,7 @@ export type { MutationMode, MutationModeOptions, } from "./data/mutation-options
 export { createMutationOptions, deleteMutationOptions, updateMutationOptions, } from "./data/mutation-options.js";
 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 { CreateParams, CreateResult, CursorPagination, DataProvider, DeleteManyParams, DeleteManyResult, DeleteParams, DeleteResult, DisplayedFilters, FilterPayload, GetListParams, GetListResult, GetManyParams, GetManyReferenceParams, GetManyReferenceResult, GetManyResult, GetOneParams, GetOneResult, InfiniteListParams, LooseDisplayedFilters, LooseFilterPayload, LooseSortPayload, PageInfo, PagePagination, Pagination, SortPayload, UpdateManyParams, UpdateManyResult, UpdateParams, UpdateResult, } from "./data/types.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";
@@ -106,7 +106,7 @@ export type { ArrayBinding, ArrayBindingOptions, ArrayBindingUpdateOptions, Arra
 export { createArrayBinding } from "./form/array-binding.js";
 export { toIdentifierList } from "./form/choice-ids.js";
 export type { ChoiceLists, ChoiceRecord, ChoicesController, ChoicesControllerContext, ChoicesControllerOptions, ChoicesControllerState, } from "./form/choices-controller.js";
-export { choiceListsOf, createChoicesController, } from "./form/choices-controller.js";
+export { choiceListsOf, createChoicesController, eraseChoicesController, } from "./form/choices-controller.js";
 export { formatDate, formatDateTime, formatTime, isValidDate, isValidDateTime, isValidTime, parseDateTimeToISO, parseTimeToDate, } from "./form/date-format.js";
 export { getDirtyFormValues } from "./form/dirty-values.js";
 export type { ParsedDuration } from "./form/duration.js";
@@ -166,6 +166,8 @@ export { createOsrmProvider } from "./geo/snap-to-roads.js";
 export type { JsonObject, JsonValue } from "./guards.js";
 export { isHeadersInit, isRecord, isThenable } from "./guards.js";
 export { defaultMessages } from "./i18n/default-messages.js";
+export type { TextDirection } from "./i18n/direction.js";
+export { getLocaleDirection } from "./i18n/direction.js";
 export { englishMessages } from "./i18n/english-messages.js";
 export type { AnyCheloneI18n, CheloneI18n } from "./i18n/i18n.js";
 export { createI18n } from "./i18n/i18n.js";
@@ -229,7 +231,7 @@ export type { RecordOf, RecordResources, ResourceConfig, ResourceMap, } from "./
 export { defineResources } from "./resource/registry.js";
 export type { ComputeDefinitionProps, ResourceComponent, ResourceDefinition, ResourceDefinitionMap, ResourceIcon, ResourceRegistry, ResourceRegistryListener, ResourceRepresentation, ResourceSlots, } from "./resource/registry-store.js";
 export { computeDefinition, createResourceRegistry, } from "./resource/registry-store.js";
-export type { AnySourcePath, AnySourcePathOf, FilterSourceKey, RowSourcePath, SourceKey, SourcePath, SourceProp, SourceTransformValue, SourceValue, } from "./resource/source-path.js";
+export type { AnyFilterSourceKey, AnyFilterSourceKeyOf, AnySourcePath, AnySourcePathOf, FilterSourceKey, RecordFilterKey, RowSourcePath, SourceKey, SourcePath, SourceProp, SourceTransformValue, SourceValue, } from "./resource/source-path.js";
 export type { IsSafeImageSrcOptions, RichTextBlockType, RichTextHeadingLevel, RichTextToolbarGroup, RichTextToolbarItem, RichTextToolbarItemId, } from "./rich-text/rich-text.js";
 export { isSafeFileUrl, isSafeImageSrc, isSafeLinkUrl, richTextBlockTypes, richTextSanitizeOptions, richTextStarterKitOptions, richTextToolbarItems, } from "./rich-text/rich-text.js";
 export type { RichTextColor, RichTextColorPalette, RichTextExtraToolbarItem, RichTextExtraToolbarItemId, RichTextImageAction, RichTextImageActionId, RichTextImageRules, RichTextUpload, } from "./rich-text/rich-text-extras.js";

package/dist/index.js

@@ -57,7 +57,7 @@ import { createApplicationUpdateStore } from "./environment/application-update-s
 import { createOfflineStore } from "./environment/offline-store.js";
 import { createArrayBinding } from "./form/array-binding.js";
 import { toIdentifierList } from "./form/choice-ids.js";
-import { choiceListsOf, createChoicesController } from "./form/choices-controller.js";
+import { choiceListsOf, createChoicesController, eraseChoicesController } from "./form/choices-controller.js";
 import { formatDate, formatDateTime, formatTime, isValidDate, isValidDateTime, isValidTime, parseDateTimeToISO, parseTimeToDate } from "./form/date-format.js";
 import { getDirtyFormValues } from "./form/dirty-values.js";
 import { compactDuration, parseIsoDuration, relativeDuration } from "./form/duration.js";
@@ -94,6 +94,7 @@ import { featuresToShape, heldFeatures, shapeToFeatures } from "./geo/shape-valu
 import { createOsrmProvider } from "./geo/snap-to-roads.js";
 import { isHeadersInit, isRecord, isThenable } from "./guards.js";
 import { defaultMessages } from "./i18n/default-messages.js";
+import { getLocaleDirection } from "./i18n/direction.js";
 import { englishMessages } from "./i18n/english-messages.js";
 import { createI18n } from "./i18n/i18n.js";
 import { humanize, humanizeField, pluralize } from "./i18n/inflection.js";
@@ -143,4 +144,4 @@ import { shallowEqual } from "./store/shallow-equal.js";
 import { createStore } from "./store/store.js";
 import { DEFAULT_EXPORT_MAX_RESULTS, DEFAULT_THEME_STORAGE_KEY, DEVTOOLS_MAX_VALUE_LENGTH, MOBILE_BREAKPOINT, SEARCH_THRESHOLD, TITLE_PORTAL_ID, UNDO_AUTO_HIDE_MS } from "./ui-defaults.js";
 import { revalidateLogic } from "@tanstack/form-core";
-export { COPIED_MS, DEFAULT_CHART_COLORS, DEFAULT_DEBOUNCE_MS, DEFAULT_EXPORT_MAX_RESULTS, DEFAULT_FIT_PADDING, DEFAULT_JOB_TABS, DEFAULT_LOGIN_PATH, DEFAULT_MAP_HEIGHT, DEFAULT_MAP_ZOOM, DEFAULT_MAX_FIT_ZOOM, DEFAULT_PER_PAGE, DEFAULT_PIN_COLOR, DEFAULT_RECENTS_LIMIT, DEFAULT_REFERENCE_PER_PAGE, DEFAULT_SEARCH_DEBOUNCE_MS, DEFAULT_SHAPE_STYLE, DEFAULT_THEME_STORAGE_KEY, DEVTOOLS_MAX_VALUE_LENGTH, ERROR_SEVERITY, GAP_PREFIX, HANDLE_ID, HttpError, INSPECTOR_KEY_STEP, INSPECTOR_OPEN_LABEL, LATITUDE_LIMIT, LONGITUDE_LIMIT, LockConflictError, MARKERS_SETTLE_MS, MAX_IMAGE_BYTES, MOBILE_BREAKPOINT, MODEL_PREFIX, MONACO_DIAGNOSTICS_DELAY_MS, MONACO_MIN_HEIGHT, NEXT_PATHNAME_KEY, OSM_PRESETS, OWN_KEY_PREFIX, OverpassError, OverpassRateLimitError, OverpassTimeoutError, PANEL_WIDTH, PIN_NS, PREVIEW_ROWS, REMEASURE_MS, REPLACEMENT_CHAR, SEARCH_THRESHOLD, TITLE_PORTAL_ID, UNDO_AUTO_HIDE_MS, ValidationError, addEventsForMutations, aggregateChartData, announceLock, applyCsvMapping, areaInTypeOf, arrangeColumns, asFeatureCollection, aspectLockedBBox, assertRealtimeDataProvider, authStateQueryOptions, bboxToPolygon, broadcastChannelTransport, buildApprovalUpdate, buildKanbanBuckets, buildOverpassQuery, buildPivotTable, buildRecordTree, buildRejectionUpdate, calendarDayKey, calendarDaySlot, calendarDays, calendarEventsInHour, calendarEventsOnDay, calendarLabels, calendarRange, calendarRangeFilter, canAccessQueryOptions, canAccessWithPermissions, canUseCachedPage, chartBlockSpec, chartColor, checkError, checkRichTextImageFile, choiceIdOf, choiceListsOf, choices, clampInspectorPosition, clampRichTextImageWidth, clearUnread, columnLabelMatches, combineDataProviders, commitAllUndoables, compactDuration, composeSource, composeValidators, computeDefinition, configurableInputColumns, copyRichTextImage, countVertices, createApplicationUpdateStore, createArrayBinding, createArraySourceScope, createAssistantSession, createBlockRegistry, createChoicesController, createClientListController, createCommandRegistry, createCreateController, createCreateFormController, createCsvImportController, createDataProviderLog, createDeleteController, createEditController, createEditFormController, createFieldBinding, createFormController, createFormGroups, createFormHandle, createI18n, createInfiniteListController, createInspector, createListController, createLocaleSourceScope, createLockSession, createMicroStore, createMissingKeyStore, createMutationOptions, createNominatimProvider, createNotificationStore, createOfflineStore, createOsrmProvider, createOverpassProvider, createPath, createPresenceSession, createRealtimeStatusStore, createReferenceManyController, createReferenceOneController, createResourceRegistry, createRowSourceScope, createSavedQueriesController, createShowController, createStore, createTopicHub, createTourController, createTranslatableController, csvErrorRows, csvSchemaFields, dataBlockNames, dataTableColumnKeys, deepEqual, defaultConfigurableInputsStoreKey, defaultDataTableStoreKey, defaultExporter, defaultFormat, defaultMessages, defaultParse, defaultRichTextImageRules, defineMessages, defineResources, definedParams, deleteMutationOptions, describeBlockAttrs, describeResource, detectJsonShape, diffRecords, downloadCSV, downloadRichTextImage, echoAssistantTransport, editorStyles, email, emptyBlockDocument, endColorOnEnter, englishMessages, errorMessageOf, expandTileUrl, extractEventValue, extractValidSavedQueries, fakeDataProvider, featuresToShape, fetchUtils, fileEntryImage, fileEntryKey, fileEntryPreview, filterFormReflectShape, findPresetForTags, firstFieldError, formatDataBlockValue, formatDate, formatDateTime, formatDiffValue, formatJsonValue, formatPivotValue, formatRelativeTime, formatTime, fromEditorFeatures, fromJsonText, geoAreaM2, geoBounds, geocodeQueryOptions, getAllowedTransitions, getApprovalState, getAtPath, getBlockDefaultAttrs, getDataTableColumnId, getDirtyFormValues, getFilterFormValues, getInfiniteListOptions, getJobActions, getListOptions, getLockOptions, getLocksOptions, getManyAggregateOptions, getManyOptions, getManyReferenceOptions, getMetricDelta, getOneOptions, getPermissionCell, getPresenceInitials, getPrevNextParams, getRecordForLocale, getRecordFromLocation, getVisibleCommands, groupCalendarAgenda, groupCommands, hasChartValues, hasCustomParams, hasPendingUndoables, hasSelfIntersection, hasTransportMembers, heldFeatures, httpAssistantTransport, humanize, humanizeField, identifiersOf, identityQueryOptions, inMemoryLockProvider, infiniteListKey, inspectorPositionKey, isBlockDoc, isEmpty, isEmptyBlockDocument, isFilterBranch, isFilterSelected, isGeoArea, isGeoBBox, isGeoFeature, isGeoFeatureCollection, isGeoGeometry, isGeoJsonValue, isHeadersInit, isIdentifier, isIdentifierArray, isLngLatBox, isLooseRecord, isOverpassAnswer, isPermissionRowGranted, isRealtimeDataProvider, isRecord, isRequired, isResourceHandle, isResourceRecord, isRichTextImageConfigSource, isSafeFileUrl, isSafeImageSrc, isSafeLinkUrl, isSavedQueryActive, isThenable, isTransformedFile, isTypingTarget, isValidDate, isValidDateTime, isValidTime, jobStatusSource, joinBasename, latLngToLngLat, latitude, listControllerActions, listKey, listPatchFromSearch, lngLatToLatLng, localStorageAdapter, lockKey, lockResourceTopic, lockTopic, locksKey, longitude, manyKey, manyReferenceKey, mapMessages, matchBlocks, matchCsvHeaders, matchPath, matchesHotkey, maxLength, maxValue, maxVertices, memoryStoreAdapter, memoryTransport, mergeFilterValues, minAreaM2, minLength, minValue, minVertices, moveCalendarEvent, moveColumn, moveColumnTo, nextInPlaceEditorState, noSelfIntersection, noop, normalizeFormError, normalizeRichTextUpload, number, omitCalendarRangeFilter, onboardingTourKey, oneKey, overpassQueryOptions, parseCalendarDate, parseCsvWith, parseDateTimeToISO, parseIsoDuration, parseListParams, parseLocation, parseTimeToDate, patchedRecord, permissionsQueryOptions, pickDataBlockFields, pickTranslateParamValues, placeTourCard, placedFeatures, planInPlaceSave, planJobCancel, planJobRetry, planKanbanMove, pluralize, polygonToBBox, prepareRichTextImages, presenceTopic, rasterTileStyle, readDataBlockValue, realtimeDataProvider, recentsKey, recordListBlockSpec, recordTopic, recordsToCSV, reduceGroupState, referenceRecordBlockSpec, regex, relativeDuration, rememberRecent, removeDoubleSlashes, removeRecordsFromCache, required, resolveChoiceValue, resolveLockIdentity, resolveNotificationKey, resolvePrevNext, resolveRichTextImageConfig, resourceKey, resourceTopic, revalidateLogic, reverseGeocodeQueryOptions, richTextBlockTypes, richTextCodeBlockOptions, richTextColors, richTextExtraToolbarItems, richTextImageActions, richTextImageAttributes, richTextImageFileName, richTextImageUploadState, richTextSanitizeOptions, richTextStarterKitOptions, richTextStyledSanitizeOptions, richTextToolbarItems, rootSourceScope, runCsvImport, sanitizeRichTextImageElement, sanitizeRichTextStyle, savedQueriesKey, serializeListParams, serializeListState, setFormValues, setPermissionRow, setRichTextImageUploading, shallowEqual, shapeLayerSpecs, shapeToFeatures, shiftCalendarAnchor, shouldHandleHotkey, sseTransport, staleCalendarRangeKeys, startUndoableMutation, storeRichTextImageFile, stripJsonComments, subscribeLiveLock, subscribeLiveLocks, subscribeLiveRecord, subscribeLiveRecords, subscribeLiveResource, subscribeUnreadCount, tagToFilter, textOf, toBooleanValue, toCalendarEvents, toCartesianRows, toChoiceValue, toChoiceValues, toCoordinate, toCurrencyComposite, toCurrencyValue, toDateInputValue, toDonutSlices, toEditorFeatures, toEmbedSrc, toFileEntries, toFileInputValue, toFileSelection, toFormContextHandle, toIdentifierList, toJsonText, toLocationState, toNullableBooleanValue, toNumberValue, toPresenceUser, toResourceFormHandle, toTextList, toTextValue, toTimelineEntries, toWebhookValue, toggleFilterValue, toggleHiddenColumn, togglePermission, tourSpotlightPath, undoableCallbacks, undoableDeleteOptions, undoableUpdateOptions, unknownBlockType, unreadKey, unwrapUnknownBlocks, updateMutationOptions, updateRecordsInCache, validateCsvRows, webSocketTransport, withLifecycleCallbacks, wrapLongitude, wrapUnknownBlocks };
+export { COPIED_MS, DEFAULT_CHART_COLORS, DEFAULT_DEBOUNCE_MS, DEFAULT_EXPORT_MAX_RESULTS, DEFAULT_FIT_PADDING, DEFAULT_JOB_TABS, DEFAULT_LOGIN_PATH, DEFAULT_MAP_HEIGHT, DEFAULT_MAP_ZOOM, DEFAULT_MAX_FIT_ZOOM, DEFAULT_PER_PAGE, DEFAULT_PIN_COLOR, DEFAULT_RECENTS_LIMIT, DEFAULT_REFERENCE_PER_PAGE, DEFAULT_SEARCH_DEBOUNCE_MS, DEFAULT_SHAPE_STYLE, DEFAULT_THEME_STORAGE_KEY, DEVTOOLS_MAX_VALUE_LENGTH, ERROR_SEVERITY, GAP_PREFIX, HANDLE_ID, HttpError, INSPECTOR_KEY_STEP, INSPECTOR_OPEN_LABEL, LATITUDE_LIMIT, LONGITUDE_LIMIT, LockConflictError, MARKERS_SETTLE_MS, MAX_IMAGE_BYTES, MOBILE_BREAKPOINT, MODEL_PREFIX, MONACO_DIAGNOSTICS_DELAY_MS, MONACO_MIN_HEIGHT, NEXT_PATHNAME_KEY, OSM_PRESETS, OWN_KEY_PREFIX, OverpassError, OverpassRateLimitError, OverpassTimeoutError, PANEL_WIDTH, PIN_NS, PREVIEW_ROWS, REMEASURE_MS, REPLACEMENT_CHAR, SEARCH_THRESHOLD, TITLE_PORTAL_ID, UNDO_AUTO_HIDE_MS, ValidationError, addEventsForMutations, aggregateChartData, announceLock, applyCsvMapping, areaInTypeOf, arrangeColumns, asFeatureCollection, aspectLockedBBox, assertRealtimeDataProvider, authStateQueryOptions, bboxToPolygon, broadcastChannelTransport, buildApprovalUpdate, buildKanbanBuckets, buildOverpassQuery, buildPivotTable, buildRecordTree, buildRejectionUpdate, calendarDayKey, calendarDaySlot, calendarDays, calendarEventsInHour, calendarEventsOnDay, calendarLabels, calendarRange, calendarRangeFilter, canAccessQueryOptions, canAccessWithPermissions, canUseCachedPage, chartBlockSpec, chartColor, checkError, checkRichTextImageFile, choiceIdOf, choiceListsOf, choices, clampInspectorPosition, clampRichTextImageWidth, clearUnread, columnLabelMatches, combineDataProviders, commitAllUndoables, compactDuration, composeSource, composeValidators, computeDefinition, configurableInputColumns, copyRichTextImage, countVertices, createApplicationUpdateStore, createArrayBinding, createArraySourceScope, createAssistantSession, createBlockRegistry, createChoicesController, createClientListController, createCommandRegistry, createCreateController, createCreateFormController, createCsvImportController, createDataProviderLog, createDeleteController, createEditController, createEditFormController, createFieldBinding, createFormController, createFormGroups, createFormHandle, createI18n, createInfiniteListController, createInspector, createListController, createLocaleSourceScope, createLockSession, createMicroStore, createMissingKeyStore, createMutationOptions, createNominatimProvider, createNotificationStore, createOfflineStore, createOsrmProvider, createOverpassProvider, createPath, createPresenceSession, createRealtimeStatusStore, createReferenceManyController, createReferenceOneController, createResourceRegistry, createRowSourceScope, createSavedQueriesController, createShowController, createStore, createTopicHub, createTourController, createTranslatableController, csvErrorRows, csvSchemaFields, dataBlockNames, dataTableColumnKeys, deepEqual, defaultConfigurableInputsStoreKey, defaultDataTableStoreKey, defaultExporter, defaultFormat, defaultMessages, defaultParse, defaultRichTextImageRules, defineMessages, defineResources, definedParams, deleteMutationOptions, describeBlockAttrs, describeResource, detectJsonShape, diffRecords, downloadCSV, downloadRichTextImage, echoAssistantTransport, editorStyles, email, emptyBlockDocument, endColorOnEnter, englishMessages, eraseChoicesController, errorMessageOf, expandTileUrl, extractEventValue, extractValidSavedQueries, fakeDataProvider, featuresToShape, fetchUtils, fileEntryImage, fileEntryKey, fileEntryPreview, filterFormReflectShape, findPresetForTags, firstFieldError, formatDataBlockValue, formatDate, formatDateTime, formatDiffValue, formatJsonValue, formatPivotValue, formatRelativeTime, formatTime, fromEditorFeatures, fromJsonText, geoAreaM2, geoBounds, geocodeQueryOptions, getAllowedTransitions, getApprovalState, getAtPath, getBlockDefaultAttrs, getDataTableColumnId, getDirtyFormValues, getFilterFormValues, getInfiniteListOptions, getJobActions, getListOptions, getLocaleDirection, getLockOptions, getLocksOptions, getManyAggregateOptions, getManyOptions, getManyReferenceOptions, getMetricDelta, getOneOptions, getPermissionCell, getPresenceInitials, getPrevNextParams, getRecordForLocale, getRecordFromLocation, getVisibleCommands, groupCalendarAgenda, groupCommands, hasChartValues, hasCustomParams, hasPendingUndoables, hasSelfIntersection, hasTransportMembers, heldFeatures, httpAssistantTransport, humanize, humanizeField, identifiersOf, identityQueryOptions, inMemoryLockProvider, infiniteListKey, inspectorPositionKey, isBlockDoc, isEmpty, isEmptyBlockDocument, isFilterBranch, isFilterSelected, isGeoArea, isGeoBBox, isGeoFeature, isGeoFeatureCollection, isGeoGeometry, isGeoJsonValue, isHeadersInit, isIdentifier, isIdentifierArray, isLngLatBox, isLooseRecord, isOverpassAnswer, isPermissionRowGranted, isRealtimeDataProvider, isRecord, isRequired, isResourceHandle, isResourceRecord, isRichTextImageConfigSource, isSafeFileUrl, isSafeImageSrc, isSafeLinkUrl, isSavedQueryActive, isThenable, isTransformedFile, isTypingTarget, isValidDate, isValidDateTime, isValidTime, jobStatusSource, joinBasename, latLngToLngLat, latitude, listControllerActions, listKey, listPatchFromSearch, lngLatToLatLng, localStorageAdapter, lockKey, lockResourceTopic, lockTopic, locksKey, longitude, manyKey, manyReferenceKey, mapMessages, matchBlocks, matchCsvHeaders, matchPath, matchesHotkey, maxLength, maxValue, maxVertices, memoryStoreAdapter, memoryTransport, mergeFilterValues, minAreaM2, minLength, minValue, minVertices, moveCalendarEvent, moveColumn, moveColumnTo, nextInPlaceEditorState, noSelfIntersection, noop, normalizeFormError, normalizeRichTextUpload, number, omitCalendarRangeFilter, onboardingTourKey, oneKey, overpassQueryOptions, parseCalendarDate, parseCsvWith, parseDateTimeToISO, parseIsoDuration, parseListParams, parseLocation, parseTimeToDate, patchedRecord, permissionsQueryOptions, pickDataBlockFields, pickTranslateParamValues, placeTourCard, placedFeatures, planInPlaceSave, planJobCancel, planJobRetry, planKanbanMove, pluralize, polygonToBBox, prepareRichTextImages, presenceTopic, rasterTileStyle, readDataBlockValue, realtimeDataProvider, recentsKey, recordListBlockSpec, recordTopic, recordsToCSV, reduceGroupState, referenceRecordBlockSpec, regex, relativeDuration, rememberRecent, removeDoubleSlashes, removeRecordsFromCache, required, resolveChoiceValue, resolveLockIdentity, resolveNotificationKey, resolvePrevNext, resolveRichTextImageConfig, resourceKey, resourceTopic, revalidateLogic, reverseGeocodeQueryOptions, richTextBlockTypes, richTextCodeBlockOptions, richTextColors, richTextExtraToolbarItems, richTextImageActions, richTextImageAttributes, richTextImageFileName, richTextImageUploadState, richTextSanitizeOptions, richTextStarterKitOptions, richTextStyledSanitizeOptions, richTextToolbarItems, rootSourceScope, runCsvImport, sanitizeRichTextImageElement, sanitizeRichTextStyle, savedQueriesKey, serializeListParams, serializeListState, setFormValues, setPermissionRow, setRichTextImageUploading, shallowEqual, shapeLayerSpecs, shapeToFeatures, shiftCalendarAnchor, shouldHandleHotkey, sseTransport, staleCalendarRangeKeys, startUndoableMutation, storeRichTextImageFile, stripJsonComments, subscribeLiveLock, subscribeLiveLocks, subscribeLiveRecord, subscribeLiveRecords, subscribeLiveResource, subscribeUnreadCount, tagToFilter, textOf, toBooleanValue, toCalendarEvents, toCartesianRows, toChoiceValue, toChoiceValues, toCoordinate, toCurrencyComposite, toCurrencyValue, toDateInputValue, toDonutSlices, toEditorFeatures, toEmbedSrc, toFileEntries, toFileInputValue, toFileSelection, toFormContextHandle, toIdentifierList, toJsonText, toLocationState, toNullableBooleanValue, toNumberValue, toPresenceUser, toResourceFormHandle, toTextList, toTextValue, toTimelineEntries, toWebhookValue, toggleFilterValue, toggleHiddenColumn, togglePermission, tourSpotlightPath, undoableCallbacks, undoableDeleteOptions, undoableUpdateOptions, unknownBlockType, unreadKey, unwrapUnknownBlocks, updateMutationOptions, updateRecordsInCache, validateCsvRows, webSocketTransport, withLifecycleCallbacks, wrapLongitude, wrapUnknownBlocks };

package/dist/realtime/live.d.ts

@@ -12,12 +12,12 @@ export interface LiveOptions {
     paused?: () => boolean;
 }
 /** Refetches the resource's lists, shows and edits when anything in it changes or the connection comes back. */
-export declare function subscribeLiveResource<TResources extends ResourceMap>(ctx: DataContext<TResources>, resource: string, options?: LiveOptions): LiveSubscription;
+export declare function subscribeLiveResource<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: DataContext<TResources>, resource: TName, options?: LiveOptions): LiveSubscription;
 /** Like `subscribeLiveResource`, for the events of one record. */
-export declare function subscribeLiveRecord<TResources extends ResourceMap>(ctx: DataContext<TResources>, resource: string, id: Identifier, options?: LiveOptions): LiveSubscription;
+export declare function subscribeLiveRecord<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: DataContext<TResources>, resource: TName, id: Identifier, options?: LiveOptions): LiveSubscription;
 /** Like `subscribeLiveRecord`, for several records: one invalidation however many of them change. */
-export declare function subscribeLiveRecords<TResources extends ResourceMap>(ctx: DataContext<TResources>, resource: string, ids: Identifier[], options?: LiveOptions): LiveSubscription;
+export declare function subscribeLiveRecords<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: DataContext<TResources>, resource: TName, ids: Identifier[], options?: LiveOptions): LiveSubscription;
 /** Refetches one record's lock when it is taken or released. */
-export declare function subscribeLiveLock<TResources extends ResourceMap>(ctx: DataContext<TResources>, resource: string, id: Identifier): LiveSubscription;
+export declare function subscribeLiveLock<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: DataContext<TResources>, resource: TName, id: Identifier): LiveSubscription;
 /** Refetches the resource's lock list when any lock is taken or released. */
-export declare function subscribeLiveLocks<TResources extends ResourceMap>(ctx: DataContext<TResources>, resource: string): LiveSubscription;
+export declare function subscribeLiveLocks<TResources extends ResourceMap, TName extends keyof TResources & string>(ctx: DataContext<TResources>, resource: TName): LiveSubscription;

package/dist/realtime/types.d.ts

@@ -62,13 +62,13 @@ export interface RealtimeTransport {
     getStatus?(): RealtimeConnectionStatus;
     onError?(callback: (error: RealtimeTransportError) => void): Unsubscribe;
 }
-export interface LockProvider {
-    lock(resource: string, params: LockParams): Promise<Lock>;
-    unlock(resource: string, params: UnlockParams): Promise<Lock>;
-    getLock(resource: string, params: GetLockParams): Promise<Lock | null>;
-    getLocks(resource: string, params?: GetLocksParams): Promise<Lock[]>;
+export interface LockProvider<TResources extends ResourceMap = ResourceMap> {
+    lock<TName extends keyof TResources & string>(resource: TName, params: LockParams): Promise<Lock>;
+    unlock<TName extends keyof TResources & string>(resource: TName, params: UnlockParams): Promise<Lock>;
+    getLock<TName extends keyof TResources & string>(resource: TName, params: GetLockParams): Promise<Lock | null>;
+    getLocks<TName extends keyof TResources & string>(resource: TName, params?: GetLocksParams): Promise<Lock[]>;
 }
-export interface RealtimeDataProvider<TResources extends ResourceMap = ResourceMap> extends DataProvider<TResources>, LockProvider {
+export interface RealtimeDataProvider<TResources extends ResourceMap = ResourceMap> extends DataProvider<TResources>, LockProvider<TResources> {
     subscribe<P = unknown>(topic: string, callback: SubscriptionCallback<P>): Unsubscribe;
     publish<P = unknown>(topic: string, event: Omit<RealtimeEvent<P>, "topic">): Promise<void>;
     onReconnect?: RealtimeTransport["onReconnect"];

package/dist/resource/describe-resource.d.ts

@@ -1,11 +1,17 @@
 import type { ResourceConfig } from "./registry.js";
+import type { AnySourcePath } from "./source-path.js";
 /** The field components both adapters export. Each adapter keeps one exhaustive map over this. */
 export type FieldComponentName = "TextField" | "EmailField" | "UrlField" | "NumberField" | "BooleanField" | "DateField" | "SelectField" | "TextArrayField" | "ReferenceField" | "ReferenceArrayField";
 /** The input components both adapters export. */
 export type InputComponentName = "TextInput" | "NumberInput" | "BooleanInput" | "DateInput" | "DateTimeInput" | "SelectInput" | "TextArrayInput" | "ReferenceInput" | "ReferenceArrayInput";
 export type FieldKind = "text" | "email" | "url" | "number" | "boolean" | "date" | "dateTime" | "select" | "textArray" | "reference" | "referenceArray" | "unsupported";
-export interface FieldDescriptor {
-    source: string;
+/**
+ * `TSource` is the registry-wide {@link AnySourcePath} by default, so a guesser
+ * hands `source` to a `source` prop whether or not the app registered resources.
+ * A block's attrs are not resource paths and name `FieldDescriptor<string>`.
+ */
+export interface FieldDescriptor<TSource extends string = AnySourcePath> {
+    source: TSource;
     kind: FieldKind;
     /** True for the `id` field. */
     primary: boolean;
@@ -29,7 +35,7 @@ export interface ResourceDescriptor {
     fields: FieldDescriptor[];
 }
 /** For core's block editor helpers; not exported from the package index. */
-export declare function describeField(source: string, schema: unknown, references: ResourceConfig["references"]): FieldDescriptor;
+export declare function describeField<TSource extends string>(source: TSource, schema: unknown, references: ResourceConfig["references"]): FieldDescriptor<TSource>;
 /**
  * Turns a resource's registered Zod schema (Zod 3 or Zod 4) into one descriptor per field, in
  * schema key order. Returns `undefined` when there is no schema to read or it

package/dist/resource/registry-store.d.ts

@@ -10,6 +10,7 @@
  * a plain keyed store with a whole-map snapshot, mirroring the store /
  * MicroStore notification pattern.
  */
+import type { RegisteredResourceName } from "./register.js";
 /**
  * The augmentation point for the types a resource definition carries that
  * depend on the UI framework. An adapter names them once, as `Register` does
@@ -50,7 +51,8 @@ export type ResourceComponent = ResourceSlots extends {
  * extension bag (D9: the shadcn menu reads `options.group`).
  */
 export interface ResourceDefinition {
-    name: string;
+    /** A registered resource name once `Register` is augmented, else any string. */
+    name: RegisteredResourceName;
     hasList: boolean;
     hasCreate: boolean;
     hasEdit: boolean;
@@ -89,7 +91,8 @@ export interface ResourceRegistry {
 }
 /** Framework-neutral props `computeDefinition` derives a definition from. */
 export interface ComputeDefinitionProps {
-    name: string;
+    /** A registered resource name once `Register` is augmented, else any string. */
+    name: RegisteredResourceName;
     /** A list component; presence sets `hasList`. */
     list?: ResourceComponent;
     create?: ResourceComponent;

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

@@ -110,6 +110,17 @@ export type RowSourcePath<TRecord> = unknown extends TRecord ? string : string e
  * `` `${startSource}_gte` ``) and a filter input's `source` is named with.
  */
 export type FilterSourceKey<TRecord> = "q" | `${SourcePath<TRecord>}_${string}`;
+/**
+ * The filter keys one record accepts: the free-text `q`, its source paths, and
+ * those paths with an operator suffix.
+ *
+ * Plain paths are load-bearing, not a looseness: a filter form writes the key
+ * its input's `source` names (`<TextInput source="title">` pushes
+ * `{ title: "x" }`), and only `calendarRangeFilter` and the like write a
+ * suffix. `string` when the record names no paths of its own — a loose record,
+ * a resource with no schema, a record with an open key set.
+ */
+export type RecordFilterKey<TRecord> = string extends keyof TRecord ? string : SourcePath<TRecord> | FilterSourceKey<TRecord>;
 /** The source props one record accepts: its paths, its row paths, its filter keys. */
 type _RecordSourcePath<TRecord> = SourcePath<TRecord> | RowSourcePath<TRecord> | FilterSourceKey<TRecord>;
 /**
@@ -124,6 +135,18 @@ export type AnySourcePathOf<TResources extends ResourceMap> = string extends key
 }[keyof TResources & string];
 /** {@link AnySourcePathOf} over the app's registered resources. */
 export type AnySourcePath = AnySourcePathOf<RegisteredResources>;
+/**
+ * The union of every registered resource's filter keys.
+ *
+ * `string` when the name set is `string` (nothing registered) and `string` when
+ * any resource has no schema, as {@link AnySourcePathOf} does: an app that
+ * registers some resources but filters one without a schema stays string-keyed.
+ */
+export type AnyFilterSourceKeyOf<TResources extends ResourceMap> = string extends keyof TResources ? string : {
+    [TName in keyof TResources & string]: RecordFilterKey<RecordOf<TResources, TName>>;
+}[keyof TResources & string];
+/** {@link AnyFilterSourceKeyOf} over the app's registered resources. */
+export type AnyFilterSourceKey = AnyFilterSourceKeyOf<RegisteredResources>;
 /**
  * The type a `source` prop takes.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/core",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "repository": {
     "type": "git",