update parser organization and names (verb + subject; parse_blocks li…

…ke cluster_sources)

smart-blocks/adapters/markdown_block.js

@@ -4,7 +4,6 @@
  */
 
 import { BlockContentAdapter } from "./_adapter.js";
-import { markdown_to_blocks } from "../../smart-sources/blocks/markdown_to_blocks.js";
 
 /**
  * @class MarkdownBlockContentAdapter

smart-sources/blocks/markdown_crud.js → smart-blocks/adapters/♻️/markdown_crud.js

@@ -1,4 +1,4 @@
-import { markdown_to_blocks } from "./markdown_to_blocks.js";
+import { parse_blocks } from "./markdown.js";
 
 /**
  * Reads the content of a specific block from the full markdown content.
@@ -9,7 +9,7 @@ import { markdown_to_blocks } from "./markdown_to_blocks.js";
  * @throws {Error} - If the block_key does not exist.
  */
 export function block_read(content, block_key) {
-  const blocks = markdown_to_blocks(content);
+  const blocks = parse_blocks(content);
   const block_range = blocks[block_key];
 
   if (!block_range) {
@@ -32,7 +32,7 @@ export function block_read(content, block_key) {
  * @throws {Error} - If the block_key does not exist.
  */
 export function block_update(content, block_key, new_block_content) {
-  const blocks = markdown_to_blocks(content);
+  const blocks = parse_blocks(content);
   const block_range = blocks[block_key];
 
   if (!block_range) {
@@ -60,7 +60,7 @@ export function block_update(content, block_key, new_block_content) {
  * @throws {Error} - If the block_key does not exist.
  */
 export function block_destroy(content, block_key) {
-  const blocks = markdown_to_blocks(content);
+  const blocks = parse_blocks(content);
   const block_range = blocks[block_key];
 
   if (!block_range) {

smart-sources/blocks/markdown_to_blocks.js → smart-blocks/parsers/markdown.js

@@ -1,4 +1,4 @@
-export function markdown_to_blocks(markdown) {
+export function parse_blocks(markdown) {
   const lines = markdown.split('\n');
   const result = {};
   const heading_stack = [];

smart-sources/blocks/markdown_to_blocks.test.js → smart-blocks/parsers/markdown.test.js

@@ -1,5 +1,5 @@
 import test from 'ava';
-import { markdown_to_blocks } from "./markdown_to_blocks.js";
+import { parse_blocks } from "./markdown.js";
 
 test('convert markdown with complex heading structures to flat JS object', t => {
   const markdown = `# Top-Level Heading
@@ -87,7 +87,7 @@ In this case, \`#Another Top-Level Heading[2]\`. No \`#\` separates the heading
     "#Another Top-Level Heading[2]#{1}": [53, 55]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -111,7 +111,7 @@ Thank you for reading.`;
     "#Conclusion#{1}": [8, 8]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -151,7 +151,7 @@ test('convert markdown with deeply nested headings to flat JS object', t => {
     "#Chapter 3": [19, 20]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -185,7 +185,7 @@ Overview detailed information.
     "#Overview[3]#Details#{1}": [14, 15]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -232,7 +232,7 @@ Final thoughts.`;
     "#Conclusion#{1}": [24, 24]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -258,7 +258,7 @@ Content under second occurrence of top-level heading.
     "#Heading[2]#{1}": [10, 11]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -275,7 +275,7 @@ Content under heading one
     "#Heading One#{1}": [4, 5]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -298,7 +298,7 @@ Content under heading one
     "#Heading One#{1}": [10, 11]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -318,7 +318,7 @@ Content under heading one
     "#Heading One#{1}": [5, 6]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -341,7 +341,7 @@ Some text
     "#Another Heading#{1}": [9, 10]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -355,7 +355,7 @@ Content under heading.
     "#\"Heading\"#{1}": [2, 3]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -370,7 +370,7 @@ Content under heading.
     "#": [1, 5]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -410,7 +410,7 @@ test('should handle nested list items with line break between items', t => {
     "#Heading####New Environment#{2}": [19, 25]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -448,7 +448,7 @@ Dolor Sit Amet
     "###Lorem Ipsum#{8}": [17, 20]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });
 
@@ -474,6 +474,6 @@ Content under second occurrence of top-level heading.
     "#####Heading[2]#{1}": [10, 11]
   };
 
-  const result = markdown_to_blocks(markdown);
+  const result = parse_blocks(markdown);
   t.deepEqual(result, expected);
 });

smart-blocks/smart_blocks.js

@@ -1,7 +1,7 @@
 import { SmartEntities } from "smart-entities";
 import { get_markdown_links } from "smart-sources/utils/get_markdown_links.js";
 import { get_line_range } from "smart-sources/utils/get_line_range.js";
-import { markdown_to_blocks } from "smart-sources/blocks/markdown_to_blocks.js";
+import { parse_blocks } from "smart-blocks/parsers/markdown.js";
 
 /**
  * @class SmartBlocks
@@ -18,14 +18,14 @@ export class SmartBlocks extends SmartEntities {
   /**
    * @method import_source
    * @description Imports blocks for a given source by parsing the content. Delegates parsing to a parser
-   * depending on the source.file_type (e.g., markdown_to_blocks for .md).
+   * depending on the source.file_type (e.g., parse_blocks for .md).
    * @async
    * @param {SmartSource} source The source whose blocks are to be imported.
    * @param {string} content The raw content of the source file.
    * @returns {Promise<void>}
    */
   async import_source(source, content) {
-    let blocks_obj = markdown_to_blocks(content);
+    let blocks_obj = parse_blocks(content);
 
     const blocks = [];
     for (const [sub_key, line_range] of Object.entries(blocks_obj)) {

smart-sources/adapters/_file.js

@@ -1,4 +1,5 @@
 import { SourceContentAdapter } from "./_adapter.js";
+import { parse_blocks } from "smart-blocks/parsers/markdown.js";
 /**
  * @class FileSourceContentAdapter
  * @extends SourceContentAdapter
@@ -136,11 +137,11 @@ export class FileSourceContentAdapter extends SourceContentAdapter {
    */
   async merge(content, opts = {}) {
     const { mode = 'append_blocks' } = opts;
-    const blocks_obj = markdown_to_blocks(content);
+    const blocks_obj = parse_blocks(content);
 
     if (typeof blocks_obj !== 'object' || Array.isArray(blocks_obj)) {
-      console.warn("merge error: Expected an object from markdown_to_blocks, but received:", blocks_obj);
-      throw new Error("merge error: markdown_to_blocks did not return an object as expected.");
+      console.warn("merge error: Expected an object from parse_blocks, but received:", blocks_obj);
+      throw new Error("merge error: parse_blocks did not return an object as expected.");
     }
     const { new_blocks, new_with_parent_blocks, changed_blocks, same_blocks } = await this.get_changes(blocks_obj, content);
     for(const block of new_blocks){

smart-sources/adapters/markdown_source.js

@@ -1,5 +1,4 @@
 import { FileSourceContentAdapter } from "./_file.js";
-import { markdown_to_blocks } from "../blocks/markdown_to_blocks.js";
 import { get_markdown_links } from "../utils/get_markdown_links.js";
 
 /**

smart-sources/test/test_content.js

@@ -118,7 +118,7 @@ Content at the deepest heading level.
 // Integration test notes:
 // - Verify that up to six levels of headings are correctly identified as blocks.
 // - Check how block removal or updates propagate when dealing with deeply nested headings.
-// - Test that markdown_to_blocks does not break with extreme heading nesting.
+// - Test that parse_blocks does not break with extreme heading nesting.
 // - Validate that rewriting minimal files after import preserves heading structure.
 
 ///////////////////////////////////////////////