@stll/workspace-ui 0.3.2 → 0.4.0

package/dist/calculations.d.ts

@@ -28,7 +28,7 @@ type CalculationPickerProps = {
  * Choose what a view calculates: a property, then a reduction. Every step is a
  * menu item, so the whole choice is reachable from the keyboard.
  */
-declare const CalculationPicker: ({ labels, properties, selections, onChange, children }: CalculationPickerProps) => import("react").JSX.Element;
+declare const CalculationPicker: ({ labels, properties, selections, onChange, children }: CalculationPickerProps) => import("react").JSX.Element | null;
 type CalculationKindPickerProps = {
   labels: WorkspaceCalculationLabels;
   /** Reductions this column's values allow. */
@@ -43,7 +43,7 @@ type CalculationKindPickerProps = {
  * Choose one column's reduction. The board picks a property first (it shows one
  * line for the whole board); a table column already is the property.
  */
-declare const CalculationKindPicker: ({ labels, kinds, value, onChange, children }: CalculationKindPickerProps) => import("react").JSX.Element;
+declare const CalculationKindPicker: ({ labels, kinds, value, onChange, children }: CalculationKindPickerProps) => import("react").JSX.Element | null;
 type CalculationSummaryProps = {
   calculation: FormattedCalculation;
 };

package/dist/calculations.js

@@ -13,6 +13,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 * menu item, so the whole choice is reachable from the keyboard.
 */
 const CalculationPicker = ({ labels, properties, selections, onChange, children }) => {
+	if (properties.length === 0) return null;
 	const select = (propertyId, kind) => {
 		onChange(applyCalculationSelection({
 			selections,
@@ -27,10 +28,7 @@ const CalculationPicker = ({ labels, properties, selections, onChange, children
 			variant: "ghost"
 		}),
 		children: children ?? /* @__PURE__ */ jsx(SigmaIcon, {})
-	}), /* @__PURE__ */ jsxs(MenuPopup, { children: [properties.length === 0 && /* @__PURE__ */ jsx(MenuItem, {
-		disabled: true,
-		children: labels.noProperties
-	}), properties.map((property) => {
+	}), /* @__PURE__ */ jsx(MenuPopup, { children: properties.map((property) => {
 		const selected = selections.find((selection) => selection.propertyId === property.id);
 		return /* @__PURE__ */ jsxs(MenuSub, { children: [/* @__PURE__ */ jsx(MenuSubTrigger, { children: property.name }), /* @__PURE__ */ jsxs(MenuSubPopup, { children: [/* @__PURE__ */ jsxs(MenuItem, {
 			onClick: () => select(property.id, null),
@@ -39,26 +37,29 @@ const CalculationPicker = ({ labels, properties, selections, onChange, children
 			onClick: () => select(property.id, kind),
 			children: [selected?.kind === kind ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx("span", {}), labels.kinds[kind]]
 		}, kind))] })] }, property.id);
-	})] })] });
+	}) })] });
 };
 /**
 * Choose one column's reduction. The board picks a property first (it shows one
 * line for the whole board); a table column already is the property.
 */
