@chelone/vue 0.1.1 → 0.3.0

package/dist/admin/admin-shell.vue.js

@@ -4,7 +4,7 @@ import { useRoute, useRouter, START_LOCATION } from "vue-router";
 import _sfc_main$6 from "../components/admin/layout/layout.vue.js";
 import _sfc_main$1 from "../components/admin/layout/theme-provider.vue.js";
 import _sfc_main$4 from "../components/admin/auth/login-page.vue.js";
-import _sfc_main$3 from "../components/ui/spinner.vue.js";
+import _sfc_main$3 from "../components/ui/spinner2.vue.js";
 import { useBasename } from "../router/adapter.js";
 import { useWatchDataErrors } from "../auth/permissions-hooks.js";
 import { useAuthGate } from "./auth-gate.js";

package/dist/admin/admin.vue.js

@@ -1,5 +1,5 @@
 import { defineComponent, provide, useSlots, onScopeDispose, onBeforeUpdate, watchEffect, openBlock, createElementBlock, Fragment, renderSlot, createVNode, createSlots, withCtx, normalizeProps, guardReactiveProps } from "vue";
-import { joinBasename } from "@chelone/core";
+import { createI18n, englishMessages, joinBasename } from "@chelone/core";
 import { BasenameKey } from "../router/adapter.js";
 import { QueryClient, VUE_QUERY_CLIENT } from "@tanstack/vue-query";
 import { useRouter, START_LOCATION } from "vue-router";
@@ -44,7 +44,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       dataProvider: props.dataProvider,
       queryClient,
       authProvider: props.authProvider,
-      i18n: props.i18n,
+      // Built once, and only when the app brings no i18n of its own.
+      i18n: props.i18n ?? createI18n({ locale: "en", messages: { en: englishMessages } }),
       store: props.store,
       notifications: props.notifications,
       // Thread the zod registry so `useForm({ resource })` auto-resolves the

package/dist/array/use-array-input.d.ts

@@ -18,11 +18,11 @@
  * array field's error/meta ride a separate {@link useSubscribable} over the field
  * binding, projected through `computed`.
  */
-import type { ArrayBindingUpdateOptions, ArrayRow, SourceScope, TranslatableMessage } from "@chelone/core";
+import type { ArrayBindingUpdateOptions, ArrayRow, SourcePath, SourceScope, TranslatableMessage } from "@chelone/core";
 import { type ComputedRef, type Ref } from "vue";
