MCPcopy Index your code
hub / github.com/ad-si/shaven

github.com/ad-si/shaven @v2.1.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2.1.0 ↗ · + Follow
12 symbols 28 edges 20 files 0 documented · 0% 1 cross-repo links
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Logo

Shaven

Build Status

A DOM building utility and Template engine based on JsonML with syntax sugar.

Checkout shaven.ad-si.com for extensive documentation.

Example

shaven(
  [document.body,
    ['h1#logo', 'Static Example'],
    ['p','Some example text'],
    ['ul#list.bullets',
      ['li', 'item1'],
      ['li.active', 'item2'],
      ['li',
        ['a', 'item3', {href: '#'}]
      ]
    ],
    ['em', 'Important', {
      style: {
        color: 'red',
        'font-size': '2em',
      },
    }]
  ]
)

compiles to

<body>
  <h1 id="logo">Static Example</h1>


Some example text


  <ul id="list" class="bullets">
    <li>item1</li>
    <li class="active">item2</li>
    <li><a href="#">item3</a></li>
  </ul>
  <em style="color:red;font-size:2em">Important</em>
</body>

In order to convert HTML fragments to shaven arrays html2shaven can be used.

Features

  • Syntax Sugar for ids, classes and variable caching
  • Support for namespaces. (Lets you build SVGs and other XML based languages)
  • Callback functions on elements
  • Returns a Object containing the root element and the elements with an id

Advantages

  • Leverage the full power of JavaScript in your templates. => No need to learn a new language!
  • Directly integrable into JavaScript files
  • Works in front- and backend environment
  • Templates normally tend to get more complicated with the number of variables as they need to get escaped in some way. With Shaven it's exactly the opposite. As variables are native to Shaven the templates get simpler with an increasing number of variables.
  • Shaven templates can be easily build with every major programming language and their existing JSON/YAML tools.

Installation

npm install --save shaven

Check out shaven.ad-si.com for a detailed description of how to install shaven in other environments.

Browser Support

  • Firefox: 20+
  • Opera: 21+
  • Chrome: 34+
  • Safari: 9+ (Does not correctly escape HTML strings in attributes)
  • IE: ? (Probably 9+. Please submit a pull request if you know more.)
  • Edge (EdgeHTML): 12+

Earlier Firefox, Opera and Chrome versions have the same bug as Safari. That means even much older versions will just work fine under normal circumstances.

Development

Check if code changes must be made in the server and browser version of shaven.

  • Build website make
  • Bump version
  • Change version number in package file (semver)
  • Execute npm run prepublish
  • Commit
  • Tag commit (v<version>)
  • Publish to npm npm publish
  • Release new version of website: make deploy

Core symbols most depended-on inside this repo

shaven
called by 64
source/library/server.js
createId
called by 12
test/utils.js
createContainer
called by 6
test/dom.js
createElement
called by 1
source/library/browser.js
buildDom
called by 1
source/library/browser.js
createElement
called by 1
source/library/server.js
buildDom
called by 1
source/library/server.js
shaven
called by 0
source/library/browser.js

Shape

Function 12

Languages

TypeScript100%

Modules by API surface

source/library/server.js3 symbols
source/library/browser.js3 symbols
source/library/escape.js2 symbols
test/utils.js1 symbols
test/dom.js1 symbols
test/core.js1 symbols
source/library/stringifyStyleObject.js1 symbols

Used by 1 indexed graphs manifest dependencies, hub-wide

github.com/imsky/holder

For agents

$ claude mcp add shaven \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact