@chelone/vue 0.9.0 → 0.11.0

package/dist/components/admin/realtime/menu-live.vue.d.ts

@@ -22,7 +22,9 @@ export interface MenuLiveProps {
 /**
  * A menu link with a badge counting the resource's new records. The count
  * lives in the store, so it survives a remount; it clears while the link's
- * route is active. Divergence from the React twin: the render props are slots.
+ * route is active. Inside a `<SidebarProvider>` it is a sidebar menu button,
+ * with the label as a `title` while the desktop rail is collapsed; elsewhere it is
+ * a plain link. Divergence from the React twin: the render props are slots.
  * Declared as a render component so the file can also hold {@link MenuLive}.
  */
 export declare const MenuLiveItemLink: import("vue").DefineComponent<import("vue").ExtractPropTypes<{

package/dist/components/admin/realtime/menu-live.vue_vue_type_script_setup_true_lang.js

@@ -2,11 +2,17 @@ import { useCheloneContext, useCheloneStore } from "../../../context.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { useMatch } from "../../../router/nav-composables.js";
 import { Badge } from "../../ui/badge.js";
-import { Fragment, computed, createBlock, createElementBlock, defineComponent, h, mergeProps, openBlock, renderList, shallowRef, unref, watchEffect } from "vue";
+import { SidebarContextKey } from "../../ui/sidebar/sidebar-context.js";
+import sidebar_menu_button_default from "../../ui/sidebar/sidebar-menu-button.js";
+import { SidebarMenuItem } from "../../ui/sidebar/sidebar-parts.js";
+import { Fragment, computed, createBlock, createElementBlock, defineComponent, h, inject, mergeProps, openBlock, renderList, shallowRef, unref, watchEffect } from "vue";
 import { assertRealtimeDataProvider, clearUnread, subscribeUnreadCount, unreadKey } from "@chelone/core";
 import { RouterLink } from "vue-router";
 // src/components/admin/realtime/menu-live.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = { class: "flex flex-col gap-1" };
+var _hoisted_1 = {
+	key: 1,
+	class: "flex flex-col gap-1"
+};
 var subscriptions = /* @__PURE__ */ new WeakMap();
 var toEventsKey = (events) => [...new Set(events)].sort().join(",");
 var fromEventsKey = (eventsKey) => eventsKey.split(",").filter(Boolean);
@@ -51,7 +57,9 @@ function acquire(dataProvider, store, resource, eventsKey) {
 /**
 * A menu link with a badge counting the resource's new records. The count
 * lives in the store, so it survives a remount; it clears while the link's
-* route is active. Divergence from the React twin: the render props are slots.
+* route is active. Inside a `<SidebarProvider>` it is a sidebar menu button,
+* with the label as a `title` while the desktop rail is collapsed; elsewhere it is
+* a plain link. Divergence from the React twin: the render props are slots.
 * Declared as a render component so the file can also hold {@link MenuLive}.
 */
 var MenuLiveItemLink = defineComponent({
@@ -86,6 +94,7 @@ var MenuLiveItemLink = defineComponent({
 		const { dataProvider } = useCheloneContext();
 		const store = useCheloneStore();
 		const translate = useTranslate();
+		const sidebar = inject(SidebarContextKey, null);
 		const match = useMatch({
 			path: props.to,
 			end: false
@@ -111,15 +120,30 @@ var MenuLiveItemLink = defineComponent({
 		return () => {
 			const n = count.value ?? 0;
 			const text = translate(props.label, { _: props.label });
-			return h(RouterLink, {
-				to: props.to,
-				class: "flex items-center gap-2 rounded-md px-2 py-1.5 text-sm hover:bg-accent"
-			}, () => [
+			const badge = n > 0 ? h(Badge, {
+				"data-testid": "menu-live-badge",
+				class: sidebar ? "group-data-[collapsible=icon]:absolute group-data-[collapsible=icon]:top-0 group-data-[collapsible=icon]:right-0 group-data-[collapsible=icon]:h-4 group-data-[collapsible=icon]:min-w-4 group-data-[collapsible=icon]:px-1 group-data-[collapsible=icon]:text-[10px]" : void 0
+			}, () => props.badgeLabel?.(n) ?? (n > 99 ? "99+" : String(n))) : null;
+			const content = () => [
 				props.icon ? h(props.icon) : null,
 				slots.icon?.(),
 				h("span", { class: "flex-1" }, text),
-				n > 0 ? h(Badge, { "data-testid": "menu-live-badge" }, () => props.badgeLabel?.(n) ?? (n > 99 ? "99+" : String(n))) : null
-			]);
+				badge
+			];
+			if (sidebar) return h(SidebarMenuItem, null, () => h(sidebar_menu_button_default, {
+				as: RouterLink,
+				to: props.to,
+				isActive: match.value != null,
+				class: "relative",
+				title: sidebar.state.value === "collapsed" && !sidebar.isMobile.value ? text : void 0,
+				onClick: () => {
+					if (sidebar.openMobile.value) sidebar.setOpenMobile(false);
+				}
+			}, content));
+			return h(RouterLink, {
+				to: props.to,
+				class: "flex items-center gap-2 rounded-md px-2 py-1.5 text-sm hover:bg-accent"
+			}, content);
 		};
 	}
 });
@@ -128,12 +152,18 @@ var menu_live_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 	props: { items: {} },
 	setup(__props) {
 		/**
-		* `<MenuLive>` — a list of {@link MenuLiveItemLink}s, one per item.
+		* `<MenuLive>` — a list of {@link MenuLiveItemLink}s, one per item. Inside a
+		* sidebar it renders the items as sidebar menu entries with no wrapper, so
+		* place it in a `<SidebarMenu>`, such as a `<ResourceMenuItemGroup>`'s default
+		* slot.
 		*/
+		const sidebar = inject(SidebarContextKey, null);
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("nav", _hoisted_1, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
+			return unref(sidebar) ? (openBlock(true), createElementBlock(Fragment, { key: 0 }, renderList(__props.items, (item) => {
+				return openBlock(), createBlock(unref(MenuLiveItemLink), mergeProps({ key: item.to }, { ref_for: true }, item), null, 16);
+			}), 128)) : (openBlock(), createElementBlock("nav", _hoisted_1, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
 				return openBlock(), createBlock(unref(MenuLiveItemLink), mergeProps({ key: item.to }, { ref_for: true }, item), null, 16);
-			}), 128))]);
+			}), 128))]));
 		};
 	}
 });

