enhance(cm): add sort-child-cards action

Author: ycnmhd

src/lang/lang.ts

@@ -286,6 +286,14 @@ export const lang = {
     modals_rules_rule_cm_move_to_document: 'Move to document rules',
     modals_rules_rule_cm_move_to_global: 'Move to global rules',
 
+    // sort
+    cmd_sort_child_cards_asc: 'Sort child cards: ascending order',
+    cmd_sort_child_cards_desc: 'Sort child cards: descending order',
+    cm_sort_child: 'Sort child cards',
+    cm_sort_child_cards_asc: 'Ascending order',
+    cm_sort_child_cards_desc: 'Descending order',
+    modals_snapshots_sorted_child_cards: 'Sorted child cards of card ',
+
     // settings
     controls_settings: 'Settings',
     controls_toggle_bar: 'Toggle controls bar',

src/lang/snapshot-action-lang.ts

@@ -9,12 +9,15 @@ import {
     Heading1,
     Merge,
     Scissors,
+    SortAsc,
+    SortDesc,
     Split,
 } from 'lucide-svelte';
 import { UndoableAction } from 'src/stores/document/document-store-actions';
 import { Snapshot } from 'src/stores/document/document-state-type';
 import { customIcons } from 'src/helpers/load-custom-icons';
 import { lang } from './lang';
+import { SortChildNodesAction } from 'src/stores/document/reducers/sort/sort-direct-child-nodes';
 
 type Key = UndoableAction['type'];
 
@@ -90,4 +93,13 @@ export const snapshotActionLang: Partial<
             lang.modals_snapshots_split_card + snapshot.context.affectedSection,
         icon: Split,
     }),
+    'document/sort-direct-child-nodes': (snapshot) => {
+        const action = snapshot.context.action as SortChildNodesAction;
+        return {
+            label:
+                lang.modals_snapshots_sorted_child_cards +
+                snapshot.context.affectedSection,
+            icon: action.payload.order === 'descending' ? SortDesc : SortAsc,
+        };
+    },
 };

src/obsidian/commands/add-commands.ts

@@ -14,6 +14,8 @@ import { extractBranch } from 'src/obsidian/commands/helpers/extract-branch/extr
 import { exportColumn } from 'src/view/actions/context-menu/card-context-menu/helpers/export-column';
 import { exportDocument } from 'src/obsidian/commands/helpers/export-document/export-document';
 import { onPluginError } from 'src/lib/store/on-plugin-error';
+import invariant from 'tiny-invariant';
+import { sortChildNodes } from 'src/view/actions/context-menu/card-context-menu/helpers/sort-child-nodes';
 
 const createCommands = (plugin: Lineage) => {
     const commands: (Omit<Command, 'id' | 'callback'> & {
@@ -80,6 +82,40 @@ const createCommands = (plugin: Lineage) => {
         },
     });
 
+    commands.push({
+        name: lang.cmd_sort_child_cards_asc,
+        icon: 'sort-asc',
+        checkCallback: (checking) => {
+            const view = getActiveLineageView(plugin);
+            if (checking) {
+                return Boolean(view);
+            }
+            invariant(view);
+            sortChildNodes(
+                view,
+                view.viewStore.getValue().document.activeNode,
+                'ascending',
+            );
+        },
+    });
+
+    commands.push({
+        name: lang.cmd_sort_child_cards_desc,
+        icon: 'sort-desc',
+        checkCallback: (checking) => {
+            const view = getActiveLineageView(plugin);
+            if (checking) {
+                return Boolean(view);
+            }
+            invariant(view);
+            sortChildNodes(
+                view,
+                view.viewStore.getValue().document.activeNode,
+                'descending',
+            );
+        },
+    });
+
     commands.push({
         name: lang.cm_copy_link_to_block,
         icon: 'links-coming-in',

src/stores/document/document-reducer.ts

@@ -35,6 +35,7 @@ import { loadPinnedNodes } from 'src/stores/document/reducers/pinned-nodes/load-
 import { refreshGroupParentIds } from 'src/stores/document/reducers/meta/refresh-group-parent-ids';
 import { loadDocumentFromJSON } from 'src/stores/document/reducers/load-document-from-file/load-document-from-json';
 import { NO_UPDATE } from 'src/lib/store/store';
+import { sortDirectChildNodes } from 'src/stores/document/reducers/sort/sort-direct-child-nodes';
 
 const updateDocumentState = (
     state: DocumentState,
@@ -91,6 +92,10 @@ const updateDocumentState = (
             state.document.content[action.payload.activeNodeId];
         newActiveNodeId = mergeNode(state.document, action);
         affectedNodeId = action.payload.activeNodeId;
+    } else if (action.type === 'document/sort-direct-child-nodes') {
+        sortDirectChildNodes(state.document, action.payload);
+        newActiveNodeId = action.payload.id;
+        affectedNodeId = newActiveNodeId;
     } else if (action.type === 'DOCUMENT/LOAD_FILE') {
         if (action.payload.__test_document__) {
             newActiveNodeId = loadDocumentFromJSON(

src/stores/document/document-store-actions.ts

@@ -17,6 +17,7 @@ import { UnpinNodeAction } from 'src/stores/document/reducers/pinned-nodes/unpin
 import { RemoveStalePinnedNodesAction } from 'src/stores/document/reducers/pinned-nodes/remove-stale-pinned-nodes';
 import { LoadPinnedNodesAction } from 'src/stores/document/reducers/pinned-nodes/load-pinned-nodes';
 import { RefreshGroupParentIdsAction } from 'src/stores/document/reducers/meta/refresh-group-parent-ids';
+import { SortChildNodesAction } from 'src/stores/document/reducers/sort/sort-direct-child-nodes';
 
 export type VerticalDirection = 'up' | 'down';
 export type Direction = VerticalDirection | 'right';
@@ -57,7 +58,8 @@ export type DocumentAction =
           };
       }
     | PinnedNodesActions
-    | MetaActions;
+    | MetaActions
+    | SortChildNodesAction;
 
 export type HistoryAction = UndoRedoAction | SelectSnapshotAction;
 export type UndoableAction =
@@ -72,7 +74,8 @@ export type UndoableAction =
     | PasteNodeAction
     | CutNodeAction
     | ExtractNodeAction
-    | SplitNodeAction;
+    | SplitNodeAction
+    | SortChildNodesAction;
 
 export type CopyNodeAction = {
     type: 'DOCUMENT/COPY_NODE';