-const CalculationKindPicker = ({ labels, kinds, value, onChange, children }) => /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
-	"aria-label": labels.choose,
-	render: /* @__PURE__ */ jsx(Button, {
-		size: "icon-xs",
-		variant: "ghost"
-	}),
-	children: children ?? /* @__PURE__ */ jsx(SigmaIcon, {})
-}), /* @__PURE__ */ jsxs(MenuPopup, { children: [/* @__PURE__ */ jsxs(MenuItem, {
-	onClick: () => onChange(null),
-	children: [value === null ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx("span", {}), labels.none]
-}), kinds.map((kind) => /* @__PURE__ */ jsxs(MenuItem, {
-	onClick: () => onChange(kind),
-	children: [value === kind ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx("span", {}), labels.kinds[kind]]
-}, kind))] })] });
+const CalculationKindPicker = ({ labels, kinds, value, onChange, children }) => {
+	if (kinds.length === 0) return null;
+	return /* @__PURE__ */ jsxs(Menu, { children: [/* @__PURE__ */ jsx(MenuTrigger, {
+		"aria-label": labels.choose,
+		render: /* @__PURE__ */ jsx(Button, {
+			size: "icon-xs",
+			variant: "ghost"
+		}),
+		children: children ?? /* @__PURE__ */ jsx(SigmaIcon, {})
+	}), /* @__PURE__ */ jsxs(MenuPopup, { children: [/* @__PURE__ */ jsxs(MenuItem, {
+		onClick: () => onChange(null),
+		children: [value === null ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx("span", {}), labels.none]
+	}), kinds.map((kind) => /* @__PURE__ */ jsxs(MenuItem, {
+		onClick: () => onChange(kind),
+		children: [value === kind ? /* @__PURE__ */ jsx(CheckIcon, {}) : /* @__PURE__ */ jsx("span", {}), labels.kinds[kind]]
+	}, kind))] })] });
+};
 /**
 * The calculation as one compact line. When it reduces to several currencies
 * the line stays short and the full set sits behind a tooltip.

package/dist/index.d.ts

@@ -10,6 +10,8 @@ import { getClipFieldValueLabel } from "./field-value-logic.js";
 import { FieldValue, IntFieldValue, MoneyFieldValue, PersonFieldValue } from "./field-value.js";
 import { SortChips, SortChipsLabels, SortChipsProps, SortDescriptor, SortableProperty, sortDirectionHint } from "./sorts.js";
 import { TableSkeletonRows } from "./table-skeleton-rows.js";
+import { CreateWorkspaceKanbanSchemaParams, KANBAN_EMPTY_GROUP_VISIBILITIES, KanbanBoardPresentation, KanbanEmptyGroupVisibility, KanbanPresentedLane, KanbanSavedAxisState, KanbanSavedGroupReference, KanbanSavedSubgroupState, KanbanSavedViewState, ResolveWorkspaceKanbanViewParams, ResolvedWorkspaceKanbanView, WorkspaceKanbanBuiltInGroupLabel, WorkspaceKanbanGroupingChoice, WorkspaceKanbanGroupingPickerLabels, WorkspaceKanbanGroupingPickerProps, WorkspaceKanbanProperty, createWorkspaceKanbanSchema, getWorkspaceKanbanGroupingChoices, presentKanbanBoard, resolveWorkspaceKanbanView } from "./kanban-view.js";
+import { WorkspaceKanbanGroupingPicker } from "./kanban-grouping-picker.js";
 import { WorkspaceViewDirection, WorkspaceViewDropPosition, reorderWorkspaceViewIds, toWorkspaceViewDropPosition } from "./view-switcher.logic.js";
 import { WorkspaceViewSwitcher, WorkspaceViewSwitcherEditing, WorkspaceViewSwitcherItem, WorkspaceViewSwitcherProps, WorkspaceViewSwitcherReorder } from "./view-switcher.js";
-export { type ApplyCalculationSelectionParams, CONDITION_OPERATORS, type CalculationFormatters, CalculationKindPicker, type CalculationKindPickerProps, type CalculationLabels, CalculationPicker, type CalculationPickerProps, type CalculationProperty, type CalculationResult, type CalculationSelection, CalculationSummary, type CalculationSummaryProps, type ColorVariants, ColumnCalculation, ConditionBuilder, type ConditionBuilderLabels, type ConditionCapabilities, type ConditionOperator, FIELD_CONTENT_TYPES, type FieldContent, type FieldOption, type FieldOptionChoice, FieldValue, type FieldValueType, type FormatCalculationParams, type FormatMoneyCentsParams, type FormattedCalculation, type FormulaCellRenderCtx, type GenericProperty, IntFieldValue, MoneyFieldValue, type OptionColor, PersonFieldValue, PropertyIcon, type PropertyIconType, SortChips, type SortChipsLabels, type SortChipsProps, type SortDescriptor, type SortableProperty, TableSkeletonRows, type UseCalculationParams, type ValueEditorKind, type ValueEditorRenderCtx, type WorkspaceCalculationLabels, type WorkspaceFieldContent, type WorkspaceViewDirection, type WorkspaceViewDropPosition, WorkspaceViewSwitcher, type WorkspaceViewSwitcherEditing, type WorkspaceViewSwitcherItem, type WorkspaceViewSwitcherProps, type WorkspaceViewSwitcherReorder, appendChild, applyCalculationSelection, asGroup, buildLeaf, currencyMinorUnitDigits, emptyColor, fieldForNode, formatCalculationResult, formatMoneyCents, getClipFieldValueLabel, isConditionOperator, isMultiValue, leafFromField, leafOperand, leafOperator, leafValueList, leafValueString, operandsEqual, operatorsFor, optionColors, removeChild, reorderWorkspaceViewIds, replaceChild, resolveOptionColor, sortDirectionHint, toWorkspaceViewDropPosition, useCalculation, valueEditorFor };
+export { type ApplyCalculationSelectionParams, CONDITION_OPERATORS, type CalculationFormatters, CalculationKindPicker, type CalculationKindPickerProps, type CalculationLabels, CalculationPicker, type CalculationPickerProps, type CalculationProperty, type CalculationResult, type CalculationSelection, CalculationSummary, type CalculationSummaryProps, type ColorVariants, ColumnCalculation, ConditionBuilder, type ConditionBuilderLabels, type ConditionCapabilities, type ConditionOperator, type CreateWorkspaceKanbanSchemaParams, FIELD_CONTENT_TYPES, type FieldContent, type FieldOption, type FieldOptionChoice, FieldValue, type FieldValueType, type FormatCalculationParams, type FormatMoneyCentsParams, type FormattedCalculation, type FormulaCellRenderCtx, type GenericProperty, IntFieldValue, KANBAN_EMPTY_GROUP_VISIBILITIES, type KanbanBoardPresentation, type KanbanEmptyGroupVisibility, type KanbanPresentedLane, type KanbanSavedAxisState, type KanbanSavedGroupReference, type KanbanSavedSubgroupState, type KanbanSavedViewState, MoneyFieldValue, type OptionColor, PersonFieldValue, PropertyIcon, type PropertyIconType, type ResolveWorkspaceKanbanViewParams, type ResolvedWorkspaceKanbanView, SortChips, type SortChipsLabels, type SortChipsProps, type SortDescriptor, type SortableProperty, TableSkeletonRows, type UseCalculationParams, type ValueEditorKind, type ValueEditorRenderCtx, type WorkspaceCalculationLabels, type WorkspaceFieldContent, type WorkspaceKanbanBuiltInGroupLabel, type WorkspaceKanbanGroupingChoice, WorkspaceKanbanGroupingPicker, type WorkspaceKanbanGroupingPickerLabels, type WorkspaceKanbanGroupingPickerProps, type WorkspaceKanbanProperty, type WorkspaceViewDirection, type WorkspaceViewDropPosition, WorkspaceViewSwitcher, type WorkspaceViewSwitcherEditing, type WorkspaceViewSwitcherItem, type WorkspaceViewSwitcherProps, type WorkspaceViewSwitcherReorder, appendChild, applyCalculationSelection, asGroup, buildLeaf, createWorkspaceKanbanSchema, currencyMinorUnitDigits, emptyColor, fieldForNode, formatCalculationResult, formatMoneyCents, getClipFieldValueLabel, getWorkspaceKanbanGroupingChoices, isConditionOperator, isMultiValue, leafFromField, leafOperand, leafOperator, leafValueList, leafValueString, operandsEqual, operatorsFor, optionColors, presentKanbanBoard, removeChild, reorderWorkspaceViewIds, replaceChild, resolveOptionColor, resolveWorkspaceKanbanView, sortDirectionHint, toWorkspaceViewDropPosition, useCalculation, valueEditorFor };

package/dist/index.js

@@ -10,6 +10,8 @@ import { PropertyIcon } from "./property-icon.js";
 import { SortChips, sortDirectionHint } from "./sorts.js";
 import { TableSkeletonRows } from "./table-skeleton-rows.js";
 import { FIELD_CONTENT_TYPES } from "./types.js";
+import { KANBAN_EMPTY_GROUP_VISIBILITIES, createWorkspaceKanbanSchema, getWorkspaceKanbanGroupingChoices, presentKanbanBoard, resolveWorkspaceKanbanView } from "./kanban-view.js";
+import { WorkspaceKanbanGroupingPicker } from "./kanban-grouping-picker.js";
 import { reorderWorkspaceViewIds, toWorkspaceViewDropPosition } from "./view-switcher.logic.js";
 import { WorkspaceViewSwitcher } from "./view-switcher.js";
-export { CONDITION_OPERATORS, CalculationKindPicker, CalculationPicker, CalculationSummary, ColumnCalculation, ConditionBuilder, FIELD_CONTENT_TYPES, FieldValue, IntFieldValue, MoneyFieldValue, PersonFieldValue, PropertyIcon, SortChips, TableSkeletonRows, WorkspaceViewSwitcher, appendChild, applyCalculationSelection, asGroup, buildLeaf, currencyMinorUnitDigits, emptyColor, fieldForNode, formatCalculationResult, formatMoneyCents, getClipFieldValueLabel, isConditionOperator, isMultiValue, leafFromField, leafOperand, leafOperator, leafValueList, leafValueString, operandsEqual, operatorsFor, optionColors, removeChild, reorderWorkspaceViewIds, replaceChild, resolveOptionColor, sortDirectionHint, toWorkspaceViewDropPosition, useCalculation, valueEditorFor };
+export { CONDITION_OPERATORS, CalculationKindPicker, CalculationPicker, CalculationSummary, ColumnCalculation, ConditionBuilder, FIELD_CONTENT_TYPES, FieldValue, IntFieldValue, KANBAN_EMPTY_GROUP_VISIBILITIES, MoneyFieldValue, PersonFieldValue, PropertyIcon, SortChips, TableSkeletonRows, WorkspaceKanbanGroupingPicker, WorkspaceViewSwitcher, appendChild, applyCalculationSelection, asGroup, buildLeaf, createWorkspaceKanbanSchema, currencyMinorUnitDigits, emptyColor, fieldForNode, formatCalculationResult, formatMoneyCents, getClipFieldValueLabel, getWorkspaceKanbanGroupingChoices, isConditionOperator, isMultiValue, leafFromField, leafOperand, leafOperator, leafValueList, leafValueString, operandsEqual, operatorsFor, optionColors, presentKanbanBoard, removeChild, reorderWorkspaceViewIds, replaceChild, resolveOptionColor, resolveWorkspaceKanbanView, sortDirectionHint, toWorkspaceViewDropPosition, useCalculation, valueEditorFor };

package/dist/kanban-grouping-picker.d.ts

@@ -0,0 +1,9 @@
+import { WorkspaceKanbanGroupingPickerProps, WorkspaceKanbanProperty } from "./kanban-view.js";
+//#region src/kanban-grouping-picker.d.ts
+/**
+ * Accessible picker shared by the board's Group and Sub-group controls. The
+ * caller labels built-ins because only its domain owns their human names.
+ */
+declare const WorkspaceKanbanGroupingPicker: <TRow, TProperty extends WorkspaceKanbanProperty>({ allowNone, excludedGroupBy, getBuiltInGroupLabel, labels, onValueChange, schema, value }: WorkspaceKanbanGroupingPickerProps<TRow, TProperty>) => import("react").JSX.Element;
+//#endregion
+export { WorkspaceKanbanGroupingPicker };

