@lobb-js/studio 0.31.0 → 0.33.0

package/src/lib/components/dataTable/dataTable.svelte

@@ -13,6 +13,7 @@
     import Header from "./header.svelte";
     import Table, { type TableProps } from "./table.svelte";
     import { getCollectionColumns, getCollectionParamsFields } from "./utils";
+    import CanAccess from "../canAccess.svelte";
     import { Pencil, Trash, Unlink } from "lucide-svelte";
     import ListViewChildren from "./listViewChildren.svelte";
     import FieldCell from "./fieldCell.svelte";
@@ -21,11 +22,10 @@
     import { showDialog } from "../../actions";
     import UpdateDetailViewButton from "../detailView/update/updateDetailViewButton.svelte";
     import type { Snippet } from "svelte";
-    import type { Changes, ChildrenChanges } from "../detailView/utils";
+    import type { ChildrenChanges } from "../detailView/utils";
     import ExtensionsComponents from "../extensionsComponents.svelte";
     import { getExtensionUtils, loadExtensionComponents } from "../../extensions/extensionUtils";
-    import { emitEvent } from "../../eventSystem";
-    import { onMount } from "svelte";
+    import { untrack } from "svelte";
     import Tabs from "./dataTableTabs.svelte";
     import { fade } from "svelte/transition";
     import type { CollectionTab } from "../../store.types";
@@ -37,14 +37,18 @@
         filter?: any;
         searchParams?: Record<string, any>;
         parentContext?: ParentContext;
+        onChanges?: (changes: ChildrenChanges) => void;
         changes?: ChildrenChanges;
         showHeader?: boolean;
         showFooter?: boolean;
         showImport?: boolean;
         showDelete?: boolean;
+        showEdit?: boolean;
+        onDataLoad?: (total: number) => void;
         tableProps?: Partial<TableProps>;
         tabs?: CollectionTab[];
         headerLeft?: Snippet<[]>;
+        view?: { id: string; [key: string]: any };
     }
 
     let {
@@ -52,64 +56,49 @@
         filter,
         searchParams,
         parentContext,
-        changes = $bindable<ChildrenChanges | undefined>(undefined),
+        onChanges,
+        changes,
         showHeader = true,
         showFooter = true,
         showImport = true,
         showDelete = false,
+        showEdit = true,
+        onDataLoad,
         tableProps,
         tabs,
         headerLeft,
+        view,
     }: Props = $props();
 
-    // Gate row/header buttons by the current user's permissions:
-    // - showUpdate → per-row edit button
-    // - showCreate → header's Create + Import buttons (passed to Header)
-    let showUpdate = $state(false);
-    let showCreate = $state(false);
-    onMount(async () => {
-        const [update, create] = await Promise.all([
-            emitEvent({ lobb, ctx }, "auth.canAccess", { collection: collectionName, action: "update" }),
-            emitEvent({ lobb, ctx }, "auth.canAccess", { collection: collectionName, action: "create" }),
-        ]);
-        showUpdate = update === true;
-        showCreate = create === true;
-    });
+    const isRecordingMode = onChanges !== undefined;
+    let localChanges = $state<ChildrenChanges>(
+        untrack(() => changes) ?? { created: [], updated: [], deleted: [], linked: [], unlinked: [] }
+    );
 
-    function getOrCreateUpdatedSlot(recordId: string): Changes | undefined {
-        if (!changes) return undefined;
-        let slot = changes.updated.find((u) => String(u.id) === String(recordId));
-        if (!slot) {
-            slot = { id: recordId, data: {}, children: {} };
-            changes.updated.push(slot);
-        }
-        return slot;
-    }
 
