@chelone/vue 0.7.0 → 0.10.0

package/dist/components/admin/list/pivot-grid.vue.d.ts

@@ -1,7 +1,7 @@
 import { type VNode } from "vue";
-import type { LooseRecord, PivotAggregator, SourceProp } from "@chelone/core";
+import type { LooseRecord, ResourceRecord, PivotAggregator, SourceProp } from "@chelone/core";
 /** Props for {@link PivotGrid}. */
-export interface PivotGridProps<TRecord extends LooseRecord = LooseRecord> {
+export interface PivotGridProps<TRecord extends ResourceRecord = LooseRecord> {
     /** The field whose values become the rows; a dotted path reads a nested value. */
     rowSource: SourceProp<TRecord>;
     /** The field whose values become the columns. */
@@ -16,7 +16,7 @@ export interface PivotGridProps<TRecord extends LooseRecord = LooseRecord> {
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: <TRecord 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_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: import("vue").PublicProps & __VLS_PrettifyLocal<PivotGridProps<TRecord>> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});

package/dist/components/admin/list/record-timeline.vue.d.ts

@@ -1,8 +1,8 @@
 import { type VNode } from "vue";
-import type { LooseRecord, SourceProp } from "@chelone/core";
+import type { LooseRecord, ResourceRecord, SourceProp } from "@chelone/core";
 import type { Component } from "vue";
 /** Props for {@link RecordTimeline}. */
-export interface RecordTimelineProps<TRecord extends LooseRecord = LooseRecord> {
+export interface RecordTimelineProps<TRecord extends ResourceRecord = LooseRecord> {
     /** The field printed as the entry's text; a dotted path reads a nested value. */
     messageSource: SourceProp<TRecord>;
     /** The field holding the entry's date. An invalid or missing date leaves the time out. */
@@ -17,7 +17,7 @@ export interface RecordTimelineProps<TRecord extends LooseRecord = LooseRecord>
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: <TRecord 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_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: import("vue").PublicProps & __VLS_PrettifyLocal<RecordTimelineProps<TRecord>> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});

package/dist/components/admin/list/record-timeline.vue_vue_type_script_setup_true_lang.js

@@ -50,9 +50,9 @@ var record_timeline_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 		* </ReferenceManyField>
 		*/
 		const props = __props;
-		const list = useListContext();
 		const translate = useTranslate();
 		const locale = useLocale();
+		const list = useListContext();
 		const timeline = computed(() => {
 			const now = /* @__PURE__ */ new Date();
 			return toTimelineEntries(list.data ?? [], {

package/dist/components/admin/list/simple-list-item.vue.d.ts

@@ -1,13 +1,7 @@
-/**
- * `<SimpleListItem>` — one `<li>` of a `<SimpleList>`: the row content, linked
- * to the record's edit or show page. The Vue analog of `@chelone/react`'s
- * `list/simple-list-item.tsx`. Provides the record to its content (so slotted
- * fields resolve it via `RecordContext`) and renders nothing without one.
- */
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, ResourceRecord } from "@chelone/core";
 /** Props for {@link SimpleListItem}. */
-export interface SimpleListItemProps {
-    record?: LooseRecord;
+export interface SimpleListItemProps<TRecord extends ResourceRecord = LooseRecord> {
+    record?: TRecord;
     /** Override the ambient `<Resource>`. Without one the row is not linked. */
     resource?: string;
     /**
@@ -20,15 +14,23 @@ export interface SimpleListItemProps {
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SimpleListItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SimpleListItemProps> & Readonly<{}>, {
-    linkType: false | "edit" | "show";
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    default?: (props: {}) => any;
-} & {
-    default?: (props: {}) => any;
-}>;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SimpleListItemProps<TRecord>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        default?: (props: {}) => any;
+    } & {
+        default?: (props: {}) => any;
     };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/admin/list/simple-list-item.vue_vue_type_script_setup_true_lang.js

@@ -1,9 +1,9 @@
 import { useResourceDefinition } from "../../../admin/resource-registry.js";
 import { cn } from "../../../lib/utils.js";
-import { RecordContextKey } from "../../../record/record-context.js";
+import { provideRecordContext } from "../../../record/record-context.js";
 import { useResourceContext } from "../../../resource-context.js";
 import { useCreatePath } from "../../../router/nav-composables.js";
-import { computed, createBlock, createCommentVNode, createElementBlock, defineComponent, normalizeClass, openBlock, provide, ref, renderSlot, unref, watch, withCtx } from "vue";
+import { computed, createBlock, createCommentVNode, createElementBlock, defineComponent, normalizeClass, openBlock, renderSlot, toRef, unref, withCtx } from "vue";
 import { RouterLink } from "vue-router";
 // src/components/admin/list/simple-list-item.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = ["data-row-index"];
@@ -27,11 +27,7 @@ var simple_list_item_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 		* fields resolve it via `RecordContext`) and renders nothing without one.
 		*/
 		const props = __props;
-		const recordRef = ref(props.record);
-		watch(() => props.record, (next) => {
-			recordRef.value = next;
-		});
-		provide(RecordContextKey, recordRef);
+		provideRecordContext(toRef(props, "record"));
 		const resource = useResourceContext(props);
 		const createPath = useCreatePath();
 		const definition = useResourceDefinition(() => ({ resource }));

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

@@ -1,5 +1,5 @@
 import type { VNode } from "vue";
-import type { Identifier, LooseRecord } from "@chelone/core";
+import type { Identifier, LooseRecord, ResourceRecord } from "@chelone/core";
 /** Props for {@link SimpleList}. */
 export interface SimpleListProps {
     /** Where each row links to; see `SimpleListItem`. */
@@ -7,28 +7,36 @@ export interface SimpleListProps {
     class?: string;
 }
 /** What each row slot of a `<SimpleList>` is given. */
-export interface SimpleListSlotProps {
-    record: LooseRecord;
+export interface SimpleListSlotProps<TRecord extends ResourceRecord = LooseRecord> {
+    record: TRecord;
     id: Identifier;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SimpleListProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SimpleListProps> & Readonly<{}>, {
-    linkType: false | "edit" | "show";
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    "primary-text"?(props: SimpleListSlotProps): VNode[];
-    "secondary-text"?(props: SimpleListSlotProps): VNode[];
-    "tertiary-text"?(props: SimpleListSlotProps): VNode[];
-    "left-avatar"?(props: SimpleListSlotProps): VNode[];
-    "left-icon"?(props: SimpleListSlotProps): VNode[];
-    "right-icon"?(props: SimpleListSlotProps): VNode[];
-    /** Rendered while the list is pending, in place of `SimpleListLoading`. */
-    loading?(): VNode[];
-    /** Rendered with no records, in place of `ListNoResults`. */
-    empty?(): VNode[];
-}>;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SimpleListProps> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        "primary-text"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        "secondary-text"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        "tertiary-text"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        "left-avatar"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        "left-icon"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        "right-icon"?(props: SimpleListSlotProps<TRecord>): VNode[];
+        /** Rendered while the list is pending, in place of `SimpleListLoading`. */
+        loading?(): VNode[];
+        /** Rendered with no records, in place of `ListNoResults`. */
+        empty?(): VNode[];
     };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -1,15 +1,25 @@
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, ResourceRecord } from "@chelone/core";
 /** Props for {@link SingleFieldListRecord}. */
-export interface SingleFieldListRecordProps {
-    record: LooseRecord;
+export interface SingleFieldListRecordProps<TRecord extends ResourceRecord = LooseRecord> {
+    record: TRecord;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SingleFieldListRecordProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SingleFieldListRecordProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    default?: (props: {}) => any;
-}>;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SingleFieldListRecordProps<TRecord>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        default?: (props: {}) => any;
     };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/admin/list/single-field-list.vue.d.ts

@@ -1,23 +1,33 @@
 import type { VNode } from "vue";
-import type { LooseRecord } from "@chelone/core";
+import type { LooseRecord, ResourceRecord } from "@chelone/core";
 /** Props for {@link SingleFieldList}. */
 export interface SingleFieldListProps {
     class?: string;
 }
 /** What the `item` slot of a `<SingleFieldList>` is given. */
-export interface SingleFieldListItemSlotProps {
-    record: LooseRecord;
+export interface SingleFieldListItemSlotProps<TRecord extends ResourceRecord = LooseRecord> {
+    record: TRecord;
     index: number;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<SingleFieldListProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SingleFieldListProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    default?(): VNode[];
-    /** Renders each record; wins over the default slot. */
-    item?(props: SingleFieldListItemSlotProps): VNode[];
-}>;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<SingleFieldListProps> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        default?(): VNode[];
+        /** Renders each record; wins over the default slot. */
+        item?(props: SingleFieldListItemSlotProps<TRecord>): VNode[];
     };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -2,20 +2,25 @@
  * What `<TreeList>` hands every `<TreeListNode>` below it. The tree owns the
  * expanded map, the focus stop and the select/navigate rule, so a node renders
  * from one record and its depth.
+ *
+ * The record parameters are erased to `ResourceRecord`: an injection key names
+ * one type, and `<TreeList>` and its nodes are generic over their record. Every
+ * record the tree holds satisfies `ResourceRecord`, which is all the context
+ * reads (`id` for the link and the expanded map).
  */
-import type { Identifier, LooseRecord } from "@chelone/core";
+import type { Identifier, ResourceRecord } from "@chelone/core";
 import type { Component, InjectionKey } from "vue";
 export interface TreeListContext {
     isExpanded(id: Identifier): boolean;
     toggle(id: Identifier): void;
     /** Runs the `select` listener, or navigates when there is none. */
-    select(record: LooseRecord): void;
+    select(record: ResourceRecord): void;
     /** Where a row links to; `undefined` when it does not link. */
-    hrefFor(record: LooseRecord): string | undefined;
+    hrefFor(record: ResourceRecord): string | undefined;
     /** Whether a row can be activated at all. */
-    isSelectable(record: LooseRecord): boolean;
-    titleFor(record: LooseRecord): string;
-    iconFor(record: LooseRecord): Component | undefined;
+    isSelectable(record: ResourceRecord): boolean;
+    titleFor(record: ResourceRecord): string;
+    iconFor(record: ResourceRecord): Component | undefined;
     /** The one treeitem in the tab order. */
     isTabStop(id: Identifier): boolean;
     setFocused(id: Identifier): void;

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

@@ -1,10 +1,25 @@
-import type { LooseRecord, RecordTreeNode } from "@chelone/core";
+import type { LooseRecord, RecordTreeNode, ResourceRecord } from "@chelone/core";
 /** Props for {@link TreeListNode}. */
-export interface TreeListNodeProps {
-    node: RecordTreeNode<LooseRecord>;
+export interface TreeListNodeProps<TRecord extends ResourceRecord = LooseRecord> {
+    node: RecordTreeNode<TRecord>;
     /** Depth from 1 at the roots; becomes `aria-level`. */
     level: number;
 }
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: import("vue").DefineComponent<TreeListNodeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TreeListNodeProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<TreeListNodeProps<TRecord>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {};
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -1,25 +1,8 @@
-/**
- * `<TreeList>` — the records of the ambient `<List>` as a collapsible tree,
- * nested by a parent field. The Vue analog of `@chelone/react`'s
- * `list/tree-list.tsx`. A record whose parent is missing from the list (it may
- * be on another page) is a root, and a parent cycle still lists every record.
- *
- * Emits `select` with the record when a row is activated. With no `select`
- * listener attached, the row navigates to the record's edit or show page
- * instead (React's `onSelect` fallback). The `loading` and `empty` slots
- * replace `SimpleListLoading` and `ListNoResults`.
- *
- * @example
- * <List>
- *   <TreeList parent-source="parent_id" title-source="name" />
- * </List>
- */
-import { type LooseRecord } from "@chelone/core";
 import { type VNode } from "vue";
-import type { SourceProp } from "@chelone/core";
+import type { LooseRecord, ResourceRecord, SourceProp } from "@chelone/core";
 import type { Component } from "vue";
 /** Props for {@link TreeList}. */
-export interface TreeListProps {
+export interface TreeListProps<TRecord extends ResourceRecord = LooseRecord> {
     /** The field holding the parent's id; a dot or bracket path reads a nested value. */
     parentSource: SourceProp;
     /** The string field shown as the row title; the record representation otherwise. */
@@ -37,25 +20,33 @@ export interface TreeListProps {
     linkType?: "edit" | "show" | false;
     class?: string;
 }
+/** What `<TreeList>` emits. */
+export interface TreeListEmits<TRecord extends ResourceRecord = LooseRecord> {
+    /** A row was activated. A `select` listener replaces the row's navigation. */
+    select: [record: TRecord];
+}
 declare const _default: typeof __VLS_export;
 export default _default;
-declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<TreeListProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    select: (record: LooseRecord) => any;
-}, string, import("vue").PublicProps, Readonly<TreeListProps> & Readonly<{
-    onSelect?: ((record: LooseRecord) => any) | undefined;
-}>, {
-    linkType: false | "edit" | "show";
-    titleSource: string;
-    iconSource: string;
-    iconMap: Record<string, Component>;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
-    /** Rendered while the list is pending, in place of `SimpleListLoading`. */
-    loading?(): VNode[];
-    /** Rendered with no records, in place of `ListNoResults`. */
-    empty?(): VNode[];
-}>;
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
+declare const __VLS_export: <TRecord extends ResourceRecord = LooseRecord>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<TreeListProps<TRecord> & {
+        onSelect?: ((record: TRecord) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        /** Rendered while the list is pending, in place of `SimpleListLoading`. */
+        loading?(): VNode[];
+        /** Rendered with no records, in place of `ListNoResults`. */
+        empty?(): VNode[];
     };
+    emit: (evt: "select", record: TRecord) => void;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/components/admin/realtime/comments-thread.vue_vue_type_script_setup_true_lang.js

@@ -2,10 +2,11 @@ import { useOptionalIdentity } from "../../../auth/auth-hooks.js";
 import { useCheloneContext, useCheloneNotifications } from "../../../context.js";
 import { useGetList } from "../../../data/queries.js";
 import { useTranslate } from "../../../i18n/use-translate.js";
+import { cn } from "../../../lib/utils.js";
 import { RecordContextKey } from "../../../record/record-context.js";
 import { Badge } from "../../ui/badge.js";
 import button_default from "../../ui/button.js";
-import { Card, CardContent } from "../../ui/card.js";
+import { Card } from "../../ui/card.js";
 import textarea_default from "../../ui/textarea.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, inject, normalizeClass, openBlock, ref, renderList, toDisplayString, unref, watch, watchEffect, withCtx } from "vue";
 import { createMutationOptions, isRealtimeDataProvider, subscribeLiveResource, updateMutationOptions } from "@chelone/core";
@@ -13,21 +14,30 @@ import { useMutation } from "@tanstack/vue-query";
 // src/components/admin/realtime/comments-thread.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = {
 	key: 0,
-	"data-slot": "comments-error"
+	"data-slot": "comments-error",
+	class: "text-sm text-destructive"
 };
 var _hoisted_2 = {
 	key: 1,
-	"data-slot": "comments-empty"
+	"data-slot": "comments-empty",
+	class: "rounded-xl border bg-card p-4 text-sm text-muted-foreground shadow"
 };
-var _hoisted_3 = ["datetime"];
-var _hoisted_4 = {
+var _hoisted_3 = { class: "flex items-baseline gap-2 text-sm" };
+var _hoisted_4 = { class: "font-medium" };
+var _hoisted_5 = ["datetime"];
+var _hoisted_6 = { class: "whitespace-pre-wrap text-sm" };
+var _hoisted_7 = {
 	key: 2,
-	"data-slot": "comments-total"
+	"data-slot": "comments-total",
+	class: "text-xs text-muted-foreground"
+};
+var _hoisted_8 = {
+	"data-slot": "comments-form",
+	class: "space-y-2"
 };
-var _hoisted_5 = { "data-slot": "comments-form" };
 /** A row is a comment when it has a string `body`; any other row is skipped. */
 function isCommentRecord(record) {
-	return typeof record.body === "string";
+	return "body" in record && typeof record.body === "string";
 }
 var comments_thread_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	__name: "comments-thread",
@@ -134,9 +144,9 @@ var comments_thread_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 				messageArgs: { smart_count: 1 }
 			});
 		}
-		function timeOf(comment) {
-			if (!comment.createdAt) return void 0;
-			const date = new Date(comment.createdAt);
+		function timeOf(iso) {
+			if (!iso) return void 0;
+			const date = new Date(iso);
 			if (Number.isNaN(date.getTime())) return void 0;
 			return {
 				iso: date.toISOString(),
@@ -147,53 +157,55 @@ var comments_thread_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 			return recordId.value !== void 0 ? (openBlock(), createElementBlock("section", {
 				key: 0,
 				"data-slot": "comments-thread",
-				class: normalizeClass(props.class)
+				class: normalizeClass(unref(cn)("space-y-3", props.class))
 			}, [
-				unref(isError) ? (openBlock(), createElementBlock("p", _hoisted_1, toDisplayString(unref(translate)("chelone.comments.load_failed", { _: "Could not load the comments" })), 1)) : unref(isSuccess) && items.value.length === 0 ? (openBlock(), createElementBlock("p", _hoisted_2, toDisplayString(unref(translate)("chelone.comments.empty", { _: "No comments yet" })), 1)) : createCommentVNode("", true),
+				unref(isError) ? (openBlock(), createElementBlock("p", _hoisted_1, toDisplayString(unref(translate)("chelone.comments.load_failed", { _: "Could not load the comments" })), 1)) : unref(isSuccess) && items.value.length === 0 ? (openBlock(), createElementBlock("p", _hoisted_2, toDisplayString(unref(translate)("chelone.comments.empty", { _: "No comments yet. Be the first." })), 1)) : createCommentVNode("", true),
 				(openBlock(true), createElementBlock(Fragment, null, renderList(items.value, (comment) => {
 					return openBlock(), createBlock(unref(Card), {
 						key: comment.id,
 						"data-slot": "comment",
-						"data-comment-id": comment.id
+						"data-comment-id": comment.id,
+						class: normalizeClass(unref(cn)("flex flex-col items-start gap-2 p-4", comment.resolvedAt && "opacity-60"))
 					}, {
-						default: withCtx(() => [createVNode(unref(CardContent), null, {
-							default: withCtx(() => [
-								createElementVNode("div", null, [createElementVNode("strong", null, toDisplayString(authorOf(comment)), 1), timeOf(comment) ? (openBlock(), createElementBlock("time", {
-									key: 0,
-									datetime: timeOf(comment)?.iso
-								}, toDisplayString(timeOf(comment)?.label), 9, _hoisted_3)) : createCommentVNode("", true)]),
-								createElementVNode("p", null, toDisplayString(comment.body), 1),
-								comment.resolvedAt ? (openBlock(), createBlock(unref(Badge), {
-									key: 0,
-									variant: "secondary"
-								}, {
-									default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("chelone.comments.resolved", { _: "Resolved" })), 1)]),
-									_: 1
-								})) : props.resolvable ? (openBlock(), createBlock(button_default, {
-									key: 1,
-									variant: "outline",
-									size: "sm",
-									disabled: unref(update).isPending.value,
-									onClick: ($event) => resolve(comment)
-								}, {
-									default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("chelone.comments.mark_resolved", { _: "Mark resolved" })), 1)]),
-									_: 1
-								}, 8, ["disabled", "onClick"])) : createCommentVNode("", true)
-							]),
-							_: 2
-						}, 1024)]),
+						default: withCtx(() => [
+							createElementVNode("div", _hoisted_3, [createElementVNode("strong", _hoisted_4, toDisplayString(authorOf(comment)), 1), timeOf(comment.createdAt) ? (openBlock(), createElementBlock("time", {
+								key: 0,
+								datetime: timeOf(comment.createdAt)?.iso,
+								class: "text-xs text-muted-foreground"
+							}, toDisplayString(timeOf(comment.createdAt)?.label), 9, _hoisted_5)) : createCommentVNode("", true)]),
+							createElementVNode("p", _hoisted_6, toDisplayString(comment.body), 1),
+							comment.resolvedAt ? (openBlock(), createBlock(unref(Badge), {
+								key: 0,
+								variant: "secondary"
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("chelone.comments.resolved", {
+									_: "Resolved {time}",
+									time: timeOf(comment.resolvedAt)?.label ?? ""
+								})), 1)]),
+								_: 2
+							}, 1024)) : props.resolvable ? (openBlock(), createBlock(button_default, {
+								key: 1,
+								variant: "outline",
+								size: "sm",
+								disabled: unref(update).isPending.value,
+								onClick: ($event) => resolve(comment)
+							}, {
+								default: withCtx(() => [createTextVNode(toDisplayString(unref(translate)("chelone.comments.mark_resolved", { _: "Mark resolved" })), 1)]),
+								_: 1
+							}, 8, ["disabled", "onClick"])) : createCommentVNode("", true)
+						]),
 						_: 2
-					}, 1032, ["data-comment-id"]);
+					}, 1032, ["data-comment-id", "class"]);
 				}), 128)),
