@chelone/vue 0.3.0 → 0.5.0

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

@@ -13,28 +13,29 @@
  * comes from the ambient i18n via {@link useTranslate}, so `useChoices` must be
  * called in `setup`.
  */
+import { type SourcePath } from "@chelone/core";
 /** An erased choice record — choices carry arbitrary shapes (`{id, name, ...}`). */
 export type ChoiceRecord = Record<string, unknown>;
 /** The display path (dot or bracket) or a formatter over the whole choice. */
-export type OptionText = string | ((choice: ChoiceRecord) => string);
-export interface UseChoicesOptions {
+export type OptionText<TChoice extends ChoiceRecord = ChoiceRecord> = SourcePath<TChoice> | ((choice: TChoice) => string);
+export interface UseChoicesOptions<TChoice extends ChoiceRecord = ChoiceRecord> {
     /** The display path or a formatter. Default `'name'`. */
-    optionText?: OptionText;
+    optionText?: OptionText<TChoice>;
     /** The value path. Default `'id'`. */
-    optionValue?: string;
+    optionValue?: SourcePath<TChoice>;
     /** The disabled-flag path. Default `'disabled'`. */
-    disableValue?: string;
+    disableValue?: SourcePath<TChoice>;
     /** Translate a string-path text through the catalog (default `true`). */
     translateChoice?: boolean;
 }
 /** The choice accessors a choice input needs. */
-export interface UseChoicesResult {
+export interface UseChoicesResult<TChoice extends ChoiceRecord = ChoiceRecord> {
     /** The display text: string path (optionally translated) or the formatter's output. */
-    getChoiceText(choice: ChoiceRecord): string;
+    getChoiceText(choice: TChoice): string;
     /** The value: `get(choice, optionValue)`, falling back to `choice.id`. */
-    getChoiceValue(choice: ChoiceRecord): unknown;
+    getChoiceValue(choice: TChoice): unknown;
     /** The disabled flag: `get(choice, disableValue)`. */
-    getDisableValue(choice: ChoiceRecord): unknown;
+    getDisableValue(choice: TChoice): unknown;
 }
 /**
  * Read a choice path off a record with core's one path grammar
@@ -50,4 +51,4 @@ export declare function getChoicePath(record: ChoiceRecord, path: string): unkno
  * value (`optionValue` path or `id`), and disabled flag. Defaults are read live
  * off `options`, so a reactive props object stays live between reads.
  */
-export declare function useChoices(options?: UseChoicesOptions): UseChoicesResult;
+export declare function useChoices<TChoice extends ChoiceRecord = ChoiceRecord>(options?: UseChoicesOptions<TChoice>): UseChoicesResult<TChoice>;

package/dist/choices/use-choices.js

@@ -6,22 +6,23 @@ function getChoicePath(record, path) {
 }
 function useChoices(options = {}) {
   const translate = useTranslate();
+  const loose = () => options;
   return {
     getChoiceText(choice) {
-      const optionText = options.optionText ?? "name";
+      const optionText = loose().optionText ?? "name";
       if (typeof optionText === "function") return optionText(choice);
       const raw = getChoicePath(choice, optionText);
       const text = raw == null ? "" : String(raw);
-      if (options.translateChoice === false) return text;
+      if (loose().translateChoice === false) return text;
       const translated = translate(text, { _: text });
       return translated === text ? text : translated;
     },
     getChoiceValue(choice) {
-      const value = getChoicePath(choice, options.optionValue ?? "id");
+      const value = getChoicePath(choice, loose().optionValue ?? "id");
       return value !== void 0 ? value : choice.id;
     },
     getDisableValue(choice) {
-      return getChoicePath(choice, options.disableValue ?? "disabled");
+      return getChoicePath(choice, loose().disableValue ?? "disabled");
     }
   };
 }

package/dist/components/admin/auth/auth-error.vue.d.ts

@@ -7,7 +7,7 @@ export interface AuthErrorProps {
     class?: string;
 }
 declare const _default: import("vue").DefineComponent<AuthErrorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AuthErrorProps> & Readonly<{}>, {
-    message: string;
     title: string;
+    message: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/admin/buttons/save-button.vue.d.ts

@@ -7,8 +7,8 @@ export interface SaveButtonProps {
     class?: string;
 }
 declare const _default: import("vue").DefineComponent<SaveButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SaveButtonProps> & Readonly<{}>, {
-    label: string;
     variant: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+    label: string;
     alwaysEnable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/admin/buttons/update-button.vue.d.ts

@@ -29,16 +29,16 @@ export interface UpdateButtonProps {
 }
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<UpdateButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     click: (e?: MouseEvent | undefined) => any;
-    error: (error: unknown) => any;
     success: (data: LooseRecord) => any;
+    error: (error: unknown) => any;
 }, string, import("vue").PublicProps, Readonly<UpdateButtonProps> & Readonly<{
     onClick?: ((e?: MouseEvent | undefined) => any) | undefined;
-    onError?: ((error: unknown) => any) | undefined;
     onSuccess?: ((data: LooseRecord) => any) | undefined;
+    onError?: ((error: unknown) => any) | undefined;
 }>, {
     variant: "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
-    confirmColor: "primary" | "warning";
     mutationMode: MutationMode;
+    confirmColor: "primary" | "warning";
     confirmTitle: string;
     confirmContent: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {

package/dist/components/admin/feedback/linear-progress.vue.d.ts

@@ -10,7 +10,7 @@ export interface LinearProgressProps {
     class?: string;
 }
 declare const _default: import("vue").DefineComponent<LinearProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<LinearProgressProps> & Readonly<{}>, {
-    timeout: number;
     max: number;
+    timeout: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/admin/fields/api-key-field.vue.d.ts

@@ -1,16 +1,34 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceKey, SourceProp } from "@chelone/core";
 /** Props for {@link ApiKeyField}. */
-export interface ApiKeyFieldProps {
-    source: string;
-    record?: LooseRecord;
+export interface ApiKeyFieldProps<RecordType extends LooseRecord = LooseRecord> {
+    source: SourceProp;
+    /** The record to render. Defaults to the ambient `RecordContext` value. */
+    record?: RecordType;
     defaultValue?: unknown;
-    /** Record field with scope strings. Renders chips when set. */
-    scopesSource?: string;
-    /** Record field with an ISO last-used timestamp. */
-    lastUsedSource?: string;
+    /**
+     * Sibling record field with scope strings; renders chips when set. A
+     * top-level key, not a path: the read is `record[scopesSource]`.
+     */
+    scopesSource?: SourceKey<RecordType>;
+    /**
+     * Sibling record field with an ISO last-used timestamp. A top-level key, not
+     * a path: the read is `record[lastUsedSource]`.
+     */
+    lastUsedSource?: SourceKey<RecordType>;
     /** 'last4' shows the trailing 4 chars; 'full' masks everything. */
     maskedFormat?: "last4" | "full";
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<ApiKeyFieldProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ApiKeyFieldProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: <RecordType extends LooseRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, never> & ApiKeyFieldProps<RecordType> & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
 export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/admin/fields/api-key-field.vue.js

@@ -61,7 +61,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       defaultValue: props.defaultValue
     });
     const injectedRecord = inject(RecordContextKey, null);
-    const ctxRecord = computed(() => props.record ?? injectedRecord?.value);
+    const ctxRecord = computed(
+      () => props.record ?? injectedRecord?.value
+    );
     const revealed = ref(false);
     const copied = ref(false);
     const key = computed(() => value.value == null ? null : String(value.value));

package/dist/components/admin/fields/array-field.vue.d.ts

@@ -1,8 +1,8 @@
-import type { FilterPayload, LooseRecord, SortPayload } from "@chelone/core";
+import type { FilterPayload, LooseRecord, SortPayload, SourceProp } from "@chelone/core";
 /** Props for {@link ArrayField}. */
 export interface ArrayFieldProps {
     /** The field path to the array on the current record. */
-    source: string;
+    source: SourceProp;
     /** The record to read. Defaults to the ambient `RecordContext` value. */
     record?: LooseRecord;
     /** Returned when the resolved value is `undefined`. */

package/dist/components/admin/fields/badge-field.vue.d.ts

@@ -1,8 +1,8 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 import type { BadgeVariant } from "../../ui/badge.js";
 /** Props for {@link BadgeField}. */
 export interface BadgeFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/boolean-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link BooleanField}. */
 export interface BooleanFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     /** Label shown (as a native `title` tooltip) when the value is truthy. */

package/dist/components/admin/fields/chip-field.vue.d.ts

@@ -1,8 +1,8 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 import type { BadgeVariant } from "../../ui/badge.js";
 /** Props for {@link ChipField}. */
 export interface ChipFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/color-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link ColorField}. */
 export interface ColorFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/cron-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link CronField}. */
 export interface CronFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/currency-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link CurrencyField}. */
 export interface CurrencyFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/date-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link DateField}. */
 export interface DateFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/duration-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link DurationField}. */
 export interface DurationFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/email-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link EmailField}. */
 export interface EmailFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/file-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link FileField}. */
 export interface FileFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/function-field.vue.d.ts

