@best-skn/elysia-html-types
v1.0.1
Published
A Simple Type Definition Extension Library For Elysia.js HTML
Downloads
9
Maintainers
Readme
SKN Elysia.js HTML Type Extension Library
TypeScript
Introduction:
This is a simple TypeScript Type Extension Library for Elysia.js HTML
I made this library so that I can use it in all of my Elysia.js projects without writing the same codes over and over again
Details:
JSXChildrenProps Interface
- As the name suggests, it is an interface for JSX props holding
childrenproperty - For usage instruction, see
Usagesection
JSXBasicProps Interface
- An interface that extends
JSXChildrenProps - In addition to
childrenproperty, it holdslang,desc,kwd,title,icnproperties - This interface is good for HTML meta info
- For usage instruction, see
Usagesection
JSXComponent Type
- This type definition is for JSX Component
- It takes a Generic type as its props type
- Returns a JSX component
- For usage instruction, see
Usagesection
JSXComponentNoProps Type
- As the name suggests, this type definition is just like
JSXComponentbut without props - It does not need a Generic type as it has no props
- Returns a JSX component
- For usage instruction, see
Usagesection
Use Case:
- Elysia.js
- Elysia.js HTML
Requirements:
This library has peer dependency for Elysia.js 1.2.25. It may or may not work on 2.x
This library is intended to be used in Elysia.js HTML of minimum 1.2.0. It may or may not work on 2.x
- 💀 Minimum elysia Version:
1.2.25 - 💀 Minimum @elysiajs/html Version:
1.2.0
Usage:
To install the package, type the following in console
npm add -D @best-skn/elysia-html-types #or yarn add -D @best-skn/elysia-html-types #or pnpm add -D @best-skn/elysia-html-types #or bun add -D @best-skn/elysia-html-types
Create a directory called types in the root location of your project, and create a file called elysia.d.ts, then do this
import "@best-skn/elysia-html-types";
Check your tsconfig.json if includes property has **/*.ts, **/*.tsx or not otherwise the type definition file may not work
Now Inside your Elysia.js Project, use the package like this (Just an example)
JSXChildrenProps Type:
For any JSX Component, do the following
import { Html, type JSXChildrenProps, type JSXComponent } from "@elysiajs/html"; const HomeRoute: JSXComponent<JSXChildrenProps> = (props) => { const { children } = props; return ( <div>{children}</div> ); }; export default HomeRoute;
JSXBasicProps Type:
For any kinds of JSX Component, do the following
import { Html, type JSXBasicProps, type JSXComponent } from "@elysiajs/html"; const BaseHtml: JSXComponent<JSXBasicProps> = (props) => { const { children, lang, desc, kwd, title, icn } = props; return ( <html lang={lang}> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="description" content={desc ?? "Elysia Web Application"} /> <meta name="keywords" content={kwd ?? "Elysia, Bun, TypeScript"} /> <title>{title ?? "Elysia App"}</title> <link rel="icon" href={icn ?? "/public/icons/logo.svg"} /> </head> <body> <main>{children}</main> </body> </html> ); }; export default BaseHtml;
JSXComponent Type:
For your JSX Component, do the following
import { Html, type JSXChildrenProps, type JSXComponent } from "@elysiajs/html"; const HomeRoute: JSXComponent<JSXChildrenProps> = (props) => { const { children } = props; return ( <div>{children}</div> ); }; export default HomeRoute;
JSXComponentNoProps Type:
For JSX Component, do the following
import { Html, type JSXComponentNoProps } from "@elysiajs/html"; const HomeRoute: JSXComponentNoProps = () => (<div>Hello from Elysia!</div>); export default HomeRoute;
Dedicated To:
- 👩🎨
Prodipta Das Logno& 🧛♀️Atoshi Sarker Prithula: The two most special ladies of my life. My best wishes will always be with you two. May you two always be happy. - 💯
My Parents: The greatest treasures of my life ever.
License:
Copyright (C) 2024 SKN Shukhan
Licensed under the MIT License