-    // Derives the displayed rows by applying changes on top of server data.
-    // This is the single place responsible for optimistic UI — no handler touches data directly.
+    // Derives the displayed rows by applying localChanges on top of server data.
     const data = $derived.by(() => {
-        if (!changes) return serverData;
+        if (!isRecordingMode) return serverData;
 
         const removedIds = new Set([
-            ...changes.deleted.map((r) => String(r.id)),
-            ...changes.unlinked.map((r) => String(r.id)),
+            ...localChanges.deleted.map((r: any) => String(r.id)),
+            ...localChanges.unlinked.map((r: any) => String(r.id)),
         ]);
 
         let result = serverData.filter((r: any) => !removedIds.has(String(r.id)));
 
         result = result.map((r: any) => {
-            const update = changes.updated.find((u) => String(u.id) === String(r.id));
-            return update && Object.keys(update.data).length ? { ...r, ...update.data } : r;
+            const update = localChanges.updated.find((u) => String(u.id) === String(r.id));
+            return update && Object.keys(update.changes.data).length ? { ...r, ...update.changes.data } : r;
         });
 
-        for (const record of changes.linked) {
+        for (const record of localChanges.linked) {
             if (!result.some((r: any) => String(r.id) === String(record.id))) {
                 result = [...result, record];
             }
         }
 
-        for (const item of changes.created) {
+        for (const item of localChanges.created) {
             result = [...result, { ...item.data, _pending: true }];
         }
 
@@ -122,6 +111,23 @@
 
     let activeTabFilter = $state<any>(undefined);
 
+    // Named-view lookup: when a `view` prop is supplied, resolve the
+    // matching `dataTable.view.<view.id>` registration. Exact key match,
+    // no `when` predicate — the caller already picked the view they want.
+    const customViewComponent = $derived.by(() => {
+        if (!view?.id) return null;
+        const key = `dataTable.view.${view.id}`;
+        for (const ext of Object.values(ctx.extensions ?? {})) {
+            const components = (ext as any)?.components ?? {};
+            const entry = components[key];
+            if (!entry) continue;
+            return entry && typeof entry === "object" && "component" in entry
+                ? entry.component
+                : entry;
+        }
+        return null;
+    });
+
     // Canonicalize the incoming filter so values like `{ status: "Open" }`
     // become `{ status: { $eq: "Open" } }`. The Filter UI and the server
     // both expect operator objects, so doing this once at the boundary
@@ -189,18 +195,26 @@
         const res = await response.json();
         serverData = res.data;
         totalCount = res.meta.totalCount;
+        onDataLoad?.(totalCount);
         loading = false;
     }
 
     async function handleDelete(entryId: string) {
         const result = await showDialog("Are you sure?", "This will permanently delete the record.");
         if (!result) return;
-        if (changes) {
-            const record = data.find((r: any) => String(r.id) === String(entryId));
-            if (record) changes.deleted.push($state.snapshot(record));
+        if (isRecordingMode) {
+            // If the record was locally linked (not yet in DB), just cancel the link instead of marking for deletion.
+            const linkedIdx = localChanges.linked.findIndex((r: any) => String(r.id) === String(entryId));
+            if (linkedIdx !== -1) {
+                localChanges.linked.splice(linkedIdx, 1);
+            } else {
+                const record = serverData.find((r: any) => String(r.id) === String(entryId));
+                if (record) localChanges.deleted.push($state.snapshot(record));
+            }
+            onChanges?.($state.snapshot(localChanges));
         } else if (parentContext) {
             serverData = serverData.filter((r: any) => String(r.id) !== String(entryId));
-            await lobb.updateOne(parentContext.collectionName, String(parentContext.recordId), {}, { [collectionName]: { delete: [entryId] } });
+            await lobb.updateOne(parentContext.collectionName, String(parentContext.recordId), { data: {}, children: { [collectionName]: { delete: [entryId] } } });
             params = { ...params };
         } else {
             serverData = serverData.filter((r: any) => String(r.id) !== String(entryId));
@@ -212,16 +226,55 @@
     async function handleUnlink(entryId: string) {
         const result = await showDialog("Are you sure?", "This will unlink the record without deleting it.");
         if (!result) return;
-        if (changes) {
-            const record = data.find((r: any) => String(r.id) === String(entryId));
-            if (record) changes.unlinked.push($state.snapshot(record));
+        if (isRecordingMode) {
+            // If the record was locally linked this session, just cancel the link — net effect is no change.
+            const linkedIdx = localChanges.linked.findIndex((r: any) => String(r.id) === String(entryId));
+            if (linkedIdx !== -1) {
+                localChanges.linked.splice(linkedIdx, 1);
+            } else {
+                const record = serverData.find((r: any) => String(r.id) === String(entryId));
+                if (record) localChanges.unlinked.push($state.snapshot(record));
+            }
+            onChanges?.($state.snapshot(localChanges));
         } else {
             serverData = serverData.filter((r: any) => String(r.id) !== String(entryId));
-            await lobb.updateOne(parentContext!.collectionName, String(parentContext!.recordId), {}, { [collectionName]: { unlink: [entryId] } });
+            await lobb.updateOne(parentContext!.collectionName, String(parentContext!.recordId), { data: {}, children: { [collectionName]: { unlink: [entryId] } } });
             params = { ...params };
         }
     }
 
+    function handleLink(record: any) {
+        // If the record was locally unlinked this session, just cancel the unlink — net effect is no change.
+        const unlinkedIdx = localChanges.unlinked.findIndex((r: any) => String(r.id) === String(record.id));
+        if (unlinkedIdx !== -1) {
+            localChanges.unlinked.splice(unlinkedIdx, 1);
+        } else if (!localChanges.linked.some((r: any) => String(r.id) === String(record.id))) {
+            localChanges.linked.push(record);
+        }
+        onChanges?.($state.snapshot(localChanges));
+    }
+
+    $effect(() => {
+        if (isRecordingMode) {
+            console.log(`[DataTable:${collectionName}] localChanges:`, $state.snapshot(localChanges));
+        }
+    });
+
+    function handleCreate(changes: import("../detailView/utils").Changes) {
+        localChanges.created.push({ data: changes.data });
+        onChanges?.($state.snapshot(localChanges));
+    }
+
+    function handleUpdate(id: string, editChanges: import("../detailView/utils").Changes) {
+        const existing = localChanges.updated.find((u) => String(u.id) === id);
+        if (existing) {
+            existing.changes = editChanges;
+        } else {
+            localChanges.updated.push({ id, changes: editChanges });
+        }
+        onChanges?.($state.snapshot(localChanges));
+    }
+
 </script>
 
 <div
@@ -244,9 +297,9 @@
             {collectionName}
             bind:selectedRecords
             {showImport}
-            {showCreate}
             {parentContext}
-            {changes}
+            onLink={isRecordingMode ? handleLink : undefined}
+            onCreate={isRecordingMode ? handleCreate : undefined}
         >
             {#snippet left()}
                 {@render headerLeft?.()}
@@ -263,6 +316,18 @@
                         <Skeleton class="h-8 w-[80%]" />
                         <Skeleton class="h-8 w-[60%]" />
                     </div>
+                {:else if customViewComponent}
+                    {@const CustomView = customViewComponent}
+                    <CustomView
+                        {collectionName}
+                        {data}
+                        {columns}
+                        bind:params
+                        {loading}
+                        refresh={() => { params = { ...params }; }}
+                        {view}
+                        utils={getExtensionUtils(lobb, ctx)}
+                    />
                 {:else}
                     <Table
                         {data}
@@ -277,18 +342,19 @@
                         {...tableProps}
                         rowActions={hasRowActions ? rowActionsSnippet : undefined}>
                         {#snippet tools(entry)}
-                            {#if showUpdate}
-                                <UpdateDetailViewButton
-                                    {collectionName}
-                                    recordId={entry.id}
-                                    variant="ghost"
-                                    class="h-5 w-5 px-0 py-0 text-muted-foreground hover:bg-transparent"
-                                    Icon={Pencil}
-                                    changes={getOrCreateUpdatedSlot(String(entry.id))}
-                                    onSuccessfullSave={async () => {
-                                        params = { ...params };
-                                    }}
-                                ></UpdateDetailViewButton>
+                            {#if showEdit}
+                                <CanAccess collection={collectionName} action="update">
+                                    <UpdateDetailViewButton
+                                        {collectionName}
+                                        recordId={entry.id}
+                                        variant="ghost"
+                                        class="h-5 w-5 px-0 py-0 text-muted-foreground hover:bg-transparent"
+                                        Icon={Pencil}
+                                        changes={isRecordingMode ? localChanges.updated.find((u) => String(u.id) === String(entry.id))?.changes : undefined}
+                                        onChanges={isRecordingMode ? (c) => handleUpdate(String(entry.id), c) : undefined}
+                                        onSuccessfullSave={!isRecordingMode ? async () => { params = { ...params }; } : undefined}
+                                    ></UpdateDetailViewButton>
+                                </CanAccess>
                             {/if}
                             {#if parentContext}
                                 <Button
@@ -317,7 +383,7 @@
                                 fieldName={column.id}
                                 {value}
                                 {entry}
-                                tableParams={params}
+                                refresh={() => { params = { ...params }; }}
                             />
                         {/snippet}
                         {#snippet collapsible(entry)}

package/src/lib/components/dataTable/fieldCell.svelte

@@ -17,7 +17,7 @@
         fieldName: string;
         value: any;
         entry: Record<string, any>;
-        tableParams?: any;
+        refresh?: () => void;
     }
 
     let {
@@ -25,7 +25,7 @@
         fieldName,
         value,
         entry,
-        tableParams = $bindable(),
+        refresh,
     }: Props = $props();
 
     const field = getField(ctx, fieldName, collectionName);
@@ -49,7 +49,7 @@
                 collectionField={polymorphicRelation.from.collection_field}
                 idField={polymorphicRelation.from.id_field}
                 {entry}
-                bind:tableParams
+                {refresh}
             />
         {:else if isRefrenceField}
             {#if value?.id && value.id !== 0}
@@ -67,7 +67,7 @@
                         class="h-5 w-5 px-0 py-0 text-muted-foreground hover:bg-transparent"
                         Icon={ExternalLink}
                         onSuccessfullSave={async () => {
-                            tableParams = { ...tableParams };
+                            refresh?.();
                         }}
                     />
                 </div>

package/src/lib/components/dataTable/header.svelte

@@ -1,7 +1,8 @@
 <script lang="ts">
     import { getStudioContext } from "../../context";
-    import type { Changes, ChildrenChanges } from "../detailView/utils";
+    import type { Changes } from "../detailView/utils";
     import type { ParentContext } from "./dataTable.svelte";
+    import CanAccess from "../canAccess.svelte";
     import { Download, ListRestart, Plus, Trash, Link } from "lucide-svelte";
     import * as Tooltip from "../ui/tooltip";
     import LlmButton from "../LlmButton.svelte";
@@ -23,9 +24,9 @@
         params: any;
         selectedRecords: string[];
         parentContext?: ParentContext;
-        changes?: ChildrenChanges;
+        onLink?: (record: any) => void;
+        onCreate?: (changes: Changes) => void;
         showImport?: boolean;
-        showCreate?: boolean;
         left?: Snippet<[]>;
     }
 
@@ -34,27 +35,24 @@
         params = $bindable(),
         selectedRecords = $bindable(),
         parentContext,
-        changes,
+        onLink,
+        onCreate,
         showImport = true,
-        showCreate = false,
         left
     }: Props = $props();
 
-    // Local changes object for the create form (recording mode only)
-    let createChanges = $state<Changes>({ data: {}, children: {} });
-
     function handleLink(record: any) {
-        if (changes) {
-            changes.linked.push(record);
+        if (onLink) {
+            onLink(record);
         } else if (parentContext) {
-            lobb.updateOne(parentContext.collectionName, String(parentContext.recordId), {}, { [collectionName]: { link: [record.id] } });
+            lobb.updateOne(parentContext.collectionName, String(parentContext.recordId), { data: {}, children: { [collectionName]: { link: [record.id] } } });
             resetTable();
         }
     }
 
-    async function handleCreateSuccess(snap: any) {
-        if (changes) {
-            changes.created.push({ data: snap.data });
+    async function handleCreate(snap: any) {
+        if (onCreate) {
+            onCreate(snap);
         } else {
             resetTable();
         }
@@ -169,21 +167,23 @@
         >
             {headerIsSmall ? "" : "Refresh"}
         </Button>
-        {#if showImport && showCreate}
-            <Tooltip.Provider delayDuration={0}>
-                <Tooltip.Root>
-                    <Tooltip.Trigger>
-                        <ImportButton
-                            {collectionName}
-                            variant="outline"
-                            class="h-7 px-2 text-xs font-normal"
-                            Icon={Download}
-                            onSuccessfullSave={() => (params = { ...params })}
-                        />
-                    </Tooltip.Trigger>
-                    <Tooltip.Content>Import</Tooltip.Content>
-                </Tooltip.Root>
-            </Tooltip.Provider>
+        {#if showImport}
+            <CanAccess collection={collectionName} action="create">
+                <Tooltip.Provider delayDuration={0}>
+                    <Tooltip.Root>
+                        <Tooltip.Trigger>
+                            <ImportButton
+                                {collectionName}
+                                variant="outline"
+                                class="h-7 px-2 text-xs font-normal"
+                                Icon={Download}
+                                onSuccessfullSave={() => (params = { ...params })}
+                            />
+                        </Tooltip.Trigger>
+                        <Tooltip.Content>Import</Tooltip.Content>
+                    </Tooltip.Root>
+                </Tooltip.Provider>
+            </CanAccess>
         {/if}
         <ExtensionsComponents
             name="listView.header.actions"
@@ -202,17 +202,17 @@
                 {headerIsSmall ? "" : "Link"}
             </SelectRecord>
         {/if}
-        {#if showCreate}
+        <CanAccess collection={collectionName} action="create">
             <CreateDetailViewButton
                 {collectionName}
                 variant="default"
                 class="h-7 px-3 text-xs font-normal"
                 Icon={Plus}
-                changes={changes ? createChanges : undefined}
-                onSuccessfullSave={handleCreateSuccess}
+                onChanges={onCreate ? handleCreate : undefined}
+                onSuccessfullSave={onCreate ? undefined : handleCreate}
             >
                 {headerIsSmall ? "" : "Create"}
             </CreateDetailViewButton>
-        {/if}
+        </CanAccess>
     </div>
 </div>

package/src/lib/components/dataTable/polymorphicFieldCell.svelte

@@ -6,14 +6,14 @@
         collectionField: string;
         idField: string;
         entry: Record<string, any>;
-        tableParams?: any;
+        refresh?: () => void;
     }
 
     let {
         collectionField,
         idField,
         entry,
-        tableParams = $bindable(),
+        refresh,
     }: Props = $props();
 
     const targetCollection = $derived(entry[collectionField] ?? null);
@@ -34,7 +34,7 @@
             class="h-5 w-5 px-0 py-0 text-muted-foreground hover:bg-transparent"
             Icon={ExternalLink}
             onSuccessfullSave={async () => {
-                tableParams = { ...tableParams };
+                refresh?.();
             }}
         />
     </div>

package/src/lib/components/dataTablePopup/dataTablePopup.svelte

@@ -19,6 +19,7 @@
 		showFooter?: boolean;
 		tableProps?: Partial<TableProps>;
 		tabs?: CollectionTab[];
+		view?: { id: string; [key: string]: any };
 		onClose?: () => void;
 	}
 
@@ -32,6 +33,7 @@
 		showFooter = true,
 		tableProps,
 		tabs,
+		view,
 		onClose,
 	}: Props = $props();
 
@@ -78,6 +80,7 @@
 				{showFooter}
 				{tableProps}
 				{tabs}
+				{view}
 			/>
 		</div>
 	</div>

package/src/lib/components/detailView/create/createDetailView.svelte

@@ -1,4 +1,7 @@
 <script lang="ts" module>
+    import type { Changes } from "../utils";
+    import type { Snippet } from "svelte";
+
     interface SubmitButton {
         text: string;
         icon: any;
@@ -12,7 +15,7 @@
         title?: Snippet<[string]>;
         onSuccessfullSave?: (entry: any) => Promise<void>;
         onCancel?: () => Promise<void>;
-        changes?: import("../utils").Changes | undefined;
+        onChanges?: (changes: Changes) => void;
     }
 </script>
 
@@ -24,11 +27,8 @@
     import { untrack } from "svelte";
 
     const { lobb, ctx } = getStudioContext();
-    import Children from "./children.svelte";
-    import { buildChildren, getDefaultEntry } from "../utils";
-    import type { Changes } from "../utils";
-    import { getChangedProperties } from "../../../utils";
-    import type { Snippet } from "svelte";
+    import CreateDetailViewChildren from "./createDetailViewChildren.svelte";
+    import { getDefaultEntry } from "../utils";
     import DetailView from "../detailView.svelte";
     import Drawer from "../../drawer.svelte";
 
@@ -40,80 +40,53 @@
         onSuccessfullSave,
         title,
         submitButton,
-        changes: passedChanges = $bindable<Changes | undefined>(undefined),
+        onChanges,
     }: CreateDetailViewProp = $props();
 
-    const isRecordingMode = passedChanges !== undefined;
-    if (!isRecordingMode) passedChanges = { data: {}, children: {} };
-    const changes = passedChanges as Changes;
+    const isRecordingMode = onChanges !== undefined;
+    let changes = $state<Changes>({ data: {}, children: {} });
 
     const fieldNames = Object.keys(ctx.meta.collections[collectionName].fields);
     let values = $state(getDefaultEntry(ctx, fieldNames, collectionName, passedValues));
     let fieldsErrors: Record<string, any> = $state({});
 
-    const childCollections = ctx.meta.relations
-        .filter((r) => r.to.collection === collectionName)
-        .map((r) => (r as any).from.collection);
-
-    const subCollectionsValues: Record<string, any> = {};
-    for (const col of childCollections) {
-        if (passedValues[col]) subCollectionsValues[col] = passedValues[col];
-    }
-
     $effect(() => {
         const snap = $state.snapshot(values);
-
         untrack(() => {
             const data: Record<string, any> = {};
-            const children: Record<string, any> = {};
-
             for (const [key, value] of Object.entries(snap)) {
-                if (childCollections.includes(key) && Array.isArray(value)) {
-                    children[key] = {
-                        created: (value as any[]).filter((r) => !r.id).map((r) => ({ data: r })),
-                        updated: [],
-                        deleted: [],
-                        linked: (value as any[]).filter((r) => r.id).map((r) => r.id),
-                        unlinked: [],
-                    };
-                } else if (value !== null && value !== undefined && value !== '') {
+                if (value !== null && value !== undefined && value !== '') {
                     data[key] = value;
                 }
             }
-
             changes.data = data;
-            changes.children = children;
-
-            if (!isRecordingMode) {
-                console.log(`[${collectionName}] changes:`, $state.snapshot(changes));
-            }
         });
     });
 
-    function handleCancel() {
-        if (isRecordingMode) {
-            changes.data = {};
-            changes.children = {};
+    function buildPayload(changes: Changes): { data: Record<string, any>; children?: Record<string, any> } {
+        const result: Record<string, any> = {};
+        for (const [collection, ops] of Object.entries(changes.children)) {
+            const hasOps = ops.created.length || ops.linked.length;
+            if (!hasOps) continue;
+            result[collection] = {
+                ...(ops.created.length ? { create: ops.created.map((op) => op.data) } : {}),
+                ...(ops.linked.length ? { link: ops.linked.map((r) => r.id) } : {}),
+            };
         }
+        const children = Object.keys(result).length ? result : undefined;
+        return { data: changes.data, ...(children ? { children } : {}) };
+    }
+
+    function handleCancel() {
         onCancel?.();
     }
 
     async function handleSave() {
         const snap = $state.snapshot(changes);
-
-        const children = buildChildren(ctx, collectionName, { ...snap.data, ...Object.fromEntries(
-            Object.entries(snap.children).map(([col, ops]) => [
-                col,
-                [
-                    ...(ops.created.map((op) => op.data)),
-                    ...(ops.linked.map((id) => ({ id }))),
-                ]
-            ])
-        )});
-
-        const response = await lobb.createOne(collectionName, snap.data, children, undefined, isRecordingMode);
+        const response = await lobb.createOne(collectionName, buildPayload(snap), undefined, isRecordingMode);
 
         if (response.status === 204) {
+            onChanges?.(snap);
             if (onSuccessfullSave) await onSuccessfullSave(snap);
             toast.success(`The record was successfully created`);
             handleCancel();
@@ -133,6 +106,7 @@
             }
         }
 
+        onChanges?.(snap);
         if (onSuccessfullSave) await onSuccessfullSave(snap);
         toast.success(`The record was successfully created`);
         onCancel?.();
@@ -161,7 +135,7 @@
     <div class="flex-1 overflow-y-auto">
         <DetailView {collectionName} bind:entry={values} {fieldsErrors} />
         {#if showRelatedRecords}
-            <Children {collectionName} values={subCollectionsValues} bind:entry={values} />
+            <CreateDetailViewChildren {collectionName} {changes} onChanges={(children) => { changes.children = children; }} />
         {/if}
     </div>
     <div class="flex h-12 items-center justify-end gap-2 border-t px-4">