package/dist/kanban-grouping-picker.js

@@ -0,0 +1,39 @@
+import { getWorkspaceKanbanGroupingChoices } from "./kanban-view.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Select, SelectItem, SelectPopup, SelectTrigger, SelectValue } from "@stll/ui/select";
+//#region src/kanban-grouping-picker.tsx
+const NO_GROUPING_VALUE = "";
+/**
+* Accessible picker shared by the board's Group and Sub-group controls. The
+* caller labels built-ins because only its domain owns their human names.
+*/
+const WorkspaceKanbanGroupingPicker = ({ allowNone, excludedGroupBy, getBuiltInGroupLabel, labels, onValueChange, schema, value }) => {
+	const choices = getWorkspaceKanbanGroupingChoices({
+		getBuiltInGroupLabel,
+		schema
+	}).filter(({ id }) => id !== excludedGroupBy);
+	const display = choices.find((choice) => choice.id === value)?.label ?? (allowNone ? labels.none : labels.placeholder);
+	return /* @__PURE__ */ jsxs(Select, {
+		onValueChange: (nextValue) => {
+			if (nextValue === null) return;
+			onValueChange(nextValue);
+		},
+		value,
+		children: [/* @__PURE__ */ jsx(SelectTrigger, {
+			"aria-label": labels.control,
+			size: "sm",
+			children: /* @__PURE__ */ jsx(SelectValue, {
+				placeholder: labels.placeholder,
+				children: display
+			})
+		}), /* @__PURE__ */ jsxs(SelectPopup, { children: [allowNone ? /* @__PURE__ */ jsx(SelectItem, {
+			value: NO_GROUPING_VALUE,
+			children: labels.none
+		}) : null, choices.map((choice) => /* @__PURE__ */ jsx(SelectItem, {
+			value: choice.id,
+			children: choice.label
+		}, choice.id))] })]
+	});
+};
+//#endregion
+export { WorkspaceKanbanGroupingPicker };

