@chelone/vue 0.2.0 → 0.4.0

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,8 +1,8 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 import type { ChoiceRecord, OptionText } from "../../../choices/use-choices.js";
 /** Props for {@link SelectField}. */
 export interface SelectFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     empty?: string;

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: {},
     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;

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

@@ -1,21 +1,36 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceKey, SourceProp } from "@chelone/core";
 /** Ratio thresholds toggling the warning / critical bar color. */
 export interface UsageMeterThresholds {
     warning: number;
     critical: number;
 }
 /** Props for {@link UsageMeterField}. */
-export interface UsageMeterFieldProps {
-    source: string;
-    record?: LooseRecord;
+export interface UsageMeterFieldProps<RecordType extends LooseRecord = LooseRecord> {
+    source: SourceProp;
+    /** The record to render. Defaults to the ambient `RecordContext` value. */
+    record?: RecordType;
     defaultValue?: unknown;
-    /** Sibling record field holding the limit/quota. Bar is only shown when set. */
-    limitSource?: string;
+    /**
+     * Sibling record field holding the limit/quota; the bar is only shown when
+     * set. A top-level key, not a path: the read is `record[limitSource]`.
+     */
+    limitSource?: SourceKey<RecordType>;
     /** Optional unit suffix (e.g. "GB", "requests"). */
     unit?: string;
     /** Ratio thresholds. Defaults `{ warning: 0.8, critical: 1.0 }`. */
     thresholds?: UsageMeterThresholds;
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<UsageMeterFieldProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<UsageMeterFieldProps> & 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> & UsageMeterFieldProps<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/usage-meter-field.vue.js

@@ -28,7 +28,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       () => typeof value.value === "number" ? value.value : value.value
     );
     const injectedRecord = inject(RecordContextKey, null);
-    const ctxRecord = computed(() => props.record ?? injectedRecord?.value);
+    const ctxRecord = computed(
+      () => props.record ?? injectedRecord?.value
+    );
     const limit = computed(() => {
       const rec = ctxRecord.value;
       if (!props.limitSource || !rec) return void 0;

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

@@ -1,4 +1,4 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** A webhook delivery outcome. */
 export type DeliveryStatus = "ok" | "failed" | "pending";
 /** The shape `<WebhookEndpointField>` reads from a record source. */
@@ -13,7 +13,7 @@ export interface WebhookEndpoint {
 }
 /** Props for {@link WebhookEndpointField}. */
 export interface WebhookEndpointFieldProps {
-    source: string;
+    source: SourceProp;
     record?: LooseRecord;
     defaultValue?: unknown;
     class?: string;

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

@@ -1,16 +1,16 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link WrapperField}. */
 export interface WrapperFieldProps {
     /**
      * A pseudo field path exposed to a parent layout (e.g. a sortable
      * `DataTable` header). Not read by the field itself — it only groups children.
      */
-    source?: string;
+    source?: SourceProp;
     label?: string | false;
     record?: LooseRecord;
     class?: string;
 }
-declare const _default: __VLS_WithSlots<import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
+declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WrapperFieldProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WrapperFieldProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     /** The wrapped fields, rendered as-is. */
     default(): unknown;
 }>;

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

@@ -1,6 +1,12 @@
 import { defineComponent, renderSlot } from "vue";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "wrapper-field",
+  props: {
+    source: {},
+    label: { type: [String, Boolean] },
+    record: {},
+    class: {}
+  },
   setup(__props) {
     return (_ctx, _cache) => {
       return renderSlot(_ctx.$slots, "default");

package/dist/components/admin/inputs/api-key-input.vue.d.ts

@@ -1,8 +1,8 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link ApiKeyInput}. */
 export interface ApiKeyInputProps {
     /** Record field holding the API key. */
-    source: string;
+    source: SourceProp;
     /** Override resource. */
     resource?: string;
     /** Async side-effect on rotate. When provided, replaces the default update mutation. */

package/dist/components/admin/inputs/array-input.vue.d.ts

@@ -1,8 +1,8 @@
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link ArrayInput}. */
 export interface ArrayInputProps {
     /** The array field path RELATIVE to the ambient source scope. */
-    source: string;
+    source: SourceProp;
     /** Explicit label, or `false` to hide it. Absent → humanized `source`. */
     label?: string | false;
     /** Override the ambient resource (label-key resolution). */

package/dist/components/admin/inputs/autocomplete-array-input.vue.d.ts

@@ -1,7 +1,8 @@
+import type { ChoiceRecord } from "../../../choices/use-choices.js";
 import type { FilterPayload } from "@chelone/core";
 import type { ChoiceInputBaseProps } from "./choice-input-props.js";
 /** Props for {@link AutocompleteArrayInput}. */
-export interface AutocompleteArrayInputProps extends ChoiceInputBaseProps {
+export interface AutocompleteArrayInputProps<TChoice extends ChoiceRecord = ChoiceRecord> extends ChoiceInputBaseProps<TChoice> {
     /** Placeholder shown in the search input. */
     placeholder?: string;
     /** Maps the typed filter text into a reference-list filter payload. Default `{ q }`. */
@@ -9,9 +10,16 @@ export interface AutocompleteArrayInputProps extends ChoiceInputBaseProps {
     /** Content shown when no choice matches the filter. */
     noOptionsText?: string;
 }
-declare const _default: import("vue").DefineComponent<AutocompleteArrayInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AutocompleteArrayInputProps> & Readonly<{}>, {
-    label: string | false;
-    optionValue: string;
-    filterToQuery: (searchText: string) => FilterPayload;
-}, {}, {}, {}, 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> & AutocompleteArrayInputProps<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/inputs/autocomplete-array-input.vue.js

@@ -31,7 +31,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     source: {},
     choices: {},
     optionText: {},
-    optionValue: { default: "id" },
+    optionValue: {},
     disableValue: {},
     translateChoice: { type: Boolean },
     label: { type: [String, Boolean], default: void 0 },
@@ -61,8 +61,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       optionText: props.optionText,
       optionValue: props.optionValue,
       disableValue: props.disableValue,
-      translateChoice: props.translateChoice,
-      defaultOptionText: "name"
+      translateChoice: props.translateChoice
     });
     const { id, value, setValue, blur, error, touched, isRequired } = useInput({
       source,

package/dist/components/admin/inputs/autocomplete-input.vue.d.ts

@@ -1,7 +1,8 @@
+import type { ChoiceRecord } from "../../../choices/use-choices.js";
 import type { FilterPayload } from "@chelone/core";
 import type { ChoiceInputBaseProps } from "./choice-input-props.js";
 /** Props for {@link AutocompleteInput}. */
-export interface AutocompleteInputProps extends ChoiceInputBaseProps {
+export interface AutocompleteInputProps<TChoice extends ChoiceRecord = ChoiceRecord> extends ChoiceInputBaseProps<TChoice> {
     /** Placeholder shown in the search input. */
     placeholder?: string;
     /** Maps the typed filter text into a reference-list filter payload. Default `{ q }`. */
@@ -9,9 +10,16 @@ export interface AutocompleteInputProps extends ChoiceInputBaseProps {
     /** Content shown when no choice matches the filter. */
     noOptionsText?: string;
 }
-declare const _default: import("vue").DefineComponent<AutocompleteInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AutocompleteInputProps> & Readonly<{}>, {
-    label: string | false;
-    optionValue: string;
-    filterToQuery: (searchText: string) => FilterPayload;
-}, {}, {}, {}, 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> & AutocompleteInputProps<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/inputs/autocomplete-input.vue.js

@@ -28,7 +28,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     source: {},
     choices: {},
     optionText: {},
-    optionValue: { default: "id" },
+    optionValue: {},
     disableValue: {},
     translateChoice: { type: Boolean },
     label: { type: [String, Boolean], default: void 0 },
@@ -57,8 +57,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       optionText: props.optionText,
       optionValue: props.optionValue,
       disableValue: props.disableValue,
-      translateChoice: props.translateChoice,
-      defaultOptionText: "name"
+      translateChoice: props.translateChoice
     });
     const { id, value, setValue, blur, error, touched, isRequired } = useInput({
       source,

package/dist/components/admin/inputs/boolean-input.vue.d.ts

@@ -4,10 +4,10 @@
  * renders the shadcn `Switch`. Writes a plain boolean; marks the field blurred
  * on change so validation surfaces on interaction.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link BooleanInput}. */
 export interface BooleanInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: boolean;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/checkbox-group-input.vue.d.ts

@@ -6,8 +6,8 @@ export interface CheckboxGroupInputProps extends ChoiceInputBaseProps {
 }
 declare const _default: import("vue").DefineComponent<CheckboxGroupInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CheckboxGroupInputProps> & Readonly<{}>, {
     label: string | false;
-    row: boolean;
     optionValue: string;
+    row: boolean;
     disableValue: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/dist/components/admin/inputs/choice-input-props.d.ts

@@ -6,20 +6,20 @@
  * input nested under a reference wrapper inherits `source` from the ambient
  * choices context; standalone, it must be provided (each input throws otherwise).
  */
-import type { Validator } from "@chelone/core";
+import type { SourcePath, SourceProp, Validator } from "@chelone/core";
 import type { ChoiceRecord, OptionText } from "../../../choices/use-choices.js";
 /** The choice-accessor + form-binding props every choice input accepts. */
-export interface ChoiceInputBaseProps {
+export interface ChoiceInputBaseProps<TChoice extends ChoiceRecord = ChoiceRecord> {
     /** The FK/field path. Optional under a reference wrapper (inherited from context). */
-    source?: string;
+    source?: SourceProp | undefined;
     /** Inline choices (`{ id, name }[]` or `string[]`). Omitted under a reference wrapper. */
-    choices?: readonly (string | ChoiceRecord)[];
+    choices?: readonly (string | TChoice)[];
     /** The display path (dotted) or a formatter over the whole choice. 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 label through the catalog. Default `!isFromReference`. */
     translateChoice?: boolean;
     /** Explicit label, or `false` to hide it. Absent → humanized `source`. */

package/dist/components/admin/inputs/color-input.vue.d.ts

@@ -7,10 +7,10 @@
  * NATIVE `<input type="color">` — the same value contract (a hex string) — plus
  * the optional quick-set `swatches` row. Binds via `useInput` + `<ValidationError>`.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link ColorInput}. */
 export interface ColorInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/cron-input.vue.d.ts

@@ -1,7 +1,7 @@
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link CronInput}. */
 export interface CronInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/currency-input.vue.d.ts

@@ -6,10 +6,10 @@
  * `displayLocale`, falling back to the ambient i18n locale. A focused-buffer
  * keeps the display string stable while typing.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link CurrencyInput}. */
 export interface CurrencyInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/date-input.vue.d.ts

@@ -8,10 +8,10 @@
  * clobbered while typing — the twin's uncontrolled `defaultValue` + `key`-remount
  * dance (born of RHF's `field.ref`) maps to a focused-buffer + external re-sync.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link DateInput}. */
 export interface DateInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/date-time-input.vue.d.ts

@@ -6,10 +6,10 @@
  * → `null`, so a required validator fires. Same focused-buffer pattern as
  * `<DateInput>`.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link DateTimeInput}. */
 export interface DateTimeInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/duration-input.vue.d.ts

@@ -4,11 +4,11 @@
  * `inputs/duration-input.tsx`. Reads the stored string into day/hour/minute/
  * second boxes and writes the recomposed ISO string back (all-empty → `null`).
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 type Unit = "d" | "h" | "m" | "s";
 /** Props for {@link DurationInput}. */
 export interface DurationInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

package/dist/components/admin/inputs/file-input.vue.d.ts

@@ -1,4 +1,4 @@
-import type { LooseRecord, Validator } from "@chelone/core";
+import type { LooseRecord, SourceProp, Validator } from "@chelone/core";
 /** A dropped file transformed into a preview record. */
 export interface TransformedFile {
     rawFile: File & {
@@ -10,7 +10,7 @@ export interface TransformedFile {
 /** Props for {@link FileInput}. */
 export interface FileInputProps {
     /** The file field path. */
-    source: string;
+    source: SourceProp;
     /** Explicit label, or `false` to hide it. Absent → humanized `source`. */
     label?: string | false;
     /** Override the ambient resource (label-key resolution). */

package/dist/components/admin/inputs/nullable-boolean-input.vue.d.ts

@@ -10,10 +10,10 @@
  * `<select>`, which accepts `""` directly — so the empty option IS the null
  * value, no sentinel round-trip.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link NullableBooleanInput}. */
 export interface NullableBooleanInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     nullLabel?: string;
     trueLabel?: string;