cursedbelt-core 2.4.0 → 2.5.0

package/dist/core/file-tree/fileTreeModel.d.ts

@@ -35,6 +35,21 @@ export interface FileTreeNode {
     /** Stable across re-derivation — it is the React key, the selection value and the drag id. */
     id: string;
     name: string;
+    /**
+     * Drawn right after the name, a step quieter — a file's extension, `.md`.
+     *
+     * For a consumer whose extension is DERIVED rather than part of the stored name
+     * (`apps/desk` works a note's suffix out from its format): *"show the extensions in the
+     * file tree like vscode does. I need to be able to tell what type each file is"*. Quieter
+     * because the name is what you scan FOR and the suffix is what you scan BY.
+     *
+     * 🔴 It is part of the name everywhere a person types one: {@link matchTypeahead} and
+     * {@link filterFileTree} match `name + suffix`, because what is drawn and what can be
+     * typed are the same string or they are a bug (*"I typed .json but it said 'Nothing is
+     * called that'"*). A rename opens on `name + suffix` with only the name selected — VS
+     * Code's field — and hands back whatever was typed, suffix and all.
+     */
+    suffix?: string;
     kind: FileTreeNodeKind;
     /** Folders only. A folder with `[]` is empty; a file's is ignored. */
     children?: readonly FileTreeNode[];
@@ -300,6 +315,8 @@ export declare function accessMarkCopy(access: FileTreeAccess | undefined, copy?
  * Typeahead is what makes a long tree usable without a search box — `bud` jumps to
  * `budget-2026` — and wrapping is what stops it dying at the bottom of the list.
  */
+/** The name as the row draws it — with its {@link FileTreeNode.suffix}. */
+export declare function drawnName(node: FileTreeNode): string;
 export declare function matchTypeahead(rows: readonly FileTreeRow[], query: string, fromIndex: number): number;
 /**
  * The tree narrowed to what matches, with the folders on the way to a match kept.

package/dist/core/file-tree/fileTreeModel.js

@@ -308,6 +308,10 @@ export function accessMarkCopy(access, copy) {
  * Typeahead is what makes a long tree usable without a search box — `bud` jumps to
  * `budget-2026` — and wrapping is what stops it dying at the bottom of the list.
  */
+/** The name as the row draws it — with its {@link FileTreeNode.suffix}. */
+export function drawnName(node) {
+    return node.suffix ? `${node.name}${node.suffix}` : node.name;
+}
 export function matchTypeahead(rows, query, fromIndex) {
     if (!query)
         return -1;
@@ -315,7 +319,7 @@ export function matchTypeahead(rows, query, fromIndex) {
     for (let step = 1; step <= rows.length; step += 1) {
         const index = (fromIndex + step + rows.length) % rows.length;
         const row = rows[index];
-        if (row?.node.name.toLowerCase().startsWith(needle))
+        if (row && drawnName(row.node).toLowerCase().startsWith(needle))
             return index;
     }
     return -1;
@@ -332,7 +336,7 @@ export function filterFileTree(nodes, query) {
     if (!needle)
         return nodes;
     const keep = (node) => {
-        const hit = node.name.toLowerCase().includes(needle);
+        const hit = drawnName(node).toLowerCase().includes(needle);
         if (hit)
             return node;
         const kids = childrenOf(node)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt-core",
-	"version": "2.4.0",
+	"version": "2.5.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "Framework-agnostic core of the cursedbelt split — isomorphic domain logic. cwip below it, cursedbelt-server and cursedbelt (react) above it.",

package/src/core/file-tree/fileTreeModel.spec.ts

@@ -13,6 +13,7 @@ import {
   resolveDrop,
   resolveKeyboardMove,
   describeDrop,
+  drawnName,
 } from './fileTreeModel.js';
 
 /**
@@ -526,3 +527,25 @@ describe('accessMarkCopy', () => {
     expect(accessMarkCopy(undefined)).toBe('');
   });
 });
+
+/** `suffix` — a derived extension, drawn and matched as part of the name. */
+describe('a suffix is part of the name a person types', () => {
+  const notes: FileTreeNode = { id: 'n', name: 'notes', suffix: '.md', kind: 'file' };
+  const nodes: FileTreeNode[] = [folder('docs', 'Docs', [notes]), { id: 'b', name: 'budget', kind: 'file' }];
+
+  test('drawnName carries it, and a node without one is its name', () => {
+    expect(drawnName(notes)).toBe('notes.md');
+    expect(drawnName({ id: 'b', name: 'budget', kind: 'file' })).toBe('budget');
+  });
+
+  test('typeahead matches through the dot', () => {
+    const rows = flattenFileTree(nodes, []);
+    expect(matchTypeahead(rows, 'notes.m', 0)).toBe(rows.findIndex((row) => row.node.id === 'n'));
+  });
+
+  test('a filter for the extension finds the file', () => {
+    const kept = filterFileTree(nodes, '.md');
+    expect(kept.map((node) => node.id)).toEqual(['docs']);
+    expect((kept[0]?.children ?? []).map((node) => node.id)).toEqual(['n']);
+  });
+});

package/src/core/file-tree/fileTreeModel.ts

@@ -38,6 +38,21 @@ export interface FileTreeNode {
   /** Stable across re-derivation — it is the React key, the selection value and the drag id. */
   id: string;
   name: string;
+  /**
+   * Drawn right after the name, a step quieter — a file's extension, `.md`.
+   *
+   * For a consumer whose extension is DERIVED rather than part of the stored name
+   * (`apps/desk` works a note's suffix out from its format): *"show the extensions in the
+   * file tree like vscode does. I need to be able to tell what type each file is"*. Quieter
+   * because the name is what you scan FOR and the suffix is what you scan BY.
+   *
+   * 🔴 It is part of the name everywhere a person types one: {@link matchTypeahead} and
+   * {@link filterFileTree} match `name + suffix`, because what is drawn and what can be
+   * typed are the same string or they are a bug (*"I typed .json but it said 'Nothing is
+   * called that'"*). A rename opens on `name + suffix` with only the name selected — VS
+   * Code's field — and hands back whatever was typed, suffix and all.
+   */
+  suffix?: string;
   kind: FileTreeNodeKind;
   /** Folders only. A folder with `[]` is empty; a file's is ignored. */
   children?: readonly FileTreeNode[];
@@ -530,6 +545,11 @@ export function accessMarkCopy(
  * Typeahead is what makes a long tree usable without a search box — `bud` jumps to
  * `budget-2026` — and wrapping is what stops it dying at the bottom of the list.
  */
+/** The name as the row draws it — with its {@link FileTreeNode.suffix}. */
+export function drawnName(node: FileTreeNode): string {
+  return node.suffix ? `${node.name}${node.suffix}` : node.name;
+}
+
 export function matchTypeahead(
   rows: readonly FileTreeRow[],
   query: string,
@@ -540,7 +560,7 @@ export function matchTypeahead(
   for (let step = 1; step <= rows.length; step += 1) {
     const index = (fromIndex + step + rows.length) % rows.length;
     const row = rows[index];
-    if (row?.node.name.toLowerCase().startsWith(needle)) return index;
+    if (row && drawnName(row.node).toLowerCase().startsWith(needle)) return index;
   }
   return -1;
 }
@@ -559,7 +579,7 @@ export function filterFileTree(
   const needle = query.trim().toLowerCase();
   if (!needle) return nodes;
   const keep = (node: FileTreeNode): FileTreeNode | null => {
-    const hit = node.name.toLowerCase().includes(needle);
+    const hit = drawnName(node).toLowerCase().includes(needle);
     if (hit) return node;
     const kids = childrenOf(node)
       .map(keep)