@chelone/vue 0.10.0 → 0.11.0

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.10.0",
+  "version": "0.11.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -76,14 +76,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@chelone/core": "0.10.0",
-    "@chelone/utils": "0.10.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.10.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.10.0",
+    "@chelone/supabase": "0.11.0",
     "@chelone/test-utils": "0.0.0",
     "@dnd-kit/dom": "^0.5.3",
     "@dnd-kit/vue": "^0.5.3",