@dxos/plugin-kanban 0.8.4-main.bc674ce → 0.8.4-main.bcb3aa67d6

package/src/containers/KanbanContainer/KanbanContainer.tsx

@@ -0,0 +1,96 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { RegistryContext } from '@effect-atom/atom-react';
+import React, { useCallback, useContext, useMemo } from 'react';
+
+import { useCapabilities, useOperationInvoker } from '@dxos/app-framework/ui';
+import { AppCapabilities } from '@dxos/app-toolkit';
+import { type ObjectSurfaceProps } from '@dxos/app-toolkit/ui';
+import { Filter, Obj, Query, Type } from '@dxos/echo';
+import { AtomQuery } from '@dxos/echo-atom';
+import { useObject, useSchema } from '@dxos/react-client/echo';
+import { Panel, Toolbar } from '@dxos/react-ui';
+import { getTagFromQuery, getTypenameFromQuery } from '@dxos/schema';
+
+import { KanbanBoard } from '#components';
+import { useEchoChangeCallback, useProjectionModel } from '#hooks';
+import { type Kanban } from '#types';
+import { KanbanOperation } from '#operations';
+
+export type KanbanContainerProps = ObjectSurfaceProps<Kanban.Kanban>;
+
+export const KanbanContainer = ({ role, subject: object }: KanbanContainerProps) => {
+  const registry = useContext(RegistryContext);
+  const schemas = useCapabilities(AppCapabilities.Schema);
+  const db = Obj.getDatabase(object);
+  const { invokePromise } = useOperationInvoker();
+  const [view] = useObject(object.view);
+  const typename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
+  const tag = view?.query ? getTagFromQuery(view.query.ast) : undefined;
+
+  const schemaFromDb = useSchema(db, typename);
+  const cardSchema = useMemo(
+    () => schemaFromDb ?? schemas.flat().find((schema) => Type.getTypename(schema) === typename),
+    [schemaFromDb, schemas, typename],
+  );
+
+  const items = useMemo(() => {
+    if (!db) {
+      return null;
+    }
+    const baseFilter = cardSchema ? Filter.type(cardSchema) : Filter.nothing();
+    const query = tag ? Query.select(baseFilter).select(Filter.tag(tag)) : Query.select(baseFilter);
+    return AtomQuery.make(db, query);
+  }, [db, cardSchema, tag]);
+
+  const projection = useProjectionModel(cardSchema, object, registry);
+  const change = useEchoChangeCallback(object);
+
+  const pivotFieldId = view?.projection?.pivotFieldId;
+  const columnFieldPath =
+    projection && pivotFieldId ? projection.tryGetFieldProjection(pivotFieldId)?.props.property : undefined;
+
+  const handleCardAdd = useCallback(
+    (columnValue: string | undefined) => {
+      if (db && cardSchema && columnFieldPath) {
+        const card = Obj.make(cardSchema, { [columnFieldPath]: columnValue });
+        db.add(card);
+        return card.id;
+      }
+    },
+    [db, cardSchema, columnFieldPath],
+  );
+
+  const handleCardRemove = useCallback(
+    (card: { id: string }) => {
+      void invokePromise(KanbanOperation.DeleteCard, { card });
+    },
+    [invokePromise],
+  );
+
+  if (!object || !db || !items || !projection || !change) {
+    return null;
+  }
+
+  return (
+    <Panel.Root role={role}>
+      <Panel.Toolbar asChild>
+        <Toolbar.Root />
+      </Panel.Toolbar>
+      <KanbanBoard.Root
+        kanban={object}
+        projection={projection}
+        items={items}
+        change={change}
+        onCardAdd={handleCardAdd}
+        onCardRemove={handleCardRemove}
+      >
+        <Panel.Content asChild>
+          <KanbanBoard.Content />
+        </Panel.Content>
+      </KanbanBoard.Root>
+    </Panel.Root>
+  );
+};

package/src/containers/KanbanContainer/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { KanbanContainer } from './KanbanContainer';
+
+export default KanbanContainer;

package/src/{components → containers/KanbanViewEditor}/KanbanViewEditor.tsx

@@ -5,40 +5,44 @@
 import { RegistryContext } from '@effect-atom/atom-react';
 import React, { useCallback, useContext, useMemo } from 'react';
 
