@stephansama/typed-templates

@stephansama / typed-templates

Use standard schema to validate and use handlebar template directories

Table of contents

Open Table of contents

• Installation
• Usage

Installation

pnpm install @stephansama/typed-templates

Usage

create a map of different handlebar schemas

import * as z from "zod";

import {
  createHandlebarSchemaMap,
  createHandlebarSchemaSingleton,
  getFileContext,
} from "@stephansama/typed-templates";

const { isLinting, templateDirectory } = getFileContext(import.meta.url);

export const schemaMap = createHandlebarSchemaMap(
  {
    constList: {
      path: "../tests/fixtures/map/const-list.ts.hbs",
      schema: z.object({
        body: z.unknown(),
        name: z.string().trim(),
        plural_name: z.string().trim(),
      }),
    },
    constMap: {
      path: "../tests/fixtures/map/const-map.ts.hbs",
      schema: z.object({
        items: z.array(
          z.object({
            key: z.string().trim(),
            value: z.unknown(),
          }),
        ),
        map_type: z.string().trim(),
        name: z.string().trim(),
      }),
    },
  },
  { templateDirectory },
);

if (isLinting()) await schemaMap.audit();

or create a singleton schema used to validate multiple templates

export const singleSchema = createHandlebarSchemaSingleton(
  [
    "../tests/fixtures/singleton/valid.hbs",
    "../tests/fixtures/singleton/valid2.hbs",
  ],
  z.object({
    items: z.array(
      z.object({ key: z.string().trim(), value: z.string().trim() }),
    ),
    map_type: z.string().trim(),
    name: z.string().trim(),
  }),
  { templateDirectory },
);

if (isLinting()) await singleSchema.audit();

then later on in the code in another file:

export async function useTemplate() {
  return await schemaMap.compile("constList", {
    body: "body",
    name: "Name",
    plural_name: "Plural",
  });
}

Modules

Module	Description
index	‐
map	‐
normalize	‐
singleton	‐
utilities	‐