@stll/workspace-ui 0.4.0 → 0.4.1

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

@@ -4,6 +4,6 @@ import { WorkspaceKanbanGroupingPickerProps, WorkspaceKanbanProperty } from "./k
  * 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;
+declare const WorkspaceKanbanGroupingPicker: <TRow, TProperty extends WorkspaceKanbanProperty<TGroupId>, TGroupId extends string = string>({ allowNone, excludedGroupBy, getBuiltInGroupLabel, labels, onValueChange, schema, value }: WorkspaceKanbanGroupingPickerProps<TRow, TProperty, TGroupId>) => import("react").JSX.Element;
 //#endregion
 export { WorkspaceKanbanGroupingPicker };

package/dist/kanban-grouping-picker.js

@@ -3,6 +3,7 @@ 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 = "";
+const toSelectTransportValue = (value) => 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.
@@ -13,12 +14,18 @@ const WorkspaceKanbanGroupingPicker = ({ allowNone, excludedGroupBy, getBuiltInG
 		schema
 	}).filter(({ id }) => id !== excludedGroupBy);
 	const display = choices.find((choice) => choice.id === value)?.label ?? (allowNone ? labels.none : labels.placeholder);
+	const selectedValue = toSelectTransportValue(value);
 	return /* @__PURE__ */ jsxs(Select, {
 		onValueChange: (nextValue) => {
 			if (nextValue === null) return;
-			onValueChange(nextValue);
+			if (nextValue === NO_GROUPING_VALUE) {
+				onValueChange(NO_GROUPING_VALUE);
+				return;
+			}
+			const nextChoice = choices.find(({ id }) => id === nextValue);
+			if (nextChoice !== void 0) onValueChange(nextChoice.id);
 		},
-		value,
+		value: selectedValue,
 		children: [/* @__PURE__ */ jsx(SelectTrigger, {
 			"aria-label": labels.control,
 			size: "sm",
@@ -30,7 +37,7 @@ const WorkspaceKanbanGroupingPicker = ({ allowNone, excludedGroupBy, getBuiltInG
 			value: NO_GROUPING_VALUE,
 			children: labels.none
 		}) : null, choices.map((choice) => /* @__PURE__ */ jsx(SelectItem, {
-			value: choice.id,
+			value: toSelectTransportValue(choice.id),
 			children: choice.label
 		}, choice.id))] })]
 	});

package/dist/kanban-view.d.ts

@@ -13,75 +13,76 @@ type KanbanSavedGroupReference = {
 } | {
   type: "uncategorized";
 };
