Skip to content

A comprehensive, easy-to-use native depiction renderer.

Notifications You must be signed in to change notification settings

Parcility/Kennel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Kennel

A complete implementation of Sileo's native depictions in TypeScript.


Get Started

$ npm i @parcility/kennel

API

Kennel was written to be as easy to interact with as possible.

render(depiction: any, options?: Parital<RenderOptions>): Promise<HTMLElement | string>

Render a depiction to either a HTMLElement or a string.

depiction: An object that stores the native depiction's contents.

options: The settings used for rendering. options.ssr: Output a string instead of a DOM element. options.defaultTintColor: The css color used for the tint.

hydrate(target?: ParentNode): void

Runs the hydrate function on views that need to be hydrate. Can only be ran on the client side. target: The root element for hydration. Defaults to document.body.

Example

// Import Kennel
import { render, hydrate } from "@parcility/kennel";

// Assumes the `depiction` variables exists elsewhere. The second argument (options) can be omitted.
let output = await render(depiction, { ssr: true });

// sometime on the client.
hydrate();

A full demo is available by running yarn dev.


Development

Testing

Run the test page, which loads depictions from the test/ directory.

yarn dev

Building

This is not required if you installed Kennel through NPM.

1: Install dependencies

yarn install

2: Build module

yarn build