package/dist/components/admin/supabase/forgot-password-form.vue_vue_type_script_setup_true_lang.js

@@ -32,7 +32,7 @@ var forgot_password_form_vue_vue_type_script_setup_true_lang_default = /*@__PURE
 				await resetPassword.mutateAsync({ email: values.email });
 			} catch (error) {
 				const message = errorMessageOf(error);
-				notifications?.notify(message ?? "ra.notification.http_error", {
+				notifications?.notify(message ?? "chelone.notification.http_error_label", {
 					type: "warning",
 					messageArgs: message === void 0 ? void 0 : { _: message }
 				});

package/dist/components/admin/supabase/set-password-form.vue_vue_type_script_setup_true_lang.js

@@ -50,7 +50,7 @@ var set_password_form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 				});
 			} catch (error) {
 				const message = errorMessageOf(error);
-				notifications?.notify(message ?? "ra.notification.http_error", {
+				notifications?.notify(message ?? "chelone.notification.http_error_label", {
 					type: "warning",
 					messageArgs: message === void 0 ? void 0 : { _: message }
 				});
@@ -88,7 +88,7 @@ var set_password_form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 				onSubmit: handleSubmit
 			}, [
 				createVNode(password_input_default, {
-					label: unref(translate)("ra.auth.password", { _: "Password" }),
+					label: unref(translate)("chelone.auth.password", { _: "Password" }),
 					source: "password",
 					autocomplete: "new-password",
 					autofocus: "",
@@ -105,7 +105,7 @@ var set_password_form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*
 					class: "cursor-pointer",
 					disabled: unref(submitting)
 				}, {
-					default: withCtx(() => [unref(submitting) ? (openBlock(), createBlock(spinner_default, { key: 0 })) : createCommentVNode("", true), createTextVNode(" " + toDisplayString(unref(translate)("ra.action.save", { _: "Save" })), 1)]),
+					default: withCtx(() => [unref(submitting) ? (openBlock(), createBlock(spinner_default, { key: 0 })) : createCommentVNode("", true), createTextVNode(" " + toDisplayString(unref(translate)("chelone.action.save", { _: "Save" })), 1)]),
 					_: 1
 				}, 8, ["disabled"])
 			], 34));

package/dist/components/admin/supabase/supabase-login-page.vue_vue_type_script_setup_true_lang.js

@@ -70,7 +70,7 @@ var supabase_login_page_vue_vue_type_script_setup_true_lang_default = /*@__PURE_
 					_: 1
 				}, 8, ["to"])) : createCommentVNode("", true)], 64)) : createCommentVNode("", true), providers.value.length > 0 ? (openBlock(), createElementBlock("div", _hoisted_1, [!props.disableEmailPassword ? (openBlock(), createElementBlock("div", _hoisted_2, [
 					_cache[0] || (_cache[0] = createElementVNode("div", { class: "flex-1 border-t" }, null, -1)),
-					createTextVNode(" " + toDisplayString(unref(translate)("ra.auth.or", { _: "or" })) + " ", 1),
+					createTextVNode(" " + toDisplayString(unref(translate)("chelone.auth.or", { _: "or" })) + " ", 1),
 					_cache[1] || (_cache[1] = createElementVNode("div", { class: "flex-1 border-t" }, null, -1))
 				])) : createCommentVNode("", true), (openBlock(true), createElementBlock(Fragment, null, renderList(providers.value, (provider) => {
 					return openBlock(), createBlock(resolveDynamicComponent(buttons[provider]), {

package/dist/components/admin/view/create.vue_vue_type_script_setup_true_lang.js

@@ -57,7 +57,7 @@ var create_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCom
 		const redirect = useRedirectOptional();
 		const translate = useTranslate();
 		const getResourceLabel = useGetResourceLabel();
-		const defaultTitle = computed(() => translate("ra.page.create", { name: getResourceLabel(resource, 1) }));
+		const defaultTitle = computed(() => translate("chelone.page.create", { name: getResourceLabel(resource, 1) }));
 		const form = useForm({
 			resource,
 			record: seed,

package/dist/components/admin/view/infinite-list.vue_vue_type_script_setup_true_lang.js

@@ -38,7 +38,7 @@ var infinite_list_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		provideListContext(controller);
 		const translate = useTranslate();
 		const getResourceLabel = useGetResourceLabel();
-		const defaultTitle = computed(() => translate("ra.page.list", { name: getResourceLabel(resource, 2) }));
+		const defaultTitle = computed(() => translate("chelone.page.list", { name: getResourceLabel(resource, 2) }));
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", _hoisted_1, [createElementVNode("div", _hoisted_2, [__props.title !== "" ? (openBlock(), createElementBlock("h2", _hoisted_3, toDisplayString(__props.title ?? defaultTitle.value), 1)) : createCommentVNode("", true), createElementVNode("div", _hoisted_4, [renderSlot(_ctx.$slots, "actions")])]), renderSlot(_ctx.$slots, "default")]);
 		};

package/dist/components/admin/view/list.vue_vue_type_script_setup_true_lang.js

@@ -42,7 +42,7 @@ var list_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 		provideListContext(controller);
 		const translate = useTranslate();
 		const getResourceLabel = useGetResourceLabel();
-		const defaultTitle = computed(() => translate("ra.page.list", { name: getResourceLabel(resource, 2) }));
+		const defaultTitle = computed(() => translate("chelone.page.list", { name: getResourceLabel(resource, 2) }));
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("div", _hoisted_1, [createElementVNode("div", _hoisted_2, [__props.title !== "" ? (openBlock(), createElementBlock("h2", _hoisted_3, toDisplayString(__props.title ?? defaultTitle.value), 1)) : createCommentVNode("", true), createElementVNode("div", _hoisted_4, [renderSlot(_ctx.$slots, "actions")])]), renderSlot(_ctx.$slots, "default")]);
 		};

package/dist/components/admin/view/translatable-fields-tab.vue_vue_type_script_setup_true_lang.js

@@ -25,7 +25,7 @@ var translatable_fields_tab_vue_vue_type_script_setup_true_lang_default = /*@__P
 		const translate = useTranslate();
 		const translatable = useTranslatableContext();
 		const selected = computed(() => translatable.selectedLocale.value === props.locale);
-		const label = computed(() => translate(`ra.locales.${props.locale}`, { _: props.locale.charAt(0).toUpperCase() + props.locale.slice(1) }));
+		const label = computed(() => translate(`chelone.locales.${props.locale}`, { _: props.locale.charAt(0).toUpperCase() + props.locale.slice(1) }));
 		return (_ctx, _cache) => {
 			return openBlock(), createElementBlock("button", {
 				type: "button",

package/dist/components/admin/widgets/job-monitor-row.vue_vue_type_script_setup_true_lang.js

@@ -116,7 +116,7 @@ var job_monitor_row_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 							disabled: __props.busy,
 							onClick: _cache[2] || (_cache[2] = ($event) => emit("plan", unref(planJobCancel)(__props.job, options.value)))
 						}, {
-							default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("ra.action.cancel", { _: "Cancel" })), 1)]),
+							default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("chelone.action.cancel", { _: "Cancel" })), 1)]),
 							_: 1
 						}, 8, ["disabled"])) : createCommentVNode("", true)
 					])

package/dist/components/inspector/inspector.vue_vue_type_script_setup_true_lang.js

@@ -155,7 +155,7 @@ var inspector_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 				variant: "ghost",
 				size: "icon",
 				class: "size-7",
-				"aria-label": unref(translate)("ra.action.close", { _: "Close" }),
+				"aria-label": unref(translate)("chelone.action.close", { _: "Close" }),
 				onClick: _cache[0] || (_cache[0] = ($event) => unref(inspector).disable())
 			}, {
 				default: withCtx(() => [createVNode(unref(XIcon))]),

package/dist/controllers/reference-field-options.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The options the two reference-field composables share: the record the lookup
+ * reads its foreign key from, and the fetch gate. `target` is not here: it is
+ * keyed by the referenced record, which only the composables name.
+ */
+import type { LooseRecord, ResourceRecord, SourceProp } from "@chelone/core";
+import type { MaybeRefOrGetter } from "vue";
+import type { RecordValue } from "../record/record-context.js";
+export interface ReferenceFieldControllerOptions<TName extends string, RecordType extends ResourceRecord = LooseRecord> {
+    /** The resource whose rows point at the record. */
+    reference: TName;
+    /** The field on the record whose value `target` must equal. The composable defaults it to `"id"`. */
+    source?: SourceProp<RecordType>;
+    /** Defaults to the ambient record (`RecordContextKey`). */
+    record?: MaybeRefOrGetter<RecordValue<RecordType>>;
+    /** Gates the data fetch only. Default true. */
+    enabled?: boolean;
+}