package/dist/kanban-view.d.ts

@@ -0,0 +1,105 @@
+import { GenericProperty } from "./types.js";
+import { KanbanBoardCell, KanbanBoardLane, KanbanBoardMatrix, KanbanBuiltInGroup, KanbanGroup, KanbanGrouping, KanbanSchema } from "@stll/ui/kanban";
+//#region src/kanban-view.d.ts
+declare const KANBAN_EMPTY_GROUP_VISIBILITIES: {
+  readonly hide: "hide";
+  readonly show: "show";
+};
+type KanbanEmptyGroupVisibility = (typeof KANBAN_EMPTY_GROUP_VISIBILITIES)[keyof typeof KANBAN_EMPTY_GROUP_VISIBILITIES];
+/** A persisted reference keeps a real option distinct from the No value lane. */
+type KanbanSavedGroupReference = {
+  type: "option";
+  value: string;
+} | {
+  type: "uncategorized";
+};
+type KanbanSavedAxisState = {
+  emptyGroups: KanbanEmptyGroupVisibility;
+  groupBy: string;
+  hiddenGroups: readonly KanbanSavedGroupReference[];
+  orderedGroups: readonly KanbanSavedGroupReference[];
+};
+type KanbanSavedSubgroupState = KanbanSavedAxisState & {
+  collapsedGroups: readonly KanbanSavedGroupReference[];
+};
+/**
+ * View state is deliberately separate from the board's domain data. It may
+ * change visibility, order, and collapse, but cannot change a card's cell.
+ */
+type KanbanSavedViewState = {
+  group: KanbanSavedAxisState;
+  subgroup: KanbanSavedSubgroupState | null;
+  version: 1;
+};
+type WorkspaceKanbanProperty = GenericProperty & {
+  id: string;
+  name: string;
+};
+type CreateWorkspaceKanbanSchemaParams<TRow, TProperty extends WorkspaceKanbanProperty> = {
+  builtInGroups: readonly KanbanBuiltInGroup<TRow>[];
+  properties: readonly TProperty[];
+};
+/**
+ * Turns the authoritative workspace property model into board declarations.
+ * Select options remain the sole source of property-derived columns and lanes.
+ */
+declare const createWorkspaceKanbanSchema: <TRow, TProperty extends WorkspaceKanbanProperty>({ builtInGroups, properties }: CreateWorkspaceKanbanSchemaParams<TRow, TProperty>) => KanbanSchema<TRow, TProperty>;
+type WorkspaceKanbanGroupingChoice = {
+  id: string;
+  label: string;
+  type: "built-in" | "property";
+};
+type WorkspaceKanbanBuiltInGroupLabel<TRow> = (group: KanbanBuiltInGroup<TRow>) => string;
+/** Property-aware data for a Group or Sub-group picker. */
+declare const getWorkspaceKanbanGroupingChoices: <TRow, TProperty extends WorkspaceKanbanProperty>({ getBuiltInGroupLabel, schema }: {
+  getBuiltInGroupLabel: WorkspaceKanbanBuiltInGroupLabel<TRow>;
+  schema: KanbanSchema<TRow, TProperty>;
+}) => WorkspaceKanbanGroupingChoice[];
+type WorkspaceKanbanGroupingPickerLabels = {
+  control: string;
+  none: string;
+  placeholder: string;
+};
+type WorkspaceKanbanGroupingPickerProps<TRow, TProperty extends WorkspaceKanbanProperty> = {
+  allowNone: boolean;
+  excludedGroupBy?: string | undefined;
+  getBuiltInGroupLabel: WorkspaceKanbanBuiltInGroupLabel<TRow>;
+  labels: WorkspaceKanbanGroupingPickerLabels;
+  onValueChange: (groupBy: string) => void;
+  schema: KanbanSchema<TRow, TProperty>;
+  value: string;
+};
+type ResolveWorkspaceKanbanViewParams<TRow, TProperty> = {
+  schema: KanbanSchema<TRow, TProperty>;
+  state: KanbanSavedViewState;
+};
+type ResolvedWorkspaceKanbanView<TRow, TProperty> = {
+  group: KanbanGrouping<TRow, TProperty>;
+  subgroup: KanbanGrouping<TRow, TProperty>;
+};
+/**
+ * A property cannot control both axes. Rejecting that configuration here means
+ * a later diagonal drag never has two contradictory assignments for one field.
+ */
+declare const resolveWorkspaceKanbanView: <TRow, TProperty>({ schema, state }: ResolveWorkspaceKanbanViewParams<TRow, TProperty>) => ResolvedWorkspaceKanbanView<TRow, TProperty>;
+type KanbanPresentedLane<TRow> = {
+  cells: KanbanBoardCell<TRow>[];
+  collapsed: boolean;
+  lane: KanbanBoardLane;
+};
+type KanbanBoardPresentation<TRow> = {
+  columns: KanbanGroup[];
+  lanes: KanbanPresentedLane<TRow>[];
+  matrix: KanbanBoardMatrix<TRow>;
+};
+/**
+ * Apply saved presentation state without rebuilding the matrix. This preserves
+ * the canonical placement invariant while letting a view hide empty groups,
+ * individually hide groups, reorder them, and collapse swimlanes.
+ */
+declare const presentKanbanBoard: <TRow>({ matrix, state }: {
+  matrix: KanbanBoardMatrix<TRow>;
+  state: KanbanSavedViewState;
+}) => KanbanBoardPresentation<TRow>;
+//#endregion
+export { CreateWorkspaceKanbanSchemaParams, KANBAN_EMPTY_GROUP_VISIBILITIES, KanbanBoardPresentation, KanbanEmptyGroupVisibility, KanbanPresentedLane, KanbanSavedAxisState, KanbanSavedGroupReference, KanbanSavedSubgroupState, KanbanSavedViewState, ResolveWorkspaceKanbanViewParams, ResolvedWorkspaceKanbanView, WorkspaceKanbanBuiltInGroupLabel, WorkspaceKanbanGroupingChoice, WorkspaceKanbanGroupingPickerLabels, WorkspaceKanbanGroupingPickerProps, WorkspaceKanbanProperty, createWorkspaceKanbanSchema, getWorkspaceKanbanGroupingChoices, presentKanbanBoard, resolveWorkspaceKanbanView };