+import { type ObjectSurfaceProps } from '@dxos/app-toolkit/ui';
 import { Obj } from '@dxos/echo';
 import { Format } from '@dxos/echo/internal';
-import { invariant } from '@dxos/invariant';
-import { useSchema } from '@dxos/react-client/echo';
+import { useObject, useSchema } from '@dxos/react-client/echo';
 import { Form, type FormFieldMap, SelectField } from '@dxos/react-ui-form';
-import { useProjectionModel } from '@dxos/react-ui-kanban';
-import { type Kanban } from '@dxos/react-ui-kanban/types';
 import { getTypenameFromQuery } from '@dxos/schema';
 
-import { SettingsSchema } from '../types';
+import { useProjectionModel } from '#hooks';
+import { type Kanban, SettingsSchema } from '#types';
 
-type KanbanViewEditorProps = { object: Kanban.Kanban };
+export type KanbanViewEditorProps = ObjectSurfaceProps<Kanban.Kanban>;
 
-export const KanbanViewEditor = ({ object }: KanbanViewEditorProps) => {
+export const KanbanViewEditor = ({ subject: object }: KanbanViewEditorProps) => {
   const registry = useContext(RegistryContext);
   const db = Obj.getDatabase(object);
-  const view = object.view.target;
+  const [view, updateView] = useObject(object.view);
   const currentTypename = view?.query ? getTypenameFromQuery(view.query.ast) : undefined;
   const schema = useSchema(db, currentTypename);
   const projection = useProjectionModel(schema, object, registry);
 
-  const fieldProjections = projection?.getFieldProjections() || [];
-  const selectFields = fieldProjections
-    .filter((field) => field.props.format === Format.TypeFormat.SingleSelect)
-    .map(({ field }) => ({ value: field.id, label: field.path }));
+  const fieldProjections = projection?.getFieldProjections() ?? [];
+  const selectFields = useMemo(
+    () =>
+      fieldProjections
+        .filter((field) => field.props.format === Format.TypeFormat.SingleSelect)
+        .map(({ field }) => ({ value: field.id, label: field.path })),
+    [fieldProjections],
+  );
 
-  const handleSave = useCallback(
+  const handleValuesChanged = useCallback(
     (values: Partial<{ columnFieldId: string }>) => {
-      invariant(view);
-      Obj.change(view, (v) => {
-        v.projection.pivotFieldId = values.columnFieldId;
-      });
+      if (values.columnFieldId != null) {
+        updateView((view) => {
+          view.projection.pivotFieldId = values.columnFieldId;
+        });
+      }
     },
-    [view],
+    [updateView],
   );
 
   const initialValues = useMemo(
@@ -52,7 +56,7 @@ export const KanbanViewEditor = ({ object }: KanbanViewEditorProps) => {
   );
 
   return (
-    <Form.Root schema={SettingsSchema} values={initialValues} fieldMap={fieldMap} autoSave onSave={handleSave}>
+    <Form.Root schema={SettingsSchema} values={initialValues} fieldMap={fieldMap} onValuesChanged={handleValuesChanged}>
       <Form.FieldSet />
     </Form.Root>
   );

package/src/containers/KanbanViewEditor/index.ts

@@ -0,0 +1,7 @@
+//
+// Copyright 2026 DXOS.org
+//
+
+import { KanbanViewEditor } from './KanbanViewEditor';
+
+export default KanbanViewEditor;

package/src/containers/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2024 DXOS.org
+//
+
+import { type ComponentType, lazy } from 'react';
+
+export const KanbanContainer: ComponentType<any> = lazy(() => import('./KanbanContainer'));
+export const KanbanViewEditor: ComponentType<any> = lazy(() => import('./KanbanViewEditor'));

package/src/hooks/index.ts

@@ -0,0 +1,9 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+export * from './useEchoChangeCallback';
+export * from './useKanbanBoardModel';
+export * from './useKanbanColumnEventHandler';
+export * from './useKanbanItemEventHandler';
+export * from './useProjectionModel';

package/src/hooks/useEchoChangeCallback.ts

@@ -0,0 +1,30 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { useMemo } from 'react';
+
+import { Obj } from '@dxos/echo';
+
+import { type Kanban, type KanbanChangeCallback } from '#types';
+
+/**
+ * Creates a change callback for ECHO-backed kanban and items (plain function, no hooks).
+ * Use this when the kanban and items are stored in the ECHO database.
+ */
+export const createEchoChangeCallback = <T extends Obj.Unknown>(kanban: Kanban.Kanban): KanbanChangeCallback<T> => ({
+  kanban: (mutate) => Obj.change(kanban, (kanban) => mutate(kanban)),
+  setItemField: (item, field, value) => {
+    Obj.change(item, (item: any) => {
+      item[field] = value;
+    });
+  },
+});
+
+/**
+ * Returns a memoized ECHO change callback for the given kanban.
+ * Returns null when kanban is undefined.
+ */
+export const useEchoChangeCallback = <T extends Obj.Unknown = Obj.Unknown>(
+  kanban: Kanban.Kanban | undefined,
+): KanbanChangeCallback<T> | null => useMemo(() => (kanban ? createEchoChangeCallback<T>(kanban) : null), [kanban]);

package/src/hooks/useKanbanBoardModel.test.ts

@@ -0,0 +1,235 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Atom, Registry } from '@effect-atom/atom-react';
+import { act, renderHook } from '@testing-library/react';
+import * as Schema from 'effect/Schema';
+import { beforeEach, describe, test } from 'vitest';
+
+import { Filter, JsonSchema, Obj, Query, Type } from '@dxos/echo';
+import { type View } from '@dxos/echo';
+import { Format, FormatAnnotation, PropertyMetaAnnotationId } from '@dxos/echo/internal';
+import { ObjectId } from '@dxos/keys';
+import { ProjectionModel, ViewModel, createDirectChangeCallback } from '@dxos/schema';
+
+import { Kanban } from '#types';
+
+import { useKanbanBoardModel } from './useKanbanBoardModel';
+
+// TODO(wittjosiah): Consider adding single-select to TestSchema.Task and using that instead.
+const KanbanTaskSchema = Schema.Struct({
+  title: Schema.optional(Schema.String),
+  status: Schema.Literal('__uncategorized__', 'a', 'b').pipe(
+    FormatAnnotation.set(Format.TypeFormat.SingleSelect),
+    Schema.annotations({
+      title: 'Status',
+      [PropertyMetaAnnotationId]: {
+        singleSelect: {
+          options: [
+            { id: '__uncategorized__', title: 'Uncategorized', color: 'neutral' },
+            { id: 'a', title: 'A', color: 'blue' },
+            { id: 'b', title: 'B', color: 'green' },
+          ],
+        },
+      },
+    }),
+    Schema.optional,
+  ),
+}).pipe(
+  Type.object({
+    typename: 'com.example.type.kanban-task',
+    version: '0.1.0',
+  }),
+);
+
+type KanbanTask = Schema.Schema.Type<typeof KanbanTaskSchema>;
+
+describe('useKanbanBoardModel', () => {
+  let registry: Registry.Registry;
+  let view: View.View;
+  let kanban: Kanban.Kanban;
+  let projection: ProjectionModel;
+
+  beforeEach(() => {
+    registry = Registry.make();
+    const jsonSchema = JsonSchema.toJsonSchema(KanbanTaskSchema) as Parameters<typeof createDirectChangeCallback>[1];
+    view = ViewModel.make({
+      query: Query.select(Filter.type(KanbanTaskSchema)),
+      jsonSchema,
+      pivotFieldName: 'status',
+    });
+    kanban = Kanban.make({
+      view: view,
+      arrangement: {
+        order: ['a', 'b'],
+        columns: { a: { ids: [] }, b: { ids: [] } },
+      },
+    });
+    projection = new ProjectionModel({
+      registry,
+      view,
+      baseSchema: jsonSchema,
+      change: createDirectChangeCallback(view.projection, jsonSchema),
+    });
+  });
+
+  test('returns model with getColumns and getItems', ({ expect }) => {
+    const itemA = Obj.make(KanbanTaskSchema, { status: 'a' });
+    const itemB = Obj.make(KanbanTaskSchema, { status: 'b' });
+    const initialItems: KanbanTask[] = [itemA, itemB];
+    const itemsAtom = Atom.make<KanbanTask[]>(() => initialItems);
+
+    const { result } = renderHook(() => useKanbanBoardModel(kanban, projection, itemsAtom, registry));
+
+    const model = result.current;
+    expect(model.getColumnId).toBeDefined();
+    expect(model.getItemId).toBeDefined();
+    expect(model.isColumn).toBeDefined();
+    expect(model.isItem).toBeDefined();
+
+    const columns = model.getColumns();
+    expect(columns.length).toBeGreaterThanOrEqual(1);
+    const columnValues = columns.map((col) => col.columnValue);
+    expect(columnValues).toContain('a');
+    expect(columnValues).toContain('b');
+
+    const colA = columns.find((c) => c.columnValue === 'a');
+    const colB = columns.find((c) => c.columnValue === 'b');
+    expect(colA).toBeDefined();
+    expect(colB).toBeDefined();
+
+    const itemsA = model.getItems(colA!);
+    const itemsB = model.getItems(colB!);
+    expect(itemsA.map((i) => i.id)).toContain(itemA.id);
+    expect(itemsB.map((i) => i.id)).toContain(itemB.id);
+  });
+
+  test('getItems updates when itemsAtom source changes', ({ expect }) => {
+    const initialItem = Obj.make(KanbanTaskSchema, { status: 'a' });
+    const initialItems: KanbanTask[] = [initialItem];
+    const initialItemsAtom = Atom.make<KanbanTask[]>(() => initialItems);
+
+    const { result, rerender } = renderHook(
+      ({ itemsAtom }) => useKanbanBoardModel(kanban, projection, itemsAtom, registry),
+      { initialProps: { itemsAtom: initialItemsAtom } },
+    );
+
+    const columns = result.current.getColumns();
+    const colA = columns.find((c) => c.columnValue === 'a');
+    expect(colA).toBeDefined();
+    expect(result.current.getItems(colA!).length).toBe(1);
+    expect(result.current.getItems(colA!).map((i) => i.id)).toEqual([initialItem.id]);
+
+    const secondItem = Obj.make(KanbanTaskSchema, { status: 'a' });
+    const newItems: KanbanTask[] = [initialItem, secondItem];
+    const newItemsAtom = Atom.make<KanbanTask[]>(() => newItems);
+    act(() => {
+      rerender({ itemsAtom: newItemsAtom });
+    });
+
+    expect(result.current.getItems(colA!).length).toBe(2);
+    expect(result.current.getItems(colA!).map((i) => i.id)).toEqual([initialItem.id, secondItem.id]);
+  });
+
+  test('columns atom updates when kanban arrangement changes', ({ expect }) => {
+    const itemsAtom = Atom.make<KanbanTask[]>(() => []);
+    const { result } = renderHook(() => useKanbanBoardModel(kanban, projection, itemsAtom, registry));
+
+    let columnsUpdateCount = 0;
+    registry.subscribe(result.current.columns, () => {
+      columnsUpdateCount++;
+    });
+
+    const columnsBefore = result.current.getColumns();
+    const orderBefore = columnsBefore.map((c) => c.columnValue);
+    expect(orderBefore).toEqual(['__uncategorized__', 'a', 'b']);
+
+    act(() => {
+      Obj.change(kanban, (kanban) => {
+        kanban.arrangement.order = ['b', 'a'];
+      });
+    });
+
+    const columnsAfter = registry.get(result.current.columns) ?? [];
+    const orderAfter = columnsAfter.map((c) => c.columnValue);
+    expect(orderAfter).toEqual(['__uncategorized__', 'b', 'a']);
+    // TODO(wittjosiah): Try to reduce to 1.
+    expect(columnsUpdateCount).toBe(2);
+  });
+
+  test('getItems returns items in column ordered by arrangement ids', ({ expect }) => {
+    const item1 = Obj.make(KanbanTaskSchema, {
+      id: ObjectId.random(),
+      status: 'a',
+    });
+    const item2 = Obj.make(KanbanTaskSchema, {
+      id: ObjectId.random(),
+      status: 'a',
+    });
+    const item3 = Obj.make(KanbanTaskSchema, {
+      id: ObjectId.random(),
+      status: 'a',
+    });
+    const items: KanbanTask[] = [item1, item2, item3];
+    const itemsAtom = Atom.make<KanbanTask[]>(() => items);
+
+    const { result } = renderHook(() => useKanbanBoardModel(kanban, projection, itemsAtom, registry));
+
+    const columns = result.current.getColumns();
+    const colA = columns.find((c) => c.columnValue === 'a');
+    expect(colA).toBeDefined();
+    expect(result.current.getItems(colA!).length).toBe(3);
+
+    let itemsColAUpdateCount = 0;
+    registry.subscribe(result.current.items(colA!), () => {
+      itemsColAUpdateCount++;
+    });
+
+    act(() => {
+      Obj.change(kanban, (kanban) => {
+        kanban.arrangement.columns['a'] = {
+          ids: [item3.id, item1.id, item2.id],
+        };
+      });
+    });
+
+    const itemsAfter = result.current.getItems(colA!);
+    expect(itemsAfter.map((i) => i.id)).toEqual([item3.id, item1.id, item2.id]);
+    expect(itemsColAUpdateCount).toBe(1);
+  });
+
+  test('subscribing to one column items atom does not fire when another column changes', ({ expect }) => {
+    const itemA = Obj.make(KanbanTaskSchema, {
+      id: ObjectId.random(),
+      status: 'a',
+    });
+    const itemB = Obj.make(KanbanTaskSchema, {
+      id: ObjectId.random(),
+      status: 'b',
+    });
+    const items: KanbanTask[] = [itemA, itemB];
+    const itemsAtom = Atom.make<KanbanTask[]>(() => items);
+
+    const { result } = renderHook(() => useKanbanBoardModel(kanban, projection, itemsAtom, registry));
+
+    const columns = result.current.getColumns();
+    const colA = columns.find((c) => c.columnValue === 'a');
+    const colB = columns.find((c) => c.columnValue === 'b');
+    expect(colA).toBeDefined();
+    expect(colB).toBeDefined();
+
+    let itemsColAUpdateCount = 0;
+    registry.subscribe(result.current.items(colA!), () => {
+      itemsColAUpdateCount++;
+    });
+
+    act(() => {
+      Obj.change(kanban, (kanban) => {
+        kanban.arrangement.columns['b'] = { ids: [itemB.id] };
+      });
+    });
+
+    expect(itemsColAUpdateCount).toBe(0);
+  });
+});

package/src/hooks/useKanbanBoardModel.ts

@@ -0,0 +1,143 @@
+//
+// Copyright 2025 DXOS.org
+//
+
+import { Atom, type Registry } from '@effect-atom/atom-react';
+import { useMemo } from 'react';
+
+import { Obj } from '@dxos/echo';
+import { AtomObj } from '@dxos/echo-atom';
+import type { BoardModel } from '@dxos/react-ui-mosaic';
+import type { ProjectionModel } from '@dxos/schema';
+
+import { type BaseKanbanItem, type ColumnStructure, type Kanban } from '#types';
+import {
+  computeColumnStructure,
+  getOrderByColumnFromArrangement,
+  getOrderFromArrangement,
+  orderItemsInColumn,
+} from '../util';
+
+/**
+ * Builds a board model that maps kanban arrangement and projection onto columns and per-column items.
+ *
+ * @template T - Item type (must have id; defaults to BaseKanbanItem).
+ * @param kanban - Kanban object (arrangement, view).
+ * @param projection - ProjectionModel for pivot field and options.
+ * @param itemsAtom - Atom holding the full item list.
+ * @param registry - Registry for reading atom values.
+ * @returns BoardModel with columns atom, items family, and getColumns/getItems.
+ */
+export function useKanbanBoardModel<T extends BaseKanbanItem = BaseKanbanItem>(
+  kanban: Kanban.Kanban,
+  projection: ProjectionModel,
+  itemsAtom: Atom.Atom<T[]>,
+  registry: Registry.Registry,
+): BoardModel<ColumnStructure, T> {
+  // Source atoms: reactive reads from the kanban object; items come from the passed-in atom (e.g. AtomQuery or in-memory).
+  const arrangementAtom = useMemo(() => AtomObj.makeProperty(kanban, 'arrangement'), [kanban]);
+  const viewSnapshotAtom = useMemo(
+    () => (kanban?.view ? AtomObj.make(kanban.view) : Atom.make<undefined>(() => undefined)),
+    [kanban?.view],
+  );
+
+  /** Only changes when view.projection.pivotFieldId changes; keeps columns from firing on other view updates. */
+  const pivotFieldIdAtom = useMemo(
+    () => Atom.make((get) => get(viewSnapshotAtom)?.projection?.pivotFieldId as string | undefined),
+    [viewSnapshotAtom],
+  );
+
+  // Effective per-column ids: from kanban.arrangement.columns; empty when arrangement has no columns.
+  const effectiveByColumnAtom = useMemo(
+    () => Atom.make((get) => getOrderByColumnFromArrangement(get(arrangementAtom))),
+    [arrangementAtom],
+  );
+
+  // Column structure: depends on pivotFieldId (not full view), arrangement, and projection so columns only fire when pivot or arrangement changes.
+  const columnsAtom = useMemo(
+    () =>
+      Atom.make((get) => {
+        const pivotFieldId = get(pivotFieldIdAtom);
+        if (pivotFieldId === undefined) {
+          return [];
+        }
+
+        get(projection.fields);
+        const fieldProj = projection.tryGetFieldProjection(pivotFieldId);
+        if (!fieldProj) {
+          return [];
+        }
+
+        const selectOptions = fieldProj.props.options ?? [];
+        if (selectOptions.length === 0) {
+          return [];
+        }
+
+        const arrangement = get(arrangementAtom);
+        const order = getOrderFromArrangement(arrangement);
+        const byColumn = getOrderByColumnFromArrangement(arrangement);
+        return computeColumnStructure(order, byColumn, selectOptions);
+      }),
+    [pivotFieldIdAtom, arrangementAtom, projection],
+  );
+
+  // Per-column slice of arrangement so each column’s items atom only depends on that column’s ids.
+  const columnArrangementAtomFamily = useMemo(
+    () =>
+      Atom.family<string, Atom.Atom<ColumnStructure>>((columnValue: string) =>
+        Atom.make((get) => {
+          const byColumn = get(effectiveByColumnAtom);
+          return {
+            columnValue,
+            ids: [...(byColumn[columnValue]?.ids ?? [])],
+          };
+        }),
+      ),
+    [effectiveByColumnAtom],
+  );
+
+  // Items for a single column: filter all items by pivot field, sort by this column’s ids, then append new items.
+  const itemsAtomFamily = useMemo(
+    () =>
+      Atom.family<string, Atom.Atom<T[]>>((columnValue: string) =>
+        Atom.make((get) => {
+          const columnArr = get(columnArrangementAtomFamily(columnValue));
+          const allItems = get(itemsAtom);
+          const pivotFieldId = get(pivotFieldIdAtom);
+
+          if (pivotFieldId === undefined) {
+            return [];
+          }
+
+          // TODO(wittjosiah): Try to narrow this down further.
+          get(projection.fields);
+          const fieldProj = projection.tryGetFieldProjection(pivotFieldId);
+          if (!fieldProj) {
+            return [];
+          }
+
+          const selectOptions = fieldProj.props.options ?? [];
+          const pivotPath = fieldProj.props.property;
+          const validColumnValues = new Set(selectOptions.map((opt) => opt.id));
+          return orderItemsInColumn(allItems, columnArr.ids, columnValue, pivotPath, validColumnValues);
+        }),
+      ),
+    [columnArrangementAtomFamily, itemsAtom, pivotFieldIdAtom, projection],
+  );
+
+  return useMemo(
+    () => ({
+      getColumnId: (data) => data.columnValue,
+      getItemId: (data) => (data as T).id,
+      isColumn: (obj): obj is ColumnStructure =>
+        typeof obj === 'object' && obj !== null && 'columnValue' in obj && 'ids' in obj,
+      // TODO(wittjosiah): This should be restricted to objects of the type of the kanban view.
+      isItem: (obj): obj is T => Obj.isObject(obj),
+      columns: columnsAtom,
+      items: (column) => itemsAtomFamily(column.columnValue),
+      getColumns: () => registry.get(columnsAtom) ?? [],
+      getItems: (column) => registry.get(itemsAtomFamily(column.columnValue)) ?? [],
+    }),
+    [columnsAtom, itemsAtomFamily, registry],
+  );
+}