@@ -1,9 +1,9 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link FunctionField}. */
-export interface FunctionFieldProps<RecordType = LooseRecord> {
+export interface FunctionFieldProps<RecordType extends LooseRecord = LooseRecord> {
     record?: RecordType;
     /** Optional source, forwarded to the default slot for convenience. */
-    source?: string;
+    source?: SourceProp<RecordType>;
     class?: string;
 }
 declare const _default: <RecordType extends LooseRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{

package/dist/components/admin/fields/image-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link ImageField}. */
 export interface ImageFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/json-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link JsonField}. */
 export interface JsonFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/number-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link NumberField}. */
 export interface NumberFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/phone-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link PhoneField}. */
 export interface PhoneFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/rating-field.vue.d.ts

@@ -1,17 +1,32 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceKey, SourceProp } from "@chelone/core";
 /** Props for {@link RatingField}. */
-export interface RatingFieldProps {
-    source: string;
-    record?: LooseRecord;
+export interface RatingFieldProps<RecordType extends LooseRecord = LooseRecord> {
+    source: SourceProp;
+    /** The record to render. Defaults to the ambient `RecordContext` value. */
+    record?: RecordType;
     defaultValue?: unknown;
     empty?: string;
     /** Total stars rendered (filled + outlined). Default 5. */
     max?: number;
     /** Allow half-star granularity when the value falls between integers. */
     allowHalf?: boolean;
-    /** Sibling record source rendered in parentheses (e.g. a review count). */
-    countSource?: string;
+    /**
+     * Sibling record field rendered in parentheses (e.g. a review count). A
+     * top-level key, not a path: the read is `record[countSource]`.
+     */
+    countSource?: SourceKey<RecordType>;
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<RatingFieldProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RatingFieldProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: <RecordType extends LooseRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, never> & RatingFieldProps<RecordType> & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
 export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/admin/fields/rating-field.vue.js

@@ -30,7 +30,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       defaultValue: props.defaultValue
     });
     const injectedRecord = inject(RecordContextKey, null);
