@chelone/core 0.3.0 → 0.4.0

package/dist/controller/calendar-events.d.ts

@@ -1,3 +1,4 @@
+import type { SourcePath } from "../resource/source-path.js";
 import { type CalendarRange } from "./calendar-dates.js";
 export interface CalendarEvent<R> {
     record: R;
@@ -7,10 +8,10 @@ export interface CalendarEvent<R> {
     color?: string;
 }
 export interface ToCalendarEventsOptions<R> {
-    startSource: string;
-    endSource?: string;
-    titleSource?: string;
-    colorSource?: string;
+    startSource: SourcePath<R>;
+    endSource?: SourcePath<R>;
+    titleSource?: SourcePath<R>;
+    colorSource?: SourcePath<R>;
     /** Maps the value at `colorSource` to a color. */
     colorMap?: Record<string, string>;
     /** The title when `titleSource` is unset or empty: the adapter fills it from the record representation. */

package/dist/controller/kanban-board.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Pure rules behind a kanban board: which column holds which record, and what
+ * a drop writes back. No react, no vue: both `KanbanBoard` adapters build the
+ * same columns from the same records, and a drag handler that decides for
+ * itself lets the two boards disagree about the same drop.
+ *
+ * Drag events stay in the adapters, as `CalendarList` keeps its drag glue
+ * beside {@link moveCalendarEvent}.
+ */
+import type { Identifier } from "../resource/identifier.js";
+import type { ResourceRecord } from "../resource/record.js";
+import type { SourceKey } from "../resource/source-path.js";
+export interface KanbanColumnDef {
+    /** Value written to `groupSource` by a drop into this column. */
+    id: string;
+    label: string;
+    className?: string;
+}
+export interface KanbanBucket<R> {
+    column: KanbanColumnDef;
+    records: R[];
+}
+/**
+ * The update a drop asks for, in the shape `update` takes: `data` is the patch
+ * and `previousData` the record as it was, so an adapter can undo the drop
+ * without a second read.
+ */
+export interface KanbanMove<R> {
+    id: Identifier;
+    data: Record<string, string>;
+    previousData: R;
+}
+/**
+ * One bucket per column, in column order, empty columns included. A record
+ * lands in the column whose id is its group key; a record that names no column
+ * is in no bucket, and records keep list order inside a bucket. A repeated
+ * column id keeps the first column's records and leaves the later one empty.
+ */
+export declare function buildKanbanBuckets<R extends ResourceRecord>(records: readonly R[], groupSource: SourceKey<R>, columns: readonly KanbanColumnDef[]): KanbanBucket<R>[];
+/**
+ * The update a drop into `targetColumnId` asks for, or `null` when there is
+ * nothing to write: the target is not a column, or the record already sits in
+ * it. A drop that writes nothing still fires a data-provider `update` on every
+ * board that re-renders on a dropped drag, so the adapters ask here first.
+ */
+export declare function planKanbanMove<R extends ResourceRecord>(record: R, groupSource: SourceKey<R>, columns: readonly KanbanColumnDef[], targetColumnId: string): KanbanMove<R> | null;

package/dist/controller/kanban-board.js

@@ -0,0 +1,30 @@
+function bucketKey(record, groupSource) {
+  const value = record[groupSource];
+  return String(value ?? "");
+}
+function buildKanbanBuckets(records, groupSource, columns) {
+  const buckets = columns.map((column) => ({
+    column,
+    records: []
+  }));
+  const bucketOf = /* @__PURE__ */ new Map();
+  columns.forEach((column, index) => {
+    if (!bucketOf.has(column.id)) bucketOf.set(column.id, index);
+  });
+  for (const record of records) {
+    const index = bucketOf.get(bucketKey(record, groupSource));
+    if (index === void 0) continue;
+    buckets[index].records.push(record);
+  }
+  return buckets;
+}
+function planKanbanMove(record, groupSource, columns, targetColumnId) {
+  if (!columns.some((column) => column.id === targetColumnId)) return null;
+  if (bucketKey(record, groupSource) === targetColumnId) return null;
+  const data = { [groupSource]: targetColumnId };
+  return { id: record.id, data, previousData: record };
+}
+export {
+  buildKanbanBuckets,
+  planKanbanMove
+};

package/dist/controller/record-tree.d.ts

@@ -4,6 +4,7 @@
  * records, and no record disappears when the data holds a parent cycle.
  */
 import type { Identifier } from "../resource/identifier.js";
+import type { SourcePath } from "../resource/source-path.js";
 export interface RecordTreeNode<R> {
     record: R;
     children: RecordTreeNode<R>[];
@@ -17,4 +18,4 @@ export interface RecordTreeNode<R> {
  */
 export declare function buildRecordTree<R extends {
     id: Identifier;
-}>(records: readonly R[], parentSource: string): RecordTreeNode<R>[];
+}>(records: readonly R[], parentSource: SourcePath<R>): RecordTreeNode<R>[];

package/dist/index.d.ts

@@ -21,6 +21,8 @@ export { arrangeColumns, columnLabelMatches, dataTableColumnKeys, defaultDataTab
 export { isFilterSelected, toggleFilterValue, } from "./controller/filter-toggle.js";
 export type { InfiniteListController, InfiniteListControllerState, } from "./controller/infinite-list-controller.js";
 export { createInfiniteListController } from "./controller/infinite-list-controller.js";
+export type { KanbanBucket, KanbanColumnDef, KanbanMove, } from "./controller/kanban-board.js";
+export { buildKanbanBuckets, planKanbanMove, } from "./controller/kanban-board.js";
 export type { ListController, ListControllerContext, ListControllerOptions, ListControllerState, ListParamsPatch, } from "./controller/list-controller.js";
 export { createListController, listControllerActions, } from "./controller/list-controller.js";
 export type { ListParamsQuery, ListUrlState, } from "./controller/list-params.js";

package/dist/index.js

@@ -10,6 +10,7 @@ import { createClientListController } from "./controller/client-list-controller.
 import { arrangeColumns, columnLabelMatches, dataTableColumnKeys, defaultDataTableStoreKey, getDataTableColumnId, moveColumn, toggleHiddenColumn } from "./controller/data-table-columns.js";
 import { isFilterSelected, toggleFilterValue } from "./controller/filter-toggle.js";
 import { createInfiniteListController } from "./controller/infinite-list-controller.js";
+import { buildKanbanBuckets, planKanbanMove } from "./controller/kanban-board.js";
 import { createListController, listControllerActions } from "./controller/list-controller.js";
 import { hasCustomParams, listPatchFromSearch, parseListParams, serializeListParams, serializeListState } from "./controller/list-params.js";
 import { canUseCachedPage, getPrevNextParams, resolvePrevNext } from "./controller/prev-next.js";
@@ -117,6 +118,7 @@ export {
   authStateQueryOptions,
   bboxToPolygon,
   buildApprovalUpdate,
+  buildKanbanBuckets,
   buildOverpassQuery,
   buildRecordTree,
   calendarDayKey,
@@ -290,6 +292,7 @@ export {
   parseLocation,
   patchedRecord,
   permissionsQueryOptions,
+  planKanbanMove,
   polygonToBBox,
   presenceTopic,
   rasterTileStyle,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chelone/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",