-				total.value > items.value.length ? (openBlock(), createElementBlock("p", _hoisted_4, toDisplayString(unref(translate)("chelone.comments.showing", {
+				total.value > items.value.length ? (openBlock(), createElementBlock("p", _hoisted_7, toDisplayString(unref(translate)("chelone.comments.showing", {
 					shown: items.value.length,
 					total: total.value,
 					_: "Showing the first {shown} of {total} comments"
 				})), 1)) : createCommentVNode("", true),
-				createElementVNode("div", _hoisted_5, [createVNode(textarea_default, {
+				createElementVNode("div", _hoisted_8, [createVNode(textarea_default, {
 					modelValue: draft.value,
 					"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => draft.value = $event),
-					placeholder: unref(translate)("chelone.comments.placeholder", { _: "Write a comment" }),
+					placeholder: unref(translate)("chelone.comments.placeholder", { _: "Write a comment…" }),
 					onKeydown
 				}, null, 8, ["modelValue", "placeholder"]), createVNode(button_default, {
 					disabled: !canPost.value,

package/dist/components/admin/realtime/menu-live.vue.d.ts

@@ -22,7 +22,9 @@ export interface MenuLiveProps {
 /**
  * A menu link with a badge counting the resource's new records. The count
  * lives in the store, so it survives a remount; it clears while the link's
- * route is active. Divergence from the React twin: the render props are slots.
+ * route is active. Inside a `<SidebarProvider>` it is a sidebar menu button,
+ * with the label as a `title` while the desktop rail is collapsed; elsewhere it is
+ * a plain link. Divergence from the React twin: the render props are slots.
  * Declared as a render component so the file can also hold {@link MenuLive}.
  */
 export declare const MenuLiveItemLink: import("vue").DefineComponent<import("vue").ExtractPropTypes<{