express-hbs 2.4.2 → 2.5.1

package/.claude/worktrees/node-20-26-migration-7de0c3/example/app-layoutsDir.js

@@ -0,0 +1,99 @@
+// pnpm add express express-hbs
+
+'use strict';
+
+var express = require('express');
+var app = express();
+var hbs = require('..'); // should be `require('express-hbs')` outside of this example
+var fs = require('fs');
+var fp = require('path');
+
+function relative(path) {
+  return fp.join(__dirname, path);
+}
+var viewsDir = relative('views');
+
+app.use(express.static(relative('public')));
+
+// Hook in express-hbs and tell it where known directories reside
+app.engine(
+  'hbs',
+  hbs.express4({
+    partialsDir: [relative('views/partials'), relative('views/partials-other')],
+    layoutsDir: relative('views/layout'),
+    defaultLayout: relative('views/layout/default.hbs'),
+    restrictLayoutsTo: relative('views/layout'),
+  }),
+);
+app.set('view engine', 'hbs');
+app.set('views', relative('views'));
+
+// Register sync helper
+hbs.registerHelper('link', function (text, options) {
+  var attrs = [];
+  for (var prop in options.hash) {
+    attrs.push(prop + '="' + options.hash[prop] + '"');
+  }
+  return new hbs.SafeString('<a ' + attrs.join(' ') + '>' + text + '</a>');
+});
+
+// Register Async helpers
+hbs.registerAsyncHelper('readFile', function (filename, cb) {
+  fs.readFile(fp.join(viewsDir, filename), 'utf8', function (err, content) {
+    if (err) console.error(err);
+    cb(new hbs.SafeString(content));
+  });
+});
+
+var fruits = [{ name: 'apple' }, { name: 'orange' }, { name: 'pear' }];
+
+var veggies = [{ name: 'asparagus' }, { name: 'carrot' }, { name: 'spinach' }];
+
+app.get('/', function (req, res) {
+  res.render('index', {
+    title: 'express-hbs example',
+  });
+});
+
+app.get('/fruits', function (req, res) {
+  res.render('fruits/index-layoutsDir', {
+    title: 'My favorite fruits',
+    fruits: fruits,
+  });
+});
+
+app.get('/fruits/:name', function (req, res) {
+  res.render('fruits/details-layoutsDir', {
+    fruit: req.params.name,
+  });
+});
+
+app.get('/veggies', function (req, res) {
+  res.render('veggies', {
+    title: 'My favorite veggies',
+    veggies: veggies,
+    layout: 'veggie',
+  });
+});
+
+app.get('/veggies/explicit-dir', function (req, res) {
+  res.render('veggies', {
+    title: 'My favorite veggies',
+    veggies: veggies,
+    layout: relative('views/layout/veggie'),
+  });
+});
+
+app.get('/veggies/:name', function (req, res) {
+  res.render('veggies/details', {
+    veggie: req.params.name,
+    layout: 'veggie-details',
+  });
+});
+
+if (require.main === module) {
+  app.listen(3000);
+  console.log('Express server listening on port 3000');
+} else {
+  module.exports = app;
+}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/app.js