-export interface UseArrayInputOptions extends ArrayBindingUpdateOptions {
+export interface UseArrayInputOptions<TRecord = unknown> extends ArrayBindingUpdateOptions {
     /** The array field path RELATIVE to the ambient source scope. */
-    source: string;
+    source: SourcePath<TRecord>;
 }
 /** The array field's own reactive error state (min-length validators, etc.). */
 export interface ArrayFieldState {
@@ -52,4 +52,5 @@ export interface UseArrayInputResult {
     clear(): void;
     fieldState: ArrayFieldState;
 }
+export declare function useArrayInput<TRecord>(options: UseArrayInputOptions<TRecord>): UseArrayInputResult;
 export declare function useArrayInput(options: UseArrayInputOptions): UseArrayInputResult;

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

@@ -15,7 +15,7 @@
  */
 /** An erased choice record — choices carry arbitrary shapes (`{id, name, ...}`). */
 export type ChoiceRecord = Record<string, unknown>;
-/** The display path (dotted) or a formatter over the whole choice. */
+/** The display path (dot or bracket) or a formatter over the whole choice. */
 export type OptionText = string | ((choice: ChoiceRecord) => string);
 export interface UseChoicesOptions {
     /** The display path or a formatter. Default `'name'`. */
@@ -36,7 +36,13 @@ export interface UseChoicesResult {
     /** The disabled flag: `get(choice, disableValue)`. */
     getDisableValue(choice: ChoiceRecord): unknown;
 }
-/** Reads a dotted path off a record (`get(choice, 'a.b')`), else `undefined`. */
+/**
+ * Read a choice path off a record with core's one path grammar
+ * ({@link getAtPath}): dot members (`author.name`), bracket indices
+ * (`tags[0].label`) and numeric-dot indices all resolve, and an own flat key
+ * equal to the whole path wins. An empty path reads nothing, where core's
+ * reader returns the record itself. Public in the package barrel.
+ */
 export declare function getChoicePath(record: ChoiceRecord, path: string): unknown;
 /**
  * The choice accessors (ra's `useChoices`): text (string path or formatter,

package/dist/choices/use-choices.js

@@ -1,12 +1,8 @@
+import { getAtPath } from "@chelone/core";
 import { useTranslate } from "../i18n/use-translate.js";
 function getChoicePath(record, path) {
-  if (path in record) return record[path];
-  let current = record;
-  for (const key of path.split(".")) {
-    if (current == null || typeof current !== "object") return void 0;
-    current = current[key];
-  }
-  return current;
+  if (path === "") return void 0;
+  return getAtPath(record, path);
 }
 function useChoices(options = {}) {
   const translate = useTranslate();

package/dist/components/admin/auth/auth-callback.vue.js

@@ -1,6 +1,6 @@
 import { defineComponent, computed, unref, openBlock, createBlock, createElementBlock, createVNode } from "vue";
 import { useHandleAuthCallback } from "../../../admin/auth-gate.js";
-import _sfc_main$2 from "../../ui/spinner.vue.js";
+import _sfc_main$2 from "../../ui/spinner2.vue.js";
 import _sfc_main$1 from "./auth-error.vue.js";
 const _hoisted_1 = {
   key: 1,

package/dist/components/admin/auth/login-form.vue.js

@@ -6,7 +6,7 @@ import { useTranslate } from "../../../i18n/use-translate.js";
 import { cn } from "../../../lib/utils.js";
 import { useLogin } from "../../../auth/auth-hooks.js";
 import _sfc_main$2 from "../../ui/button.vue.js";
-import _sfc_main$3 from "../../ui/spinner.vue.js";
+import _sfc_main$3 from "../../ui/spinner2.vue.js";
 import _sfc_main$1 from "../inputs/text-input.vue.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "login-form",

package/dist/components/admin/auth/login-with-email.vue.js

@@ -6,7 +6,7 @@ import { useForm } from "../../../form/use-form.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { cn } from "../../../lib/utils.js";
 import _sfc_main$3 from "../../ui/button.vue.js";
-import _sfc_main$4 from "../../ui/spinner.vue.js";
+import _sfc_main$4 from "../../ui/spinner2.vue.js";
 import _sfc_main$2 from "../inputs/password-input.vue.js";
 import _sfc_main$1 from "../inputs/text-input.vue.js";
 import { LogInIcon } from "./icons.js";

package/dist/components/admin/buttons/delete-button.vue.js

@@ -3,6 +3,8 @@ import { removeRecordsFromCache } from "@chelone/core";
 import { useCheloneContext } from "../../../context.js";
 import { useUndoable } from "../../../data/undoable.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
+import { humanize, pluralize } from "../../../label/inflection.js";
+import { useGetRecordRepresentation } from "../../../label/use-get-record-representation.js";
 import { RecordContextKey } from "../../../record/record-context.js";
 import { useResourceContext } from "../../../resource-context.js";
 import { useMenuAccess } from "../layout/use-menu-access.js";
@@ -56,6 +58,23 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }))
     );
     const show = computed(() => !isAccessPending.value && canAccess.value);
+    const getRecordRepresentation = useGetRecordRepresentation(resource);
+    const confirmOptions = computed(() => {
+      const representation = getRecordRepresentation(record.value);
+      return {
+        name: translate(`resources.${resource}.forcedCaseName`, {
+          smart_count: 1,
+          _: humanize(
+            translate(`resources.${resource}.name`, {
+              smart_count: 1,
+              _: pluralize(resource, 1)
+            })
+          )
+        }),
+        recordRepresentation: typeof representation === "string" ? representation : "",
+        id: record.value?.id
+      };
+    });
     const label = computed(
       () => translate("ra.action.delete", { _: props.label ?? "Delete" })
     );
@@ -123,9 +142,10 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
           title: __props.confirmTitle,
           content: __props.confirmContent,
           "confirm-color": __props.confirmColor,
+          "translate-options": confirmOptions.value,
           onConfirm,
           onClose: onCancel
-        }, null, 8, ["is-open", "loading", "title", "content", "confirm-color"])) : createCommentVNode("", true)
+        }, null, 8, ["is-open", "loading", "title", "content", "confirm-color", "translate-options"])) : createCommentVNode("", true)
       ], 64);
     };
   }

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

@@ -1,12 +1,12 @@
-import type { LooseRecord, MutationMode } from "@chelone/core";
+import type { MutationMode, SourceKey } from "@chelone/core";
 /** Props for {@link DualApprovalButton}. */
-export interface DualApprovalButtonProps {
+export interface DualApprovalButtonProps<TRecord extends Record<string, unknown> = Record<string, unknown>> {
     /** Approvals needed. Floored, minimum 1. Default `2`. */
     required?: number;
-    /** Record field holding the approver list. Default `"approvers"`. */
-    approverSource?: string;
-    /** Record field the status is written to. Default `"status"`. */
-    statusSource?: string;
+    /** Record field holding the approver list, a top-level key. Default `"approvers"`. */
+    approverSource?: SourceKey<TRecord>;
+    /** Record field the status is written to, a top-level key. Default `"status"`. */
+    statusSource?: SourceKey<TRecord>;
     /** Status written while approvals are short of `required`. Default `"pending"`. */
     pendingValue?: unknown;
     /** Status written once approvals reach `required`. Default `"approved"`. */
@@ -14,18 +14,22 @@ export interface DualApprovalButtonProps {
     /** Override the ambient `<Resource>`. */
     resource?: string;
     /** Override the ambient record. */
-    record?: LooseRecord;
+    record?: TRecord;
     /** How the update is dispatched. Default `"pessimistic"`. */
     mutationMode?: MutationMode;
     /** Extra CSS class appended to the button. */
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<DualApprovalButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DualApprovalButtonProps> & Readonly<{}>, {
-    required: number;
-    mutationMode: MutationMode;
-    approverSource: string;
-    statusSource: string;
-    pendingValue: "pending";
-    approvedValue: "approved";
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: <TRecord extends Record<string, unknown> = Record<string, unknown>>(__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> & DualApprovalButtonProps<TRecord> & 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/buttons/dual-approval-button.vue.js

@@ -36,7 +36,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const props = __props;
     const resource = useResourceContext(props);
     const injectedRecord = inject(RecordContextKey, null);
-    const record = computed(() => props.record ?? injectedRecord?.value);
+    const record = computed(
+      () => props.record ?? injectedRecord?.value
+    );
     const translate = useTranslate();
     const notifications = useCheloneNotifications();
     const { identity } = useOptionalIdentity();

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

@@ -1,7 +1,8 @@
+import type { SourceProp } from "@chelone/core";
 /** Props for {@link SortButton}. */
 export interface SortButtonProps {
     /** The sortable field names offered in the dropdown. */
-    fields: string[];
+    fields: SourceProp[];
     /** Override the auto-translated button label. */
     label?: string;
     /** Extra CSS class appended to the trigger. */

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

@@ -1,8 +1,8 @@
-import type { LooseRecord, MutationMode } from "@chelone/core";
+import type { MutationMode, SourceKey } from "@chelone/core";
 /** Props for {@link StatusTransitionButton}. */
-export interface StatusTransitionButtonProps {
-    /** Record field holding the status. Default `"status"`. */
-    source?: string;
+export interface StatusTransitionButtonProps<TRecord extends Record<string, unknown> = Record<string, unknown>> {
+    /** Record field holding the status, a top-level key. Default `"status"`. */
+    source?: SourceKey<TRecord>;
     /** Next states by current state. */
     transitions: Record<string, readonly string[]>;
     /** Predicates keyed `"<from>-><to>"`. A transition with no guard is allowed. */
@@ -12,7 +12,7 @@ export interface StatusTransitionButtonProps {
     /** Override the ambient `<Resource>`. */
     resource?: string;
     /** Override the ambient record. */
-    record?: LooseRecord;
+    record?: TRecord;
     /** Ask for confirmation before moving the record. Default `false`. */
     confirm?: boolean;
     /** How the update is dispatched. Default `"pessimistic"`. */
@@ -20,13 +20,18 @@ export interface StatusTransitionButtonProps {
     /** Extra CSS class appended to the trigger. */
     class?: string;
 }
-declare const _default: import("vue").DefineComponent<StatusTransitionButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    transition: (from: string, to: string, record: LooseRecord) => any;
-}, string, import("vue").PublicProps, Readonly<StatusTransitionButtonProps> & Readonly<{
-    onTransition?: ((from: string, to: string, record: LooseRecord) => any) | undefined;
-}>, {
-    source: string;
-    confirm: boolean;
-    mutationMode: MutationMode;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: <TRecord extends Record<string, unknown> = Record<string, unknown>>(__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<{
+        readonly onTransition?: ((from: string, to: string, record: TRecord) => any) | undefined;
+    } & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, never>, "onTransition"> & StatusTransitionButtonProps<TRecord> & Partial<{}>> & import("vue").PublicProps;
+    expose(exposed: import("vue").ShallowUnwrapRef<{}>): void;
+    attrs: any;
+    slots: {};
+    emit: (event: "transition", from: string, to: string, record: TRecord) => void;
+}>) => 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/buttons/status-transition-button.vue.js

@@ -37,7 +37,9 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const emit = __emit;
     const resource = useResourceContext(props);
     const injectedRecord = inject(RecordContextKey, null);
-    const record = computed(() => props.record ?? injectedRecord?.value);
+    const record = computed(
+      () => props.record ?? injectedRecord?.value
+    );
     const translate = useTranslate();
     const notifications = useCheloneNotifications();
     const { canAccess, isPending: isAccessPending } = useMenuAccess(

package/dist/components/admin/feedback/loading-indicator.vue.js

@@ -2,7 +2,7 @@ import { defineComponent, computed, openBlock, createElementBlock, normalizeClas
 import { useLoading, useRefresh } from "../../../data/use-refresh.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { cn } from "../../../lib/utils.js";
-import _sfc_main$2 from "../../ui/spinner.vue.js";
+import _sfc_main$2 from "../../ui/spinner2.vue.js";
 import { RotateCwIcon } from "../buttons/icons.js";
 import _sfc_main$1 from "../common/icon-button-with-tooltip.vue.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({

package/dist/components/admin/feedback/spinner.vue.js

@@ -1,6 +1,6 @@
 import { defineComponent, computed, openBlock, createBlock, normalizeClass, createCommentVNode } from "vue";
 import { cn } from "../../../lib/utils.js";
-import _sfc_main$1 from "../../ui/spinner.vue.js";
+import _sfc_main$1 from "../../ui/spinner2.vue.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "spinner",
   props: {

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

@@ -1,5 +1,5 @@
 import { defineComponent, computed, openBlock, createElementBlock, normalizeClass, unref, toDisplayString, Fragment, renderList, createElementVNode, createCommentVNode } from "vue";
-import { getPath } from "./get-path.js";
+import { getAtPath } from "@chelone/core";
 import { cn } from "../../../lib/utils.js";
 import { useFieldValue } from "../../../record/use-field-value.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
@@ -46,8 +46,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const links = computed(() => {
       if (!Array.isArray(sourceValue.value)) return [];
       return sourceValue.value.map((file, index) => {
-        const fileTitleValue = props.title ? getPath(file, props.title) ?? props.title : props.title;
-        const srcValue = props.src ? getPath(file, props.src) ?? props.title : props.title;
+        const fileTitleValue = props.title ? getAtPath(file, props.title) ?? props.title : props.title;
+        const srcValue = props.src ? getAtPath(file, props.src) ?? props.title : props.title;
         return { href: srcValue, title: fileTitleValue, key: srcValue ?? index };
       });
     });

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

@@ -1,5 +1,5 @@
 import { defineComponent, computed, openBlock, createElementBlock, normalizeClass, unref, toDisplayString, createElementVNode, Fragment, renderList, createCommentVNode } from "vue";
-import { getPath } from "./get-path.js";
+import { getAtPath } from "@chelone/core";
 import { cn } from "../../../lib/utils.js";
 import { useFieldValue } from "../../../record/use-field-value.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
@@ -39,8 +39,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const items = computed(() => {
       if (!Array.isArray(value.value)) return [];
       return value.value.map((file, index) => {
-        const fileTitleValue = props.title ? getPath(file, props.title) ?? props.title : props.title;
-        const srcValue = props.src ? getPath(file, props.src) ?? props.title : props.title;
+        const fileTitleValue = props.title ? getAtPath(file, props.title) ?? props.title : props.title;
+        const srcValue = props.src ? getAtPath(file, props.src) ?? props.title : props.title;
         return { src: srcValue, title: fileTitleValue, key: srcValue ?? index };
       });
     });

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

@@ -6,12 +6,12 @@
  * 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 { 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 {
     /** 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)[];
     /** The display path (dotted) or a formatter over the whole choice. Default `name`. */

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

@@ -21,6 +21,7 @@
  * / `resource` / `isFromReference` are stable per context, so they are read once
  * (parity with the twin's `useState` capture of the reference options).
  */
+import type { SourceProp } from "@chelone/core";
 import { type ComputedRef } from "vue";
 import { type ChoiceRecord, type OptionText } from "../../../choices/use-choices.js";
 /** Options for {@link useChoiceInput}. */
@@ -30,7 +31,7 @@ export interface UseChoiceInputOptions {
     /** Inline choices — synthesized into a static context, ignoring any ambient one. */
     choices?: readonly (string | ChoiceRecord)[];
     /** The FK/field path (falls back to the ambient reference context's source). */
-    source?: string;
+    source?: SourceProp | undefined;
     /** The display path or a formatter. */
     optionText?: OptionText;
     /** The value path. Default `id` (via `useChoices`). */

package/dist/components/admin/list/calendar-header.vue.js

@@ -57,7 +57,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             createVNode(_sfc_main$1, {
               variant: "ghost",
               size: "icon",
-              "aria-label": unref(translate)("ra.navigation.previous", { _: "Previous" }),
+              "aria-label": unref(translate)("ra.calendar.previous", { _: "Previous" }),
               onClick: _cache[0] || (_cache[0] = ($event) => emit("navigate", "previous"))
             }, {
               default: withCtx(() => [
@@ -78,7 +78,7 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
             createVNode(_sfc_main$1, {
               variant: "ghost",
               size: "icon",
-              "aria-label": unref(translate)("ra.navigation.next", { _: "Next" }),
+              "aria-label": unref(translate)("ra.calendar.next", { _: "Next" }),
               onClick: _cache[2] || (_cache[2] = ($event) => emit("navigate", "next"))
             }, {
               default: withCtx(() => [

package/dist/components/admin/list/count-spinner.vue.js

@@ -1,5 +1,5 @@
 import { defineComponent, unref, openBlock, createBlock, normalizeClass, createCommentVNode } from "vue";
-import _sfc_main$1 from "../../ui/spinner.vue.js";
+import _sfc_main$1 from "../../ui/spinner2.vue.js";
 import { useTimeout } from "../feedback/use-timeout.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({
   __name: "count-spinner",

package/dist/components/admin/list/data-table-col.vue.d.ts

@@ -1,7 +1,7 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, SourceProp } from "@chelone/core";
 /** Props for {@link DataTableCol}. */
 export interface DataTableColProps {
-    source?: string;
+    source?: SourceProp;
     label?: string;
     /** Applied to both the header and the body cells. */
     class?: string;

package/dist/components/admin/list/data-table-number-col.vue.d.ts

@@ -1,7 +1,8 @@
+import type { SourceProp } from "@chelone/core";
 import type { DataTableColProps } from "./data-table-col.vue.js";
 /** Props for {@link DataTableNumberCol}. */
 export interface DataTableNumberColProps extends Omit<DataTableColProps, "source"> {
-    source: string;
+    source: SourceProp;
     /** BCP 47 locale(s) for `Intl.NumberFormat`. */
     locales?: string | string[];
     /** `Intl.NumberFormatOptions` (currency, percent, fraction digits…). */

package/dist/components/admin/list/filter-form.vue.js

@@ -1,5 +1,5 @@
 import { defineComponent, watch, openBlock, createElementBlock, withModifiers, Fragment, renderList, createBlock, resolveDynamicComponent, mergeProps, unref, createVNode, createCommentVNode, renderSlot } from "vue";
-import { mergeFilterValues, getFilterFormValues, filterFormReflectShape } from "@chelone/core";
+import { mergeFilterValues, getFilterFormValues, filterFormReflectShape, getAtPath } from "@chelone/core";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { useForm } from "../../../form/use-form.js";
 import { useListContext } from "../../../list/list-context.js";
@@ -36,16 +36,8 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
       }
       return false;
     }
-    function valueAt(record, source) {
-      let current = record;
-      for (const key of source.split(".")) {
-        if (current == null || typeof current !== "object") return void 0;
-        current = current[key];
-      }
-      return current;
-    }
     function isShown(entry) {
-      return !!entry.alwaysOn || !!list.displayedFilters?.[entry.source] || !isEmptyValue(valueAt(list.filter, entry.source));
+      return !!entry.alwaysOn || !!list.displayedFilters?.[entry.source] || !isEmptyValue(getAtPath(list.filter, entry.source));
     }
     const { form, values, reset } = useForm({
       resource,

package/dist/components/admin/list/tree-list.vue.d.ts

@@ -18,7 +18,7 @@ import { type LooseRecord } from "@chelone/core";
 import type { Component } from "vue";
 /** Props for {@link TreeList}. */
 export interface TreeListProps {
-    /** The field holding the parent's id; a dotted path reads a nested value. */
+    /** The field holding the parent's id; a dot or bracket path reads a nested value. */
     parentSource: string;
     /** The string field shown as the row title; the record representation otherwise. */
     titleSource?: string;

package/dist/components/admin/list/tree-list.vue.js

@@ -1,5 +1,5 @@
 import { defineComponent, getCurrentInstance, computed, ref, provide, unref, openBlock, createElementBlock, Fragment, renderSlot, createBlock, normalizeClass, renderList } from "vue";
-import { buildRecordTree } from "@chelone/core";
+import { buildRecordTree, getAtPath } from "@chelone/core";
 import { useResourceDefinition } from "../../../admin/resource-registry.js";
 import { useGetRecordRepresentation } from "../../../label/use-get-record-representation.js";
 import { cn } from "../../../lib/utils.js";
@@ -58,22 +58,16 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const linkTo = (record) => resource && type.value ? createPath({ resource, id: record.id, type: type.value }) : void 0;
     function titleFor(record) {
       if (props.titleSource) {
-        const value = readPath(record, props.titleSource);
+        const value = getAtPath(record, props.titleSource);
         if (typeof value === "string") return value;
       }
       return getRepresentation(record);
     }
     function iconFor(record) {
       if (!props.iconSource || !props.iconMap) return void 0;
-      const value = readPath(record, props.iconSource);
+      const value = getAtPath(record, props.iconSource);
       return value == null ? void 0 : props.iconMap[String(value)];
     }
-    function readPath(record, path) {
-      return path.split(".").reduce(
-        (value, key) => value == null ? void 0 : value[key],
-        record
-      );
-    }
     provide(TreeListKey, {
       isExpanded,
       toggle(id) {

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

@@ -6,7 +6,7 @@ import { useForm } from "../../../form/use-form.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { cn } from "../../../lib/utils.js";
 import _sfc_main$2 from "../../ui/button.vue.js";
-import _sfc_main$3 from "../../ui/spinner.vue.js";
+import _sfc_main$3 from "../../ui/spinner2.vue.js";
 import _sfc_main$1 from "../inputs/text-input.vue.js";
 import { useResetPassword } from "./use-password-recovery.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({

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

@@ -6,7 +6,7 @@ import { useForm } from "../../../form/use-form.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
 import { cn } from "../../../lib/utils.js";
 import _sfc_main$2 from "../../ui/button.vue.js";
-import _sfc_main$3 from "../../ui/spinner.vue.js";
+import _sfc_main$3 from "../../ui/spinner2.vue.js";
 import _sfc_main$1 from "../inputs/password-input.vue.js";
 import { useSupabaseUrlTokens, useSetPassword } from "./use-password-recovery.js";
 const _hoisted_1 = {

package/dist/components/maps-osm/osm-feature-operator.vue.js

@@ -6,7 +6,7 @@ import { useTranslate } from "../../i18n/use-translate.js";
 import { useNotify } from "../../notification-hooks.js";
 import { useMapsConfig } from "../maps/use-map.js";
 import _sfc_main$1 from "../ui/button.vue.js";
-import _sfc_main$2 from "../ui/spinner.vue.js";
+import _sfc_main$2 from "../ui/spinner2.vue.js";
 import { fetchOsmFeatures } from "./osm-features.js";
 import { subtractMask, unionAll } from "./osm-geometry-ops.js";
 const _sfc_main = /* @__PURE__ */ defineComponent({

package/dist/components/ui/spinner.vue.js

@@ -1,32 +1,4 @@
-import { defineComponent, computed, openBlock, createElementBlock, normalizeClass, createElementVNode } from "vue";
-import { cn } from "../../lib/utils.js";
-const _sfc_main = /* @__PURE__ */ defineComponent({
-  __name: "spinner",
-  props: {
-    class: {}
-  },
-  setup(__props) {
-    const props = __props;
-    const classes = computed(() => cn("size-4 animate-spin", props.class));
-    return (_ctx, _cache) => {
-      return openBlock(), createElementBlock("svg", {
-        role: "status",
-        "aria-label": "Loading",
-        class: normalizeClass(classes.value),
-        "data-slot": "spinner",
-        viewBox: "0 0 24 24",
-        fill: "none",
-        stroke: "currentColor",
-        "stroke-width": "2",
-        "stroke-linecap": "round",
-        "stroke-linejoin": "round",
-        "aria-hidden": "false"
-      }, [..._cache[0] || (_cache[0] = [
-        createElementVNode("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }, null, -1)
-      ])], 2);
-    };
-  }
-});
+import _sfc_main from "./spinner2.vue.js";
 export {
   _sfc_main as default
 };

package/dist/components/ui/spinner2.vue.js

@@ -1,4 +1,32 @@
-import _sfc_main from "./spinner.vue.js";
+import { defineComponent, computed, openBlock, createElementBlock, normalizeClass, createElementVNode } from "vue";
+import { cn } from "../../lib/utils.js";
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "spinner",
+  props: {
+    class: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const classes = computed(() => cn("size-4 animate-spin", props.class));
+    return (_ctx, _cache) => {
+      return openBlock(), createElementBlock("svg", {
+        role: "status",
+        "aria-label": "Loading",
+        class: normalizeClass(classes.value),
+        "data-slot": "spinner",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "2",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round",
+        "aria-hidden": "false"
+      }, [..._cache[0] || (_cache[0] = [
+        createElementVNode("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }, null, -1)
+      ])], 2);
+    };
+  }
+});
 export {
   _sfc_main as default
 };

package/dist/controllers/use-controller-for-id.d.ts

@@ -5,7 +5,7 @@
  * the 4R release: the old controller's observer detaches the moment the id
  * moves on, and the last scope disposal releases the final one.
  */
-import type { Identifier, MicroStore } from "@chelone/core";
+import { type Identifier, type MicroStore } from "@chelone/core";
 import { type Ref } from "vue";
 import type { RecordValue } from "../record/record-context.js";
 export type SourceId = Identifier | undefined;
@@ -13,7 +13,11 @@ export interface BoundController<TController, TState> {
     controller: TController;
     state: Readonly<Ref<TState>>;
 }
-/** The foreign key `source` holds on the record; anything but a string or number reads as no key. */
+/**
+ * The foreign key `source` holds on the record, read through core's
+ * {@link getAtPath} so `source="author.id"` resolves the way the field
+ * composables read it. Anything but a string or number reads as no key.
+ */
 export declare function foreignKeyOf(record: RecordValue, source: string): SourceId;
 /**
  * Builds `create(id)` inside a scope of its own and keeps it bound to `id`:

package/dist/controllers/use-controller-for-id.js

@@ -1,7 +1,8 @@
+import { getAtPath } from "@chelone/core";
 import { shallowRef, watch, onScopeDispose, effectScope } from "vue";
 import { useMicroStore } from "../store/use-micro-store.js";
 function foreignKeyOf(record, source) {
-  const value = record?.[source];
+  const value = getAtPath(record, source);
   return typeof value === "string" || typeof value === "number" ? value : void 0;
 }
 function useControllerForId(id, create) {

package/dist/data/create-chelone-hooks.d.ts

@@ -26,6 +26,7 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -36,10 +37,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }, Omit<import("@tanstack/query-core").MutationObserverIdleResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -50,10 +53,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverLoadingResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -64,10 +69,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverErrorResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -78,10 +85,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverSuccessResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -92,10 +101,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate">> | (Omit<import("@tanstack/vue-query").UseMutationReturnType<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -106,10 +117,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }, Omit<import("@tanstack/query-core").MutationObserverIdleResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -120,10 +133,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverLoadingResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -134,10 +149,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverErrorResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -148,10 +165,12 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverSuccessResult<import("@chelone/core").RecordOf<TResources, TName>, unknown, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, {
         previous?: undefined;
         key?: undefined;
         manySnapshot?: undefined;
+        rollbackLists?: undefined;
     } | {
         previous: import("@chelone/core").RecordOf<TResources, TName> | undefined;
         key: readonly [string, "getOne", {
@@ -162,6 +181,7 @@ export declare function createCheloneHooks<TResources extends ResourceMap>(): {
             meta: {} | null;
         }];
         manySnapshot: [readonly unknown[], unknown][];
+        rollbackLists: () => void;
     }>, "reset" | "mutate">>, "mutate" | "mutateAsync"> & {
         mutate: (params: import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>, callbacks?: import("@chelone/core").UndoableCallbacks<import("@chelone/core").RecordOf<TResources, TName>, import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>> | undefined) => void;
         mutateAsync: (params: import("@chelone/core").UpdateParams<import("@chelone/core").RecordOf<TResources, TName>>) => Promise<void>;

package/dist/data/mutations.d.ts

@@ -42,6 +42,7 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -52,10 +53,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }, Omit<import("@tanstack/query-core").MutationObserverIdleResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -66,10 +69,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverLoadingResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -80,10 +85,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverErrorResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -94,10 +101,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverSuccessResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -108,10 +117,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate">> | Undoable<import("@tanstack/vue-query").UseMutationReturnType<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -122,10 +133,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }, Omit<import("@tanstack/query-core").MutationObserverIdleResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -136,10 +149,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverLoadingResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -150,10 +165,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverErrorResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -164,10 +181,12 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate"> | Omit<import("@tanstack/query-core").MutationObserverSuccessResult<RecordOf<TResources, TName>, unknown, UpdateParams<RecordOf<TResources, TName>>, {
     previous?: undefined;
     key?: undefined;
     manySnapshot?: undefined;
+    rollbackLists?: undefined;
 } | {
     previous: RecordOf<TResources, TName> | undefined;
     key: readonly [string, "getOne", {
@@ -178,6 +197,7 @@ export declare function useUpdate<TResources extends ResourceMap = ResourceMap,
         meta: {} | null;
     }];
     manySnapshot: [readonly unknown[], unknown][];
+    rollbackLists: () => void;
 }>, "reset" | "mutate">>, UpdateParams<RecordOf<TResources, TName>>, RecordOf<TResources, TName>>;
 /**
  * Delete-one mutation for `resource`. Returns vue-query's mutation object; call

package/dist/form/use-input.d.ts

@@ -17,11 +17,11 @@
  * server field errors (mapped onto the form's `onSubmit` channel) both surface
  * here once the field is registered.
  */
-import type { TranslatableMessage, Validator } from "@chelone/core";
+import type { SourcePath, TranslatableMessage, Validator } from "@chelone/core";
 import { type ComputedRef } from "vue";
-export interface UseInputOptions {
+export interface UseInputOptions<TRecord = unknown> {
     /** The field path RELATIVE to the ambient source scope (iterator rows compose it). */
-    source: string;
+    source: SourcePath<TRecord>;
     /**
      * Input-level default (ra precedence): seeds ONLY into a hole (an untouched
      * field whose form value is `undefined`); an existing record value wins.
@@ -57,4 +57,5 @@ export interface UseInputReturn {
     /** Whether a required validator is present (or `isRequired` was forced). */
     isRequired: boolean;
 }
+export declare function useInput<TRecord>(options: UseInputOptions<TRecord>): UseInputReturn;
 export declare function useInput(options: UseInputOptions): UseInputReturn;

package/dist/label/use-get-record-representation.d.ts

@@ -12,7 +12,8 @@
  *
  * The resource comes from the argument or the ambient `<Resource>` name. The
  * registry is optional (a form/field used without `<Admin>` in a unit test):
- * with no registry, only the default chain applies.
+ * with no registry, only the default chain applies. The string-path read is
+ * core's `getAtPath`, the same reader `useFieldValue` uses.
  */
 /** The resolver `useGetRecordRepresentation` returns. */
 export type GetRecordRepresentation = (record: unknown) => string;

package/dist/label/use-get-record-representation.js

@@ -1,19 +1,7 @@
+import { getAtPath } from "@chelone/core";
 import { inject } from "vue";
 import { ResourceRegistryKey } from "../admin/resource-registry.js";
 import { useResourceContext } from "../resource-context.js";
-function getAtPath(record, source) {
-  if (source === "") return record;
-  let current = record;
-  const pattern = /\[([^\]]*)\]|[^.[\]]+/g;
-  let match = pattern.exec(source);
-  while (match !== null) {
-    if (current == null || typeof current !== "object") return void 0;
-    const key = match[1] !== void 0 ? match[1] : match[0];
-    current = current[key];
-    match = pattern.exec(source);
-  }
-  return current;
-}
 function isPresent(value) {
   return value != null && value !== "";
 }

package/dist/record/use-field-value.d.ts

@@ -5,13 +5,14 @@
  * clean-room, zero-lodash). Returns a `ComputedRef` so a field re-renders when
  * the ambient record resolves (React re-renders instead; Vue tracks the ref).
  *
- * Path semantics match `lodash/get`: dot members (`author.name`), bracket
- * indices (`tags[1].label`), and numeric-dot indices (`tags.0.label`) resolve;
- * `defaultValue` replaces ONLY a resolved `undefined`, never a present `null` /
- * `0` / `false` / `""`. Reads from the RecordContext (NOT a source scope) on
- * purpose — a field tracks the record, not the form's source prefix.
+ * Path semantics match `lodash/get` through core's `getAtPath`: dot members
+ * (`author.name`), bracket indices (`tags[1].label`), numeric-dot indices
+ * (`tags.0.label`) and a literal `"a.b"` key all resolve; `defaultValue`
+ * replaces ONLY a resolved `undefined`, never a present `null` / `0` / `false`
+ * / `""`. Reads from the RecordContext (NOT a source scope) on purpose — a
+ * field tracks the record, not the form's source prefix.
  */
-import type { LooseRecord } from "@chelone/core";
+import { type LooseRecord } from "@chelone/core";
 import { type ComputedRef } from "vue";
 import { type RecordValue } from "./record-context.js";
 export interface UseFieldValueOptions<RecordType = LooseRecord> {

package/dist/record/use-field-value.js

@@ -1,30 +1,13 @@
+import { getAtPath } from "@chelone/core";
 import { inject, computed } from "vue";
 import { RecordContextKey } from "./record-context.js";
-function toPathSegments(source) {
-  if (source === "") return [];
-  const segments = [];
-  const pattern = /\[([^\]]*)\]|[^.[\]]+/g;
-  let match = pattern.exec(source);
-  while (match !== null) {
-    segments.push(match[1] !== void 0 ? match[1] : match[0]);
-    match = pattern.exec(source);
-  }
-  return segments;
-}
-function getAtPath(record, source, defaultValue) {
-  let current = record;
-  for (const key of toPathSegments(source)) {
-    if (current == null || typeof current !== "object") return defaultValue;
-    current = current[key];
-  }
-  return current === void 0 ? defaultValue : current;
-}
 function useFieldValue(options) {
   const { source, defaultValue } = options;
   const injected = inject(RecordContextKey, null);
   return computed(() => {
     const record = options.record !== void 0 ? options.record : injected?.value;
-    return getAtPath(record, source, defaultValue);
+    const value = getAtPath(record, source);
+    return value === void 0 ? defaultValue : value;
   });
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/vue",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -57,7 +57,7 @@
   "dependencies": {
     "cronstrue": "^3.24.0",
     "libphonenumber-js": "^1.13.8",
-    "@chelone/core": "0.1.1"
+    "@chelone/core": "0.3.0"
   },
   "peerDependencies": {
     "@guolao/vue-monaco-editor": "^1.6.0",
@@ -76,7 +76,7 @@
     "terra-draw-maplibre-gl-adapter": "^1.5.0",
     "vue": "^3.4.0",
     "vue-router": "^4.0.0",
-    "@chelone/supabase": "0.1.1"
+    "@chelone/supabase": "0.3.0"
   },
   "peerDependenciesMeta": {
     "@chelone/supabase": {
@@ -150,7 +150,7 @@
     "vue-router": "^4.0.0",
     "vue-tsc": "^2.0.0",
     "zod": "^3.24.0",
-    "@chelone/supabase": "0.1.1"
+    "@chelone/supabase": "0.3.0"
   },
   "scripts": {
     "build": "vite build && vue-tsc -p tsconfig.build.json && node ../../scripts/strip-dts-css-imports.mjs dist && node ../../scripts/dts-extensions.mjs dist",

package/dist/components/admin/fields/get-path.d.ts

@@ -1,7 +0,0 @@
-/**
- * Read a value at a dot path off `record`. Clean-room stand-in for
- * `lodash/get(record, path)` (chelone stays zero-lodash) — shared by the
- * per-item title/src lookups in `<FileField>` / `<ImageField>`'s array branch.
- * Mirrors the identical helper in the React twins.
- */
-export declare function getPath(record: unknown, path: string): unknown;

package/dist/components/admin/fields/get-path.js

@@ -1,14 +0,0 @@
-function getPath(record, path) {
-  if (record != null && typeof record === "object" && path in record) {
-    return record[path];
-  }
-  let current = record;
-  for (const key of path.split(".")) {
-    if (current == null || typeof current !== "object") return void 0;
-    current = current[key];
-  }
-  return current;
-}
-export {
-  getPath
-};