1.1.2 • Published 1 year ago

@best-skn/react-types v1.1.2

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

SKN React Type Extension Library

TypeScript React

NPM Version MIT License

 

Introduction:

This is a simple TypeScript Type Extension Library for React 18 & also for Next.js 14

I made this library so that I can use it in all of my Next.js 14 projects without writing the same codes over and over again

 

Details:

SC/SFC Type

  • type SC/SFC both are for server components except for layout ones (layout.tsx in Next.js 14)
  • type SC/SFC both take generic type of any kinds of props
  • SC is used in asynchronous server components that returns a Promise of React.JSX.Element | React.ReactNode
  • SFC is used in synchronous server components that returns React.JSX.Element | React.ReactNode
  • For usage instruction, see Usage section

ChildrenProps Type

  • An interface that has children property of type React.JSX.Element | React.ReactNode
  • For usage instruction, see Usage section

SLC/SFLC Type

  • type SLC/LSFC both are for layout server components (layout.tsx in Next.js 14)
  • type SLC/SFLC don't take any generics
  • SLC is used in asynchronous layout server components that returns a Promise of React.JSX.Element | React.ReactNode
  • SFLC is used in synchronous layout server components that returns React.JSX.Element | React.ReactNode
  • For usage instruction, see Usage section

 

Use Case:

  • React
  • Next.js

 

Requirements:

This library has peer dependency for React & React DOM of minimum 18.3.1. It may or may not work on 19.x

This library is intended to be used in Next.js of minimum 14.2.3. It may or may not work on 15.x

 

Complementary Libraries:

 

Usage:

To install the package, type the following in console

npm add -D @best-skn/react-types
#or
yarn add -D @best-skn/react-types
#or
pnpm add -D @best-skn/react-types
#or
bun add -D @best-skn/react-types

Create a directory called types in the root location of your project, and create a file called react.d.ts, then do this

import "@best-skn/react-types";

Check your tsconfig.json if includes property has **/*.ts or not otherwise the type definition file may not work

Now Inside your Next.js 14 Project, use the package like this (Just an example)

SC/SFC Type:

For any Server Components except the Layout Server Components, do the following

(a) Asynchronous:
// Location: app/page.tsx
const Home: React.SC<unknown> = async () => {
  return (
    <div>something...</div>
  );
};

export default Home;
(b) Synchronous:
// Location: app/page.tsx
const Home: React.SFC<unknown> = () => {
  return (
    <div>something...</div>
  );
};

export default Home;

ChildrenProps Type:

For any kinds of Functional Component (Server or Client), you can use like this if it needs children props

(a) Server:
import type { ChildrenProps } from "react";

const HomeComponent: React.SFC<ChildrenProps> = (props) => {
  const { children } = props;

  return (
    <div>something...</div>
  );
};

export default HomeComponent;
(b) Client:
"use client"

import type { ChildrenProps } from "react";

const HomeComponent: React.FC<ChildrenProps> = (props) => {
  const { children } = props;

  return (
    <div>something...</div>
  );
};

export default HomeComponent;

SLC/SFLC Type:

For any Layout Server Components, do the following

(a) Asynchronous case:
// Location: app/layout.tsx
const RootLayout: React.SLC = async (props) => {
  const { children } = props;

  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  );
};

export default RootLayout;
(a) Synchronous case:
// Location: app/layout.tsx
const RootLayout: React.SFLC = (props) => {
  const { children } = props;

  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  );
};

export default RootLayout;

 

Dedicated To:

  • 👩‍⚕️Tanjila Hasan Trina: The long lost love of my life. The course of nature separated us from our paths and put us in separate places far away from each other. But no matter how separated we are right now, each and every moment of mine is only dedicated to you. We may not see each other in this lifetime as it seems but I will find you again in the next life. I just want to say: 世界は残酷だ それでも君を愛すよ
  • 💯My Parents: The greatest treasures of my life ever.

 

License:

Copyright (C) 2024 SKN Shukhan

Licensed under the MIT License

1.1.2

1 year ago

1.1.1

1 year ago

1.1.0

1 year ago

1.0.5

1 year ago

1.0.4

1 year ago

1.0.3

1 year ago

1.0.2

1 year ago

1.0.1

1 year ago

1.0.0

1 year ago