@@ -0,0 +1,103 @@
+'use strict';
+// pnpm add express express-hbs
+
+function create(hbs, env) {
+  if (env) process.env.NODE_ENV = env;
+
+  var express = require('express');
+  var app = express();
+  var fs = require('fs');
+  var fp = require('path');
+
+  function relative(path) {
+    return fp.join(__dirname, path);
+  }
+
+  var viewsDir = relative('views');
+
+  app.use(express.static(relative('public')));
+
+  // Hook in express-hbs and tell it where known directories reside
+  app.engine(
+    'hbs',
+    hbs.express4({
+      partialsDir: [relative('views/partials'), relative('views/partials-other')],
+      defaultLayout: relative('views/layout/default.hbs'),
+      restrictLayoutsTo: viewsDir,
+    }),
+  );
+  app.set('view engine', 'hbs');
+  app.set('views', viewsDir);
+
+  // Register sync helper
+  hbs.registerHelper('link', function (text, options) {
+    var attrs = [];
+    for (var prop in options.hash) {
+      attrs.push(prop + '="' + options.hash[prop] + '"');
+    }
+    return new hbs.SafeString('<a ' + attrs.join(' ') + '>' + text + '</a>');
+  });
+
+  // Register Async helpers
+  hbs.registerAsyncHelper('readFile', function (filename, cb) {
+    fs.readFile(fp.join(viewsDir, filename), 'utf8', function (err, content) {
+      if (err) console.error(err);
+      cb(new hbs.SafeString(content));
+    });
+  });
+
+  var fruits = [{ name: 'apple' }, { name: 'orange' }, { name: 'pear' }];
+
+  var veggies = [{ name: 'asparagus' }, { name: 'carrot' }, { name: 'spinach' }];
+
+  app.get('/', function (req, res) {
+    res.render('index', {
+      title: 'express-hbs example',
+    });
+  });
+
+  app.get('/replace', function (req, res) {
+    res.render('replace', {
+      title: 'express-hbs example',
+    });
+  });
+
+  app.get('/fruits', function (req, res) {
+    res.render('fruits/index', {
+      title: 'My favorite fruits',
+      fruits: fruits,
+    });
+  });
+
+  app.get('/fruits/:name', function (req, res) {
+    res.render('fruits/details', {
+      fruit: req.params.name,
+    });
+  });
+
+  app.get('/veggies', function (req, res) {
+    res.render('veggies', {
+      title: 'My favorite veggies',
+      veggies: veggies,
+      layout: 'layout/veggie',
+    });
+  });
+
+  app.get('/veggies/:name', function (req, res) {
+    res.render('veggies/details', {
+      veggie: req.params.name,
+      layout: 'layout/veggie-details',
+    });
+  });
+
+  return app;
+}
+
+if (require.main === module) {
+  var hbs = require('..');
+  var app = create(hbs);
+  app.listen(3000);
+  console.log('Express server listening on port 3000');
+} else {
+  exports.create = create;
+}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/public/css/style.css

@@ -0,0 +1,17 @@
+* {
+  font-family: Georgia, serif;
+}
+
+h1, h2 {
+  font-family: Helvetica, Arial, sans;
+}
+
+.veggie-details {
+    border: 5px solid green;
+    padding: 10px;
+}
+
+.fruit-details {
+    border: 5px solid red;
+    padding: 10px;
+}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/fruits/details-layoutsDir.hbs

