@chelone/vue 0.3.0 → 0.4.0

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

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

@@ -4,10 +4,10 @@
  * incomplete number (`-`, `0.`) before it is parsed, and writes `null` (not `0`)
  * on empty so required validation still triggers. Binds through `useInput`.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link NumberInput}. */
 export interface NumberInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

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

@@ -7,10 +7,10 @@
  * Icon note: the Vue slice is dependency-free (no `lucide-vue-next`), so the
  * eye / eye-off glyphs are inlined SVGs mirroring lucide's paths.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link PasswordInput}. */
 export interface PasswordInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     initiallyVisible?: boolean;
     defaultValue?: unknown;

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

@@ -5,11 +5,11 @@
  * `libphonenumber-js` (the same dep the twin uses); `AsYouType` formats while
  * typing and `parsePhoneNumber(...).number` normalizes on write-back.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 import { type CountryCode } from "libphonenumber-js";
 /** Props for {@link PhoneInput}. */
 export interface PhoneInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     defaultValue?: unknown;
     validate?: Validator | readonly Validator[];

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

@@ -6,8 +6,8 @@ export interface RadioButtonGroupInputProps extends ChoiceInputBaseProps {
 }
 declare const _default: import("vue").DefineComponent<RadioButtonGroupInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<RadioButtonGroupInputProps> & 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/rating-input.vue.d.ts

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

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

@@ -1,8 +1,8 @@
-import type { FilterPayload, SortPayload } from "@chelone/core";
+import type { FilterPayload, SortPayload, SourceProp } from "@chelone/core";
 /** Props for {@link ReferenceArrayInput}. */
 export interface ReferenceArrayInputProps {
     /** The FK-array field on the current record (e.g. `"tag_ids"`). */
-    source: string;
+    source: SourceProp;
     /** The referenced resource choices are fetched from (e.g. `"tags"`). */
     reference: string;
     /**

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

@@ -7,10 +7,10 @@
  * native `<select>` (the reka-ui combobox autocomplete is a later wave — spec
  * Risk 1). Choice labels use the reference's record representation.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link ReferenceInput}. */
 export interface ReferenceInputProps {
-    source: string;
+    source: SourceProp;
     reference: string;
     label?: string | false;
     perPage?: number;

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

@@ -12,9 +12,10 @@
  * registration) and clear via the same `form.setFieldValue(wrappedSource, "")`.
  */
 import type { Validator } from "@chelone/core";
+import type { SourceProp } from "@chelone/core";
 /** Props for {@link ResettableTextInput}. */
 export interface ResettableTextInputProps {
-    source: string;
+    source: SourceProp;
     label?: string | false;
     resettable?: boolean;
     clearAlwaysVisible?: boolean;

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

@@ -5,10 +5,10 @@
  * form store and clears via `form.setFieldValue`. It throws if given a `label`
  * (use `<TextInput>` when a label is needed) — mirroring the React twin.
  */
-import type { Validator } from "@chelone/core";
+import type { SourceProp, Validator } from "@chelone/core";
 /** Props for {@link SearchInput}. */
 export interface SearchInputProps {
-    source?: string;
+    source?: SourceProp;
     label?: string | false;
     disableClearable?: boolean;
     defaultValue?: unknown;
@@ -18,7 +18,7 @@ export interface SearchInputProps {
     class?: string;
 }
 declare const _default: import("vue").DefineComponent<SearchInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SearchInputProps> & Readonly<{}>, {
-    source: string;
+    source: SourceProp;
     disableClearable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -1,11 +1,20 @@
+import type { ChoiceRecord } from "../../../choices/use-choices.js";
 import type { ChoiceInputBaseProps } from "./choice-input-props.js";
 /** Props for {@link SelectArrayInput}. */
-export interface SelectArrayInputProps extends ChoiceInputBaseProps {
+export interface SelectArrayInputProps<TChoice extends ChoiceRecord = ChoiceRecord> extends ChoiceInputBaseProps<TChoice> {
     /** Placeholder shown in the trigger when nothing is selected. */
     placeholder?: string;
 }
-declare const _default: import("vue").DefineComponent<SelectArrayInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SelectArrayInputProps> & Readonly<{}>, {
-    label: string | false;
-    disableValue: string;
-}, {}, {}, {}, 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> & SelectArrayInputProps<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/select-array-input.vue.js

@@ -36,7 +36,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     choices: {},
     optionText: {},
     optionValue: {},
-    disableValue: { default: "disabled" },
+    disableValue: {},
     translateChoice: { type: Boolean },
     label: { type: [String, Boolean], default: void 0 },
     helperText: {},