rough in lots of block data

export_documentation.js

@@ -21,7 +21,7 @@ const withCleanDir = async (dirName, writeFunction) => {
 
     // ensure dir is present before writing
     if(!fs.existsSync(exportDirname)) {
-      fs.mkdirSync(exportDirname, { recursive: true })  
+      fs.mkdirSync(exportDirname, { recursive: true })
     }
 
     // write the file
@@ -43,7 +43,7 @@ import { importBlockJson, importBlockDefinitions, allBlockDefinitionsAndPaths }
 import importToolboxJson from './src/importer/toolbox_importer.js'
 import importWorkspaceJson from './src/importer/workspace_importer.js'
 import importBlocklyJs from './src/importer/blockly_importer.js'
-import { capitalize, filter, find, forEach, get, keyBy, map, mapValues, sortBy } from 'lodash-es'
+import { capitalize, filter, find, forEach, get, isArray, isObject, keyBy, map, mapValues, sortBy } from 'lodash-es'
 
 const
   toolbox = await importToolboxJson(),
@@ -53,14 +53,56 @@ const
 const pretty = jsObject => JSON.stringify(jsObject, null, 2) + "\n"
 
 const toBlockMarkdown = definition => {
+  const
+    lineObjects = filter(map(filter(definition.lines, isArray), "[1]"), isObject),
+    fields = filter(lineObjects, "field"),
+    inputValues = filter(lineObjects, "inputValue"),
+    inputStatements = filter(lineObjects, "inputStatement")
+
   return `---
 title: "Block: ${definition.name}"
 editLink: true
 ---
 
-# Block: ${definition.name}
+# Block ${definition.name}
 
+## Categories 🔜
+
+## Description
     ${ definition.visualization?.tooltip?.replaceAll("\n", "\n    ") || "No docs for this block, yet." }
+
+## Workspace 🔜
+
+## Fields
+
+${ fields.map(field =>
+`### \`${ capitalize(field.field) }\`
+
+- Text: ${ field.text || 'None' }
+- Select:
+  - ${ map(field.options||[], 0).join("\n  - ") }`
+).join("\n\n") }
+
+## Inputs
+
+${ inputValues.map(inputValue =>
+`### \`${ capitalize(inputValue.inputValue) }\`
+
+- Check: ${inputValue.check || 'None' }
+- Shadow: ${inputValue.shadow?.type || inputValue.shadow}`
+).join("\n\n") }
+
+${ inputStatements.map(inputStatement =>
+`### \`${ capitalize(inputStatement.inputStatement) }\`
+
+- Check: ${inputStatement.check || 'None' }`
+).join("\n\n") }
+
+## Output
+
+${ capitalize(definition.connections?.output || "Unspecified") }
+
+## Examples 🔜
 `
 }
 
@@ -100,7 +142,6 @@ withCleanDir("docs/blocks", async write => {
     forEach(categoryBlocksMap, (categoryBlocks, categoryName) => {
       // if category contains this block, add to its sidebar
       if(categoryBlocks.includes(definition.type)) {
-        console.log('found:', definition.type, 'in', categoryName)
         find(blockSidebar.items, { text: categoryName }).items.push(sidebarEntry)
       }
     })