-    const ctxRecord = computed(() => props.record ?? injectedRecord?.value);
+    const ctxRecord = computed(
+      () => props.record ?? injectedRecord?.value
+    );
     const translate = useTranslate();
     const count = computed(() => {
       const rec = ctxRecord.value;

package/dist/components/admin/fields/record-field.vue.d.ts

@@ -1,8 +1,8 @@
 import type { Component } from "vue";
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link RecordField}. */
-export interface RecordFieldProps<RecordType = LooseRecord> {
-    source?: string;
+export interface RecordFieldProps<RecordType extends LooseRecord = LooseRecord> {
+    source?: SourceProp<RecordType>;
     /** Explicit label, or `false`/`""` to hide it. Absent → humanized `source`. */
     label?: string | false;
     /** Override the ambient resource (reserved for label i18n; inert in V1). */

package/dist/components/admin/fields/reference-array-field.vue.d.ts

@@ -1,8 +1,8 @@
-import type { FilterPayload, LooseRecord, SortPayload } from "@chelone/core";
+import type { FilterPayload, LooseRecord, SortPayload, SourceProp } from "@chelone/core";
 /** Props for {@link ReferenceArrayField}. */
 export interface ReferenceArrayFieldProps {
     /** The FK-array field on the current record (e.g. `"tag_ids"`). */
-    source: string;
+    source: SourceProp;
     /** The referenced resource the ids point at (e.g. `"tags"`). */
     reference: string;
     /** The record to read the FK array off. Defaults to the ambient record. */

package/dist/components/admin/fields/reference-field.vue.d.ts

@@ -19,10 +19,11 @@
  * `<DataTable>` row click does not also fire.
  */
 import type { LooseRecord } from "@chelone/core";
+import type { SourceProp } from "@chelone/core";
 import type { LinkToType } from "../../../router/index.js";
 /** Props for {@link ReferenceField}. */
 export interface ReferenceFieldProps {
-    source: string;
+    source: SourceProp;
     reference: string;
     record?: LooseRecord;
     empty?: string;

package/dist/components/admin/fields/reference-many-count.vue.d.ts

@@ -1,4 +1,4 @@
-import type { FilterPayload, LooseRecord } from "@chelone/core";
+import type { FilterPayload, LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link ReferenceManyCount}. */
 export interface ReferenceManyCountProps {
     /** The referenced resource holding the reverse FK (e.g. `"books"`). */
@@ -6,7 +6,7 @@ export interface ReferenceManyCountProps {
     /** The FK field on the reference pointing back at this record (e.g. `"author_id"`). */
     target: string;
     /** The field on the current record the `target` matches. Default `"id"`. */
-    source?: string;
+    source?: SourceProp;
     /** The record whose id is matched. Defaults to the ambient record. */
     record?: LooseRecord;
     /** Permanent filter merged into the lookup, so only matching rows are counted. */

package/dist/components/admin/fields/reference-many-field.vue.d.ts

@@ -1,4 +1,4 @@
-import type { FilterPayload, LooseRecord, SortPayload } from "@chelone/core";
+import type { FilterPayload, LooseRecord, SortPayload, SourceProp } from "@chelone/core";
 /** Props for {@link ReferenceManyField}. */
 export interface ReferenceManyFieldProps {
     /** The referenced resource holding the reverse FK (e.g. `"books"`). */
@@ -6,7 +6,7 @@ export interface ReferenceManyFieldProps {
     /** The FK field on the reference pointing back at this record (e.g. `"author_id"`). */
     target: string;
     /** The field on the current record the `target` matches. Default `"id"`. */
-    source?: string;
+    source?: SourceProp;
     /** The record whose id is matched. Defaults to the ambient record. */
     record?: LooseRecord;
     /** Initial sort of the related list. Default id ascending. */

package/dist/components/admin/fields/reference-one-field.vue.d.ts

@@ -1,4 +1,4 @@
-import type { FilterPayload, LooseRecord, SortPayload } from "@chelone/core";
+import type { FilterPayload, LooseRecord, SortPayload, SourceProp } from "@chelone/core";
 /** Props for {@link ReferenceOneField}. */
 export interface ReferenceOneFieldProps {
     /** The referenced resource holding the one-to-one record (e.g. `"bios"`). */
@@ -6,7 +6,7 @@ export interface ReferenceOneFieldProps {
     /** The FK field on the reference pointing back at this record (e.g. `"author_id"`). */
     target: string;
     /** The field on the current record the `target` matches. Default `"id"`. */
-    source?: string;
+    source?: SourceProp;
     /** The record whose id is matched. Defaults to the ambient record. */
     record?: LooseRecord;
     /** Sort applied to the reference lookup (the first match is used). Read when the record id changes; remount with a `key` to change it otherwise. */

package/dist/components/admin/fields/select-field.vue.d.ts

@@ -1,20 +1,31 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourcePath, SourceProp } from "@chelone/core";
 import type { ChoiceRecord, OptionText } from "../../../choices/use-choices.js";
 /** Props for {@link SelectField}. */
-export interface SelectFieldProps {
-    source: string;
+export interface SelectFieldProps<TChoice extends ChoiceRecord = ChoiceRecord> {
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;
     /** The list of choices to map the value against. */
-    choices?: readonly ChoiceRecord[];
+    choices?: readonly TChoice[];
     /** The value path on a choice. Default `'id'`. */
-    optionValue?: string;
+    optionValue?: SourcePath<TChoice>;
     /** The display path or a formatter. Default `'name'`. */
-    optionText?: OptionText;
+    optionText?: OptionText<TChoice>;
     /** Translate a string-path text through the catalog. Default `true`. */
     translateChoice?: boolean;
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<SelectFieldProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SelectFieldProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: <TChoice extends ChoiceRecord = ChoiceRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{} & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, never> & SelectFieldProps<TChoice> & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
 export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/admin/fields/select-field.vue.js

@@ -11,7 +11,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     empty: {},
     choices: {},
     optionValue: {},
-    optionText: { type: [String, Function] },
+    optionText: { type: Function },
     translateChoice: { type: Boolean },
     class: {}
   },

package/dist/components/admin/fields/subscription-plan-field.vue.d.ts

@@ -1,9 +1,9 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 import type { SubscriptionPlan } from "../inputs/subscription-plan-picker.vue.js";
 export type { SubscriptionPlan };
 /** Props for {@link SubscriptionPlanField}. */
 export interface SubscriptionPlanFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/text-array-field.vue.d.ts

@@ -1,8 +1,8 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 import type { BadgeVariant } from "../../ui/badge.js";
 /** Props for {@link TextArrayField}. */
 export interface TextArrayFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/text-field.vue.d.ts

@@ -1,13 +1,7 @@
-/**
- * `<TextField>` — displays a text value from a record field, the Vue analog of
- * `@chelone/react`'s `fields/text-field.tsx`. Reads the value at `source` off
- * the ambient (or overridden) record via `useFieldValue` and renders it in a
- * `<span>`. A nullish value renders the `empty` fallback (or nothing).
- */
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link TextField}. */
 export interface TextFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

package/dist/components/admin/fields/url-field.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link UrlField}. */
 export interface UrlFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;