@anydigital/11ty-bricks 1.0.0-alpha.2 → 1.0.0-alpha.4

package/README.md

@@ -83,7 +83,7 @@ eleventyConfig.addPlugin(eleventyBricks, {
 });
 ```
 
-## Available Helpers
+## Available 11ty Helpers
 
 ### autoRaw
 
@@ -102,6 +102,100 @@ Use {{ variable }} to output variables.
 
 Would try to process `{{ variable }}` as a template variable. With `autoRaw`, it displays exactly as written.
 
+## Available Bricks (Components)
+
+### Navigation Macro (`_nav.njk`)
+
+A reusable Nunjucks macro for rendering navigation menus with proper accessibility attributes. This macro works seamlessly with the [11ty Navigation Plugin](https://www.11ty.dev/docs/plugins/navigation/).
+
+**Usage:**
+
+1. Import the macro in your template:
+
+```njk
+{% from "bricks/_nav.njk" import render as renderNav %}
+```
+
+2. Call the macro with your navigation data:
+
+```njk
+{{ renderNav(collections.all | eleventyNavigation, page) }}
+```
+
+**Parameters:**
+
+- `navPages`: Array of navigation entries (typically from `eleventyNavigation` filter)
+- `curPage`: Current page object (use Eleventy's `page` variable)
+
+**Features:**
+
+- Renders a semantic `<nav>` element
+- Automatically adds `aria-current="page"` to the current page link for accessibility
+- Clean, minimal markup ready for styling
+- Works with nested navigation structures from the 11ty Navigation Plugin
+
+**Example Output:**
+
+```html
+<nav>
+  <a href="/">Home</a>
+  <a href="/about/">About</a>
+  <a href="/contact/" aria-current="page">Contact</a>
+</nav>
+```
+
+## CLI Helper Commands
+
+After installing this package, the `download-files` command becomes available:
+
+### download-files
+
+A CLI command that downloads external files to your project based on URLs specified in your `package.json`.
+
+**Usage:**
+
+1. Add a `_downloadFiles` field to your project's `package.json` with URL-to-path mappings:
+
+```json
+{
+  "_downloadFiles": {
+    "https://example.com/library.js": "src/vendor/library.js",
+    "https://cdn.example.com/styles.css": "public/css/external.css"
+  }
+}
+```
+
+2. Run the download command:
+
+```bash
+npx download-files
+```
+
+**Options:**
+
+- `-o, --output <dir>`: Specify an output directory where all files will be downloaded (relative paths in `_downloadFiles` will be resolved relative to this directory)
+
+```bash
+# Download all files to a specific directory
+npx download-files --output public
+```
+
+**Features:**
+
+- Downloads multiple files from external URLs
+- Automatically creates directories if they don't exist
+- Overwrites existing files
+- Continues downloading remaining files even if some fail
+- Provides clear progress and error messages
+- Returns appropriate exit codes for CI/CD integration
+
+**Use Cases:**
+
+- Download third-party libraries and assets
+- Fetch external resources during build processes
+- Keep vendored files up to date
+- Automate dependency downloads that aren't available via npm
+
 ## Requirements
 
 - Node.js >= 18.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anydigital/11ty-bricks",
-  "version": "1.0.0-alpha.2",
+  "version": "1.0.0-alpha.4",
   "description": "A collection of helpful utilities and filters for Eleventy (11ty)",
   "type": "module",
   "main": "./src/index.js",
@@ -10,11 +10,15 @@
       "require": "./src/index.cjs"
     }
   },
+  "bin": {
+    "download-files": "src/cli/download-files.js"
+  },
   "files": [
     "src"
   ],
   "scripts": {
-    "test": "node --test src/**/*.test.js"
+    "test": "node --test src/**/*.test.js",
+    "test2": "npx download-files && npx download-files --output ~subtest"
   },
   "keywords": [
     "11ty",
@@ -40,5 +44,9 @@
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "_downloadFiles": {
+    "https://raw.githubusercontent.com/anydigital/11ty-bricks/refs/heads/main/README.md": "~README.md",
+    "https://raw.githubusercontent.com/anydigital/11ty-bricks/refs/heads/main/LICENSE": "~test/LICENSE"
   }
 }

package/src/bricks/_nav.njk

@@ -0,0 +1,10 @@
+{% macro render(navPages, curPage) %}
+{# https://www.11ty.dev/docs/plugins/navigation/#bring-your-own-html-render-the-menu-items-manually #}
+<nav>
+  {%- for entry in navPages %}
+  <a href="{{ entry.url }}" {{ 'aria-current="page"' | safe if entry.url == curPage.url }}>
+    {{- entry.title -}}
+  </a>
+  {%- endfor %}
+</nav>
+{% endmacro %}

package/src/cli/download-files.js

@@ -0,0 +1,136 @@
+#!/usr/bin/env node
+
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { dirname, resolve, join } from 'path';
+
+/**
+ * Parse command line arguments
+ * 
+ * @returns {Object} Parsed arguments
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const parsed = {
+    outputDir: null
+  };
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (arg === '--output' || arg === '-o') {
+      if (i + 1 < args.length) {
+        parsed.outputDir = args[i + 1];
+        i++; // Skip next argument
+      } else {
+        throw new Error(`${arg} requires a directory path`);
+      }
+    }
+  }
+  
+  return parsed;
+}
+
+/**
+ * Downloads files specified in package.json's _downloadFiles field
+ * 
+ * @param {string|null} outputDir - Optional output directory to prepend to all paths
+ * @returns {Promise<boolean>} True if all downloads succeeded, false if any failed
+ */
+async function download(outputDir = null) {
+  try {
+    // Find and read package.json from the current working directory
+    const packageJsonPath = resolve(process.cwd(), 'package.json');
+    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf-8'));
+    
+    const downloadFiles = packageJson._downloadFiles;
+    
+    if (!downloadFiles || typeof downloadFiles !== 'object') {
+      console.log('No _downloadFiles field found in package.json');
+      return true;
+    }
+
+    const entries = Object.entries(downloadFiles);
+    
+    if (entries.length === 0) {
+      console.log('No files to download (_downloadFiles is empty)');
+      return true;
+    }
+
+    console.log(`Starting download of ${entries.length} file(s)...\n`);
+    
+    let hasErrors = false;
+    
+    // Process all downloads
+    for (const entry of entries) {
+      const url = entry[0];
+      let localPath = entry[1];
+      
+      try {
+        console.log(`Downloading: ${url}`);
+        console.log(`        To: ${localPath}`);
+        
+        // Download the file
+        const response = await fetch(url);
+        
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        
+        // Get the file content
+        const content = await response.arrayBuffer();
+        const buffer = Buffer.from(content);
+        
+        // Prepend output directory to local path if specified
+        if (outputDir) {
+          localPath = join(outputDir, localPath);
+        }
+        
+        // Resolve the full path
+        const fullPath = resolve(process.cwd(), localPath);
+        
+        // Create directory if it doesn't exist
+        const dir = dirname(fullPath);
+        await mkdir(dir, { recursive: true });
+        
+        // Write the file
+        await writeFile(fullPath, buffer);
+        
+        console.log(`   Success: ${localPath}\n`);
+      } catch (error) {
+        hasErrors = true;
+        console.error(`     Error: ${error.message}`);
+        console.error(`       URL: ${url}\n`);
+      }
+    }
+    
+    // Summary
+    if (hasErrors) {
+      console.log('Download completed with errors');
+      return false;
+    } else {
+      console.log('All downloads completed successfully');
+      return true;
+    }
+    
+  } catch (error) {
+    console.error(`Fatal error: ${error.message}`);
+    return false;
+  }
+}
+
+/**
+ * CLI entry point
+ */
+async function main() {
+  try {
+    const args = parseArgs();
+    const success = await download(args.outputDir);
+    process.exit(success ? 0 : 1);
+  } catch (error) {
+    console.error(`Error: ${error.message}`);
+    process.exit(1);
+  }
+}
+
+main();
+