package/dist/kanban-view.js

@@ -0,0 +1,109 @@
+import { panic } from "better-result";
+import { orderKanbanCellsByColumns, resolveKanbanGrouping } from "@stll/ui/kanban";
+//#region src/kanban-view.ts
+const KANBAN_EMPTY_GROUP_VISIBILITIES = {
+	hide: "hide",
+	show: "show"
+};
+/**
+* Turns the authoritative workspace property model into board declarations.
+* Select options remain the sole source of property-derived columns and lanes.
+*/
+const createWorkspaceKanbanSchema = ({ builtInGroups, properties }) => ({
+	builtInGroups,
+	getPropertyId: (property) => property.id,
+	getPropertyOptions: (property) => {
+		if (property.content.type !== "single-select") return null;
+		return property.content.options.map((option) => ({
+			optionColor: option.color,
+			value: option.value,
+			label: option.value
+		}));
+	},
+	properties
+});
+/** Property-aware data for a Group or Sub-group picker. */
+const getWorkspaceKanbanGroupingChoices = ({ getBuiltInGroupLabel, schema }) => {
+	const choices = [];
+	for (const group of schema.builtInGroups) choices.push({
+		id: group.id,
+		label: getBuiltInGroupLabel(group),
+		type: "built-in"
+	});
+	for (const property of schema.properties) {
+		if (schema.getPropertyOptions(property) === null) continue;
+		choices.push({
+			id: property.id,
+			label: property.name,
+			type: "property"
+		});
+	}
+	return choices;
+};
+/**
+* A property cannot control both axes. Rejecting that configuration here means
+* a later diagonal drag never has two contradictory assignments for one field.
+*/
+const resolveWorkspaceKanbanView = ({ schema, state }) => {
+	return {
+		group: resolveKanbanGrouping({
+			groupBy: state.group.groupBy,
+			schema
+		}),
+		subgroup: state.subgroup === null || state.subgroup.groupBy === state.group.groupBy ? resolveKanbanGrouping({
+			groupBy: "",
+			schema
+		}) : resolveKanbanGrouping({
+			groupBy: state.subgroup.groupBy,
+			schema
+		})
+	};
+};
+const sameGroupReference = (reference, group) => reference.type === "uncategorized" ? group.value === null : group.value === reference.value;
+const refersToGroup = (references, group) => references.some((reference) => sameGroupReference(reference, group));
+const containsGroup = (groups, group) => groups.some((candidate) => candidate.value === group.value);
+const orderGroups = (groups, orderedGroups) => {
+	const ordered = [];
+	for (const reference of orderedGroups) {
+		const group = groups.find((candidate) => sameGroupReference(reference, candidate));
+		if (group !== void 0 && !containsGroup(ordered, group)) ordered.push(group);
+	}
+	for (const group of groups) if (!refersToGroup(orderedGroups, group)) ordered.push(group);
+	return ordered;
+};
+const isGroupEmpty = (group, matrix) => matrix.cells.every((cell) => cell.coordinate.column.value !== group.value || cell.rows.length === 0);
+const isLaneEmpty = (lane, matrix) => matrix.cells.every((cell) => cell.coordinate.lane.type !== lane.type || lane.type === "group" && cell.coordinate.lane.type === "group" && cell.coordinate.lane.group.value !== lane.group.value || cell.rows.length === 0);
+/**
+* Apply saved presentation state without rebuilding the matrix. This preserves
+* the canonical placement invariant while letting a view hide empty groups,
+* individually hide groups, reorder them, and collapse swimlanes.
+*/
+const presentKanbanBoard = ({ matrix, state }) => {
+	const columns = orderGroups(matrix.columns, state.group.orderedGroups).filter((group) => !refersToGroup(state.group.hiddenGroups, group) && (state.group.emptyGroups === "show" || !isGroupEmpty(group, matrix)));
+	const subgroupState = state.subgroup;
+	return {
+		columns,
+		lanes: (subgroupState === null || matrix.lanes.some((lane) => lane.type === "none") ? matrix.lanes : orderGroups(matrix.lanes.filter((lane) => lane.type === "group").map((lane) => lane.group), subgroupState.orderedGroups).map((group) => ({
+			group,
+			type: "group"
+		}))).filter((lane) => {
+			if (lane.type === "none" || subgroupState === null) return true;
+			return !refersToGroup(subgroupState.hiddenGroups, lane.group) && (subgroupState.emptyGroups === "show" || !isLaneEmpty(lane, matrix));
+		}).map((lane) => {
+			const collapsed = lane.type === "group" && subgroupState !== null && refersToGroup(subgroupState.collapsedGroups, lane.group);
+			const cells = orderKanbanCellsByColumns({
+				cells: matrix.cells.filter((cell) => lane.type === "none" ? cell.coordinate.lane.type === "none" : cell.coordinate.lane.type === "group" && cell.coordinate.lane.group.value === lane.group.value),
+				columns
+			});
+			if (cells.length !== columns.length) return panic("Kanban presentation lane is missing a declared cell");
+			return {
+				cells,
+				collapsed,
+				lane
+			};
+		}),
+		matrix
+	};
+};
+//#endregion
+export { KANBAN_EMPTY_GROUP_VISIBILITIES, createWorkspaceKanbanSchema, getWorkspaceKanbanGroupingChoices, presentKanbanBoard, resolveWorkspaceKanbanView };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/workspace-ui",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Reusable workspace presentation components and view helpers for Stella.",
   "keywords": [
     "calculations",
@@ -59,6 +59,14 @@
       "types": "./dist/field-value-logic.d.ts",
       "import": "./dist/field-value-logic.js"
     },
+    "./kanban-grouping-picker": {
+      "types": "./dist/kanban-grouping-picker.d.ts",
+      "import": "./dist/kanban-grouping-picker.js"
+    },
+    "./kanban-view": {
+      "types": "./dist/kanban-view.d.ts",
+      "import": "./dist/kanban-view.js"
+    },
     "./property-icon": {
       "types": "./dist/property-icon.d.ts",
       "import": "./dist/property-icon.js"
@@ -103,7 +111,7 @@
     "@stll/calculations": "^0.1.0",
     "@stll/conditions": "^0.2.0",
     "@stll/money": "^0.1.0",
-    "@stll/ui": "^0.7.0",
+    "@stll/ui": "^0.9.0",
     "better-result": "3.0.0",
     "lucide-react": "1.30.0",
     "use-intl": "4.13.5"