package/dist/controllers/reference-field-test-harness.d.ts

@@ -1,3 +1,4 @@
+import { type LooseRecord } from "@chelone/core";
 import { type Ref } from "vue";
 import { z } from "zod";
 import { type RecordValue } from "../record/record-context.js";
@@ -150,7 +151,7 @@ export declare function mountProbe<TResult>(useProbe: () => TResult, initialReco
         };
     }, TName>>>)>;
 };
-export declare const mountMany: (options?: Omit<UseReferenceManyFieldControllerOptions<"comments">, "reference" | "target">, record?: RecordValue, failWith?: Error) => {
+export declare const mountMany: (options?: Omit<UseReferenceManyFieldControllerOptions<"comments", LooseRecord, Comment>, "reference" | "target">, record?: RecordValue, failWith?: Error) => {
     wrapper: import("@vue/test-utils").VueWrapper<Partial<{}> & Omit<{} & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never> & {
         $: import("vue").ComponentInternalInstance;
         $data: {};
@@ -261,7 +262,7 @@ export declare const mountMany: (options?: Omit<UseReferenceManyFieldControllerO
         };
     }, TName>>>)>;
 };
-export declare const mountOne: (options?: Omit<UseReferenceOneFieldControllerOptions<"profiles">, "reference" | "target">, record?: RecordValue, failWith?: Error) => {
+export declare const mountOne: (options?: Omit<UseReferenceOneFieldControllerOptions<"profiles", LooseRecord, Profile>, "reference" | "target">, record?: RecordValue, failWith?: Error) => {
     wrapper: import("@vue/test-utils").VueWrapper<Partial<{}> & Omit<{} & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never> & {
         $: import("vue").ComponentInternalInstance;
         $data: {};

package/dist/controllers/use-infinite-list-controller.d.ts

@@ -8,9 +8,9 @@
  * Filters and sort live in the store only: the composable never reads or
  * writes the location.
  */
-import { type InfiniteListController, type InfiniteListControllerState, type ListControllerOptions, type MicroStore, type RecordOf, type ResourceMap } from "@chelone/core";
+import { type InfiniteListController, type InfiniteListControllerState, type ListControllerOptions, type LooseRecord, type MicroStore, type RecordOf, type ResourceMap } from "@chelone/core";
 /** Options for {@link useInfiniteListController}: the core list options + a resource override. */
-export interface UseInfiniteListControllerOptions extends ListControllerOptions {
+export interface UseInfiniteListControllerOptions<TRecord = LooseRecord> extends ListControllerOptions<TRecord> {
     /** Target a specific resource; defaults to the ambient `<Resource>` name. */
     resource?: string;
 }
@@ -22,4 +22,4 @@ export type UseInfiniteListControllerReturn<TRecord> = InfiniteListControllerSta
  * and starts over. The controller attaches on mount and releases on scope
  * disposal. `options` are read once at `setup`.
  */
-export declare function useInfiniteListController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string>(options?: UseInfiniteListControllerOptions): UseInfiniteListControllerReturn<RecordOf<TResources, TName>>;
+export declare function useInfiniteListController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string>(options?: UseInfiniteListControllerOptions<RecordOf<TResources, TName>>): UseInfiniteListControllerReturn<RecordOf<TResources, TName>>;

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

@@ -21,9 +21,9 @@
  * `resource` / `options` are read once at `setup`; to target a different
  * resource, mount a fresh instance (the Vue analog of React's remount-with-key).
  */
-import { type ListController, type ListControllerOptions, type ListControllerState, type MicroStore, type RecordOf, type ResourceMap } from "@chelone/core";
+import { type ListControllerOptions, type ListControllerSurface, type LooseRecord, type RecordOf, type ResourceMap } from "@chelone/core";
 /** Options for {@link useListController}: the core list options + a resource override. */
-export interface UseListControllerOptions extends ListControllerOptions {
+export interface UseListControllerOptions<TRecord = LooseRecord> extends ListControllerOptions<TRecord> {
     /** Target a specific resource; defaults to the ambient `<Resource>` name. */
     resource?: string;
     /**
@@ -46,5 +46,5 @@ export interface UseListControllerOptions extends ListControllerOptions {
  * plus the controller's stable actions (`setPage`/`setSort`/`toggleItem`/…). The
  * same shape the React twin returns, minus the `MicroStore` plumbing.
  */
-export type UseListControllerReturn<TRecord> = ListControllerState<TRecord> & Omit<ListController<TRecord>, keyof MicroStore<ListControllerState<TRecord>>>;
-export declare function useListController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string>(options?: UseListControllerOptions): UseListControllerReturn<RecordOf<TResources, TName>>;
+export type UseListControllerReturn<TRecord> = ListControllerSurface<TRecord>;
+export declare function useListController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string>(options?: UseListControllerOptions<RecordOf<TResources, TName>>): UseListControllerReturn<RecordOf<TResources, TName>>;

package/dist/controllers/use-reference-many-field-controller.d.ts

@@ -10,22 +10,15 @@
  * previous subscription is released. The other options are read at `setup`.
  * There is no location sync: the list is embedded in a record.
  */
-import { type FilterPayload, type ListControllerState, type LooseRecord, type MicroStore, type RecordOf, type ReferenceManyController, type ResourceMap, type ResourceRecord, type SortPayload } from "@chelone/core";
-import { type MaybeRefOrGetter } from "vue";
-import { type RecordValue } from "../record/record-context.js";
-export interface UseReferenceManyFieldControllerOptions<TName extends string = string, RecordType extends ResourceRecord = LooseRecord> {
-    /** The resource whose rows point at the record. */
-    reference: TName;
-    /** The field on `reference` that holds the foreign key. */
-    target: string;
-    /** The field on the record whose value `target` must equal. Default `"id"`. */
-    source?: string;
-    /** Defaults to the ambient record. */
-    record?: MaybeRefOrGetter<RecordValue<RecordType>>;
+import { type FilterPayload, type ListControllerState, type LooseRecord, type MicroStore, type RecordOf, type ReferenceManyController, type ResourceMap, type ResourceRecord, type SortPayload, type SourceKey } from "@chelone/core";
+import type { ReferenceFieldControllerOptions } from "./reference-field-options.js";
+export interface UseReferenceManyFieldControllerOptions<TName extends string = string, RecordType extends ResourceRecord = LooseRecord, ReferenceRecord = LooseRecord> extends ReferenceFieldControllerOptions<TName, RecordType> {
+    /** The field on `reference` that holds the foreign key. A key of the referenced record. */
+    target: SourceKey<ReferenceRecord>;
     /** Permanent filter, merged over the user filter for every fetch. */
-    filter?: FilterPayload;
+    filter?: FilterPayload<ReferenceRecord>;
     /** Initial sort when nothing is persisted. Default id ascending. */
-    sort?: SortPayload | SortPayload[];
+    sort?: SortPayload<ReferenceRecord> | SortPayload<ReferenceRecord>[];
     /** Default 25. */
     perPage?: number;
     /** KV namespace for params and selection. Default `${reference}.${target}.${id}`; `false` keeps them in memory. */
@@ -43,4 +36,4 @@ export type UseReferenceManyFieldControllerReturn<TRecord> = ListControllerState
  * actions. A record without a usable id (absent, or not a string or number)
  * fetches nothing and reads as an empty, settled list.
  */
-export declare function useReferenceManyFieldController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string, RecordType extends ResourceRecord = LooseRecord>(options: UseReferenceManyFieldControllerOptions<TName, RecordType>): UseReferenceManyFieldControllerReturn<RecordOf<TResources, TName>>;
+export declare function useReferenceManyFieldController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string, RecordType extends ResourceRecord = LooseRecord>(options: UseReferenceManyFieldControllerOptions<TName, RecordType, RecordOf<TResources, TName>>): UseReferenceManyFieldControllerReturn<RecordOf<TResources, TName>>;

package/dist/controllers/use-reference-one-field-controller.d.ts

@@ -8,24 +8,15 @@
  * {@link useReferenceManyFieldController}: a new id builds a new controller and
  * releases the previous subscription.
  */
-import { type FilterPayload, type LooseRecord, type MicroStore, type RecordOf, type ReferenceOneController, type ReferenceOneControllerState, type ResourceMap, type ResourceRecord, type SortPayload } from "@chelone/core";
-import { type MaybeRefOrGetter } from "vue";
-import { type RecordValue } from "../record/record-context.js";
-export interface UseReferenceOneFieldControllerOptions<TName extends string = string, RecordType extends ResourceRecord = LooseRecord> {
-    /** The resource whose rows point at the record. */
-    reference: TName;
-    /** The field on `reference` that holds the foreign key. */
-    target: string;
-    /** The field on the record whose value `target` must equal. Default `"id"`. */
-    source?: string;
-    /** Defaults to the ambient record. */
-    record?: MaybeRefOrGetter<RecordValue<RecordType>>;
+import { type FilterPayload, type LooseRecord, type MicroStore, type RecordOf, type ReferenceOneController, type ReferenceOneControllerState, type ResourceMap, type ResourceRecord, type SortPayload, type SourceKey } from "@chelone/core";
+import type { ReferenceFieldControllerOptions } from "./reference-field-options.js";
+export interface UseReferenceOneFieldControllerOptions<TName extends string = string, RecordType extends ResourceRecord = LooseRecord, ReferenceRecord = LooseRecord> extends ReferenceFieldControllerOptions<TName, RecordType> {
+    /** The field on `reference` that holds the foreign key. A key of the referenced record. */
+    target: SourceKey<ReferenceRecord>;
     /** Decides which row is first when several match. */
-    sort?: SortPayload | SortPayload[];
+    sort?: SortPayload<ReferenceRecord> | SortPayload<ReferenceRecord>[];
     /** Narrows the lookup. */
-    filter?: FilterPayload;
-    /** Gates the fetch. Default true. */
-    enabled?: boolean;
+    filter?: FilterPayload<ReferenceRecord>;
 }
 /** Live lookup state plus the controller's stable `refetch`. */
 export type UseReferenceOneFieldControllerReturn<TRecord> = ReferenceOneControllerState<TRecord> & Omit<ReferenceOneController<TRecord>, keyof MicroStore<ReferenceOneControllerState<TRecord>>>;
@@ -33,4 +24,4 @@ export type UseReferenceOneFieldControllerReturn<TRecord> = ReferenceOneControll
  * The first row of `reference` whose `target` equals `record[source]`. A record
  * without a usable id fetches nothing and reads as settled with no record.
  */
-export declare function useReferenceOneFieldController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string, RecordType extends ResourceRecord = LooseRecord>(options: UseReferenceOneFieldControllerOptions<TName, RecordType>): UseReferenceOneFieldControllerReturn<RecordOf<TResources, TName>>;
+export declare function useReferenceOneFieldController<TResources extends ResourceMap = ResourceMap, TName extends keyof TResources & string = keyof TResources & string, RecordType extends ResourceRecord = LooseRecord>(options: UseReferenceOneFieldControllerOptions<TName, RecordType, RecordOf<TResources, TName>>): UseReferenceOneFieldControllerReturn<RecordOf<TResources, TName>>;

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

@@ -11,11 +11,17 @@
  * read it directly with no ref juggling. `useListContext` throws without a
  * provider (parity with the React twin).
  */
-import type { LooseRecord } from "@chelone/core";
+import type { ListContextSurface, LooseRecord, ResourceRecord } from "@chelone/core";
 import { type InjectionKey } from "vue";
-import type { UseListControllerReturn } from "../controllers/use-list-controller.js";
-/** The ambient list surface — the reactive `useListController` result. */
-export type ListContextValue<TRecord = LooseRecord> = UseListControllerReturn<TRecord>;
+/**
+ * The ambient list surface — the reactive `useListController` result.
+ *
+ * `ListContextSurface` erases the filter members and keeps `data` typed: an
+ * injection key cannot be generic, so a controller typed to any record must be
+ * assignable to the one value this key carries. `ResourceRecord` is the widest
+ * record `data` can hold; `useListContext<T>()` reads it back typed.
+ */
+export type ListContextValue<TRecord = ResourceRecord> = ListContextSurface<TRecord>;
 /** The provide/inject key for the ambient list surface. */
 export declare const ListContextKey: InjectionKey<ListContextValue>;
 /** Provide the ambient list surface (called by `<List>` in `setup`). */

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

@@ -26,9 +26,9 @@ export interface UseListOptions<TRecord extends ResourceRecord = ResourceRecord>
     /** The in-memory records (reactive-aware). `undefined` = not-yet-loaded. */
     data?: MaybeRefOrGetter<TRecord[] | undefined>;
     /** Client-side filter for the embedded list. */
-    filter?: FilterPayload;
+    filter?: FilterPayload<TRecord>;
     /** Client-side sort for the embedded list. */
-    sort?: SortPayload | SortPayload[];
+    sort?: SortPayload<TRecord> | SortPayload<TRecord>[];
     /** Client-side page size. Default 1000 (ra-core `useList` — "show everything"). */
     perPage?: number;
     /** Initial page (1-based). Default 1. */
@@ -47,4 +47,4 @@ export interface UseListOptions<TRecord extends ResourceRecord = ResourceRecord>
  * into the live controller so an async feed (a resolving `useGetMany` /
  * `useGetList`) populates the list in place.
  */
-export declare function useList<TRecord extends ResourceRecord = ResourceRecord>(options?: UseListOptions<TRecord>): ListContextValue;
+export declare function useList<TRecord extends ResourceRecord = ResourceRecord>(options?: UseListOptions<TRecord>): ListContextValue<TRecord>;

package/dist/store/use-saved-queries.d.ts

@@ -1,9 +1,9 @@
-import { type SavedQueriesControllerOptions, type SavedQuery, type SavedQueryValue } from "@chelone/core";
+import { type LooseRecord, type SavedQueriesControllerOptions, type SavedQuery, type SavedQueryValue } from "@chelone/core";
 import { type Ref } from "vue";
-export interface UseSavedQueriesReturn {
-    queries: Readonly<Ref<readonly SavedQuery[]>>;
+export interface UseSavedQueriesReturn<TRecord = LooseRecord> {
+    queries: Readonly<Ref<readonly SavedQuery<TRecord>[]>>;
     /** Trims the label and ignores a blank one; a same-label query is replaced. */
-    save(label: string, value: SavedQueryValue): void;
+    save(label: string, value: SavedQueryValue<TRecord>): void;
     /** Trims the label; a label no query has is ignored. */
     remove(label: string): void;
 }
@@ -17,4 +17,4 @@ export interface UseSavedQueriesReturn {
  * `[queries, setQueries]` tuple: this returns `{ queries, save, remove }`, with
  * `queries` a ref.
  */
-export declare function useSavedQueries(resource: string, options?: SavedQueriesControllerOptions): UseSavedQueriesReturn;
+export declare function useSavedQueries<TRecord = LooseRecord>(resource: string, options?: SavedQueriesControllerOptions): UseSavedQueriesReturn<TRecord>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/vue",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -76,14 +76,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@chelone/core": "0.9.0",
-    "@chelone/utils": "0.9.0",
+    "@chelone/core": "0.11.0",
+    "@chelone/utils": "0.11.0",
     "@types/geojson": "^7946.0.16",
     "cronstrue": "^3.38.0",
     "libphonenumber-js": "^1.13.15"
   },
   "peerDependencies": {
-    "@chelone/supabase": "0.9.0",
+    "@chelone/supabase": "0.11.0",
     "@dnd-kit/dom": "^0.5.3",
     "@dnd-kit/vue": "^0.5.3",
     "@guolao/vue-monaco-editor": "^1.6.0",
@@ -219,7 +219,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@chelone/supabase": "0.9.0",
+    "@chelone/supabase": "0.11.0",
     "@chelone/test-utils": "0.0.0",
     "@dnd-kit/dom": "^0.5.3",
     "@dnd-kit/vue": "^0.5.3",