@@ -0,0 +1,3 @@
+{{!< fruit-details}}
+
+{{fruit}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/fruits/details.hbs

@@ -0,0 +1,4 @@
+{{!< ../layout/fruit-details}}
+
+{{fruit}}
+

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/fruits/index-layoutsDir.hbs

@@ -0,0 +1,20 @@
+<!-- name of layout -->
+{{!< fruits}}
+
+{{#contentFor 'pageStyles'}}
+<style>
+  li a {
+    color: #800;
+  }
+</style>
+{{/contentFor}}
+
+
+<h1>{{title}}</h1>
+<ul>
+    {{#each fruits}}
+      <li>
+        <a href="/fruits/{{this.name}}">{{this.name}}</a>
+      </li>
+    {{/each}}
+</ul>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/fruits/index.hbs

@@ -0,0 +1,20 @@
+<!-- name of layout -->
+{{!< ../layout/fruits}}
+
+{{#contentFor 'pageStyles'}}
+<style>
+  li a {
+    color: #800;
+  }
+</style>
+{{/contentFor}}
+
+
+<h1>{{title}}</h1>
+<ul>
+    {{#each fruits}}
+    <li>
+      <a href="/fruits/{{this.name}}">{{this.name}}</a>
+    </li>
+    {{/each}}
+</ul>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/index.hbs

@@ -0,0 +1,34 @@
+{{#contentFor 'pageStyles'}}
+<style>
+  .clicker {
+    color: blue;
+  };
+</style>
+{{/contentFor}}
+
+
+{{#contentFor 'pageScripts'}}
+<script>
+  $(function() {
+    $('.clicker').click(function() {
+      $(this).text('Hello express-hbs!');
+    });
+  });
+</script>
+{{/contentFor}}
+
+
+<h1>{{title}}</h1>
+<p class='clicker'>Click me!</p>
+<p>
+  <a href='/fruits'>Favorite fruits</a>
+</p>
+<p>
+  <!-- sync helper -->
+  {{{link 'Vegetables' href='/veggies'}}}
+</p>
+
+<!-- async helper -->
+<div>
+{{{readFile 'tos.txt'}}}
+</div>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/default.hbs

@@ -0,0 +1,13 @@
+{{!< html-struct}}
+
+<h2>DEFAULT LAYOUT</h2>
+
+{{#block 'default-block'}}
+  Default block content
+{{/block}}
+
+{{#block 'replaced-default-block'}}
+  Default block content
+{{/block}}
+
+{{{body}}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/fruit-details.hbs

@@ -0,0 +1,9 @@
+{{!< fruits}}
+
+<h3>NESTED LAYOUT</h3>
+
+<p>This is one of my favorite fruits!</p>
+
+<span class="fruit-details">
+  {{{body}}}
+</span>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/fruits.hbs

@@ -0,0 +1,6 @@
+{{!< html-struct}}
+
+<h2>DECLARATIVE LAYOUT</h2>
+
+<!-- Placeholder for page content. -->
+{{{body}}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/html-struct.hbs

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>{{title}}</title>
+    <link type="text/css" rel="stylesheet" href="/css/style.css"/>
+    {{{block "pageStyles"}}}
+  </head>
+
+  <body>
+
+    <!-- Placeholder for page content. -->
+    {{{body}}}
+
+    <!-- Partials are common snippets to be used 1 or more pages. -->
+    {{> scripts}}
+    {{> other}}
+
+    <!-- A block is placeholder for pieces of content defined in a page. -->
+    {{{block 'pageScripts'}}}
+  </body>
+</html>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/veggie-details.hbs

@@ -0,0 +1,9 @@
+{{!< veggie}}
+
+<h3>NESTED LAYOUT</h3>
+
+<p>This is one of my favorite veggies!</p>
+
+<span class="veggie-details">
+  {{{body}}}
+</span>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/layout/veggie.hbs

@@ -0,0 +1,6 @@
+{{!< html-struct}}
+
+<h2>PROGRAMMATIC LAYOUT</h2>
+
+<!-- Placeholder for page content. -->
+{{{body}}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/partials/scripts.hbs

@@ -0,0 +1,5 @@
+{{#if production}}
+   <script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.min.js"></script>
+{{else}}
+   <script src="//ajax.googleapis.com/ajax/libs/jquery/1.8.2/jquery.js"></script>
+{{/if}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/partials/sub/comment.hbs

@@ -0,0 +1 @@
+<!-- just a comment -->

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/partials-other/other.hbs

@@ -0,0 +1 @@
+<!-- Other partial -->

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/replace.hbs

@@ -0,0 +1,6 @@
+{{#contentFor 'replaced-default-block'}}
+    Non-default block content
+{{/contentFor}}
+
+
+<h1>{{title}}</h1>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/tos.txt

@@ -0,0 +1,3 @@
+<h4>Terms of Service</h4>
+
+<div>Async result!</div>

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/veggies/details.hbs

@@ -0,0 +1 @@
+{{veggie}}

package/.claude/worktrees/node-20-26-migration-7de0c3/example/views/veggies.hbs

@@ -0,0 +1,17 @@
+{{#contentFor 'pageStyles'}}
+<style>
+  li a {
+    color: #800;
+  }
+</style>
+{{/contentFor}}
+
+{{> sub/comment}}
+<h1>{{title}}</h1>
+<ul>
+    {{#each veggies}}
+      <li>
+        <a href="/veggies/{{this.name}}">{{this.name}}</a>
+      </li>
+    {{/each}}
+</ul>

package/.claude/worktrees/node-20-26-migration-7de0c3/index.js

@@ -0,0 +1 @@
+module.exports = require('./lib/hbs');

package/.claude/worktrees/node-20-26-migration-7de0c3/lib/generate-id.js

@@ -0,0 +1,16 @@
+'use strict';
+
+var alphabet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_';
+
+function generateId(length) {
+  if (!length) {
+    length = 8;
+  }
+  var res = '';
+  for (var i = 0; i < length; ++i) {
+    res += alphabet[Math.floor(Math.random() * alphabet.length)];
+  }
+  return res;
+}
+
+module.exports = generateId;