-type KanbanSavedAxisState = {
+type KanbanSavedAxisState<TGroupId extends string = string> = {
   emptyGroups: KanbanEmptyGroupVisibility;
-  groupBy: string;
+  groupBy: TGroupId;
   hiddenGroups: readonly KanbanSavedGroupReference[];
   orderedGroups: readonly KanbanSavedGroupReference[];
 };
-type KanbanSavedSubgroupState = KanbanSavedAxisState & {
+type KanbanSavedSubgroupState<TGroupId extends string = string> = KanbanSavedAxisState<TGroupId> & {
   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;
+type KanbanSavedViewState<TGroupId extends string = string> = {
+  group: KanbanSavedAxisState<TGroupId>;
+  subgroup: KanbanSavedSubgroupState<TGroupId> | null;
   version: 1;
 };
-type WorkspaceKanbanProperty = GenericProperty & {
-  id: string;
+type WorkspaceKanbanProperty<TGroupId extends string = string> = GenericProperty & {
+  id: TGroupId;
   name: string;
 };
-type CreateWorkspaceKanbanSchemaParams<TRow, TProperty extends WorkspaceKanbanProperty> = {
-  builtInGroups: readonly KanbanBuiltInGroup<TRow>[];
+type CreateWorkspaceKanbanSchemaParams<TRow, TBuiltInGroupId extends string, TProperty extends WorkspaceKanbanProperty> = {
+  builtInGroups: readonly KanbanBuiltInGroup<TRow, TBuiltInGroupId>[];
   properties: readonly TProperty[];
 };
+type WorkspaceKanbanSchemaGroupId<TBuiltInGroupId extends string, TProperty extends WorkspaceKanbanProperty> = TBuiltInGroupId | TProperty["id"];
 /**
  * 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;
+declare const createWorkspaceKanbanSchema: <TRow, TBuiltInGroupId extends string, TProperty extends WorkspaceKanbanProperty>({ builtInGroups, properties }: CreateWorkspaceKanbanSchemaParams<TRow, TBuiltInGroupId, TProperty>) => KanbanSchema<TRow, TProperty, WorkspaceKanbanSchemaGroupId<TBuiltInGroupId, TProperty>>;
+type WorkspaceKanbanGroupingChoice<TGroupId extends string = string> = {
+  id: TGroupId;
   label: string;
   type: "built-in" | "property";
 };
-type WorkspaceKanbanBuiltInGroupLabel<TRow> = (group: KanbanBuiltInGroup<TRow>) => string;
+type WorkspaceKanbanBuiltInGroupLabel<TRow, TGroupId extends string = string> = (group: KanbanBuiltInGroup<TRow, TGroupId>) => 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[];
+declare const getWorkspaceKanbanGroupingChoices: <TRow, TProperty extends WorkspaceKanbanProperty<TGroupId>, TGroupId extends string = string>({ getBuiltInGroupLabel, schema }: {
+  getBuiltInGroupLabel: WorkspaceKanbanBuiltInGroupLabel<TRow, TGroupId>;
+  schema: KanbanSchema<TRow, TProperty, TGroupId>;
+}) => WorkspaceKanbanGroupingChoice<TGroupId>[];
 type WorkspaceKanbanGroupingPickerLabels = {
   control: string;
   none: string;
   placeholder: string;
 };
-type WorkspaceKanbanGroupingPickerProps<TRow, TProperty extends WorkspaceKanbanProperty> = {
+type WorkspaceKanbanGroupingPickerProps<TRow, TProperty extends WorkspaceKanbanProperty<TGroupId>, TGroupId extends string = string> = {
   allowNone: boolean;
-  excludedGroupBy?: string | undefined;
-  getBuiltInGroupLabel: WorkspaceKanbanBuiltInGroupLabel<TRow>;
+  excludedGroupBy?: TGroupId | undefined;
+  getBuiltInGroupLabel: WorkspaceKanbanBuiltInGroupLabel<TRow, TGroupId>;
   labels: WorkspaceKanbanGroupingPickerLabels;
-  onValueChange: (groupBy: string) => void;
-  schema: KanbanSchema<TRow, TProperty>;
-  value: string;
+  onValueChange: (groupBy: TGroupId | "") => void;
+  schema: KanbanSchema<TRow, TProperty, TGroupId>;
+  value: TGroupId | "";
 };
-type ResolveWorkspaceKanbanViewParams<TRow, TProperty> = {
-  schema: KanbanSchema<TRow, TProperty>;
-  state: KanbanSavedViewState;
+type ResolveWorkspaceKanbanViewParams<TRow, TProperty, TGroupId extends string = string> = {
+  schema: KanbanSchema<TRow, TProperty, TGroupId>;
+  state: KanbanSavedViewState<TGroupId>;
 };
-type ResolvedWorkspaceKanbanView<TRow, TProperty> = {
-  group: KanbanGrouping<TRow, TProperty>;
-  subgroup: KanbanGrouping<TRow, TProperty>;
+type ResolvedWorkspaceKanbanView<TRow, TProperty, TGroupId extends string = string> = {
+  group: KanbanGrouping<TRow, TProperty, TGroupId>;
+  subgroup: KanbanGrouping<TRow, TProperty, TGroupId>;
 };
 /**
  * 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>;
+declare const resolveWorkspaceKanbanView: <TRow, TProperty, TGroupId extends string = string>({ schema, state }: ResolveWorkspaceKanbanViewParams<TRow, TProperty, TGroupId>) => ResolvedWorkspaceKanbanView<TRow, TProperty, TGroupId>;
 type KanbanPresentedLane<TRow> = {
   cells: KanbanBoardCell<TRow>[];
   collapsed: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/workspace-ui",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Reusable workspace presentation components and view helpers for Stella.",
   "keywords": [
     "calculations",
@@ -111,7 +111,7 @@
     "@stll/calculations": "^0.1.0",
     "@stll/conditions": "^0.2.0",
     "@stll/money": "^0.1.0",
-    "@stll/ui": "^0.9.0",
+    "@stll/ui": "^0.9.1",
     "better-result": "3.0.0",
     "lucide-react": "1.30.0",
     "use-intl": "4.13.5"