@tentjs/helpers v0.0.8

💁🏻 Helpers

Functions and types that ease writing ⛺Tent components.

⚡ Included

• bind - Bind an Input element value to a state property
• classes - Generate a class string from multiple class names
• on - Easier event handling based on key codes
• ternary - Simplified conditional rendering
• mountAll - Mount multiple components at once
• keep - A wrapper for the keep attribute
• FormEvent<T> - A generic type for form events

📦 Installation

npm install @tentjs/helpers
# or with JSR (recommended)
npx jsr add @tentjs/helpers

👀 Examples

bind

import { type Component, tags } from "@tentjs/tent";
import { bind } from "@tentjs/helpers";

type State = { name: string; details: { age: number } };

const MyComponent: Component<State> = {
  state: { name: "", details: { age: 0 } },
  view: ({ state }) =>
    tags.input("", {
      // Bind the input value to the state property `name`
      oninput: bind(state, "name"),
      // or, for nested properties:
      // bind(state, "details.age"),
    }),
};

FormEvent<T>

import { tags } from "@tentjs/tent";
import { type FormEvent } from "@tentjs/helpers";

tags.input("", {
  oninput: (event: FormEvent<HTMLInputElement>) => {
    // event.target is typed as `HTMLInputElement`
    state.name = event.target.value;
  },
});

classes

import { tags } from "@tentjs/tent";
import { classes } from "@tentjs/helpers";

tags.div("", {
  className: classes("container", 2 > 3 && "some-class"),
});

on

import { tags } from "@tentjs/tent";
import { on } from "@tentjs/helpers";

tags.input("", {
  onkeydown: on({
    Enter: () => console.log("Enter pressed"),
    Escape: () => console.log("Escape pressed"),
  }),
});

ternary

import { tags } from "@tentjs/tent";
import { ternary } from "@tentjs/helpers";

const MyComponent = {
  view: () =>
    tags.div(
      ternary(3 > 2, "3 is greater than 2", "3 is not greater than 2"),
      // => "3 is greater than 2"
    ),
};

mountAll

import { mountAll } from "@tentjs/helpers";

mountAll([
  { target: ".target-1", component: Component1 },
  { target: ".target-2", component: Component2 },
  { target: ".target-3", component: Component3 },
]);

keep

import { keep } from "@tentjs/helpers";

keep(
  [
    // Children to cache after first render
  ],
  { keep: true },
);