@sequencemedia/react-render 2.3.51 → 2.4.1

package/babel.config.cjs

@@ -12,5 +12,7 @@ module.exports = {
     ],
     '@babel/react'
   ],
-  ignore: [/node_modules\/(?!@sequencemedia\/react-render)/]
+  ignore: [
+    /node_modules\/(?!@sequencemedia\/react-render)/
+  ]
 }

package/eslint.config.mjs

@@ -0,0 +1,147 @@
+import globals from 'globals'
+import standard from '@sequencemedia/eslint-config-standard/configs/recommended/merge'
+import typescript from '@sequencemedia/eslint-config-typescript/configs/recommended/merge'
+import babelParser from '@babel/eslint-parser'
+import typescriptParser from '@typescript-eslint/parser'
+import reactPlugin from 'eslint-plugin-react'
+
+const reactParserOptions = {
+  ecmaFeatures: {
+    jsx: true
+  }
+}
+
+const reactPlugins = {
+  react: reactPlugin
+}
+
+const reactRules = {
+  'no-unused-vars': [
+    'error',
+    {
+      varsIgnorePattern: 'React'
+    }
+  ],
+  quotes: [
+    'error',
+    'single'
+  ],
+  'jsx-quotes': [
+    'error',
+    'prefer-single'
+  ],
+  'react/jsx-indent': [
+    'error',
+    2,
+    {
+      checkAttributes: true,
+      indentLogicalExpressions: true
+    }
+  ]
+}
+
+const reactSettings = {
+  react: {
+    version: 'detect'
+  }
+}
+
+export default [
+  {
+    ignores: [
+      'coverage'
+    ]
+  },
+  /**
+   *  React config for all `jsx` files
+   */
+  {
+    ...reactPlugin.configs.flat.recommended,
+    settings: {
+      ...reactSettings
+    }
+  },
+  /**
+   *  Standard config
+   */
+  standard({
+    files: [
+      '**/*.{mjs,cjs,mts,cts}'
+    ],
+    ignores: [
+      'src',
+      'test'
+    ],
+    languageOptions: {
+      globals: {
+        ...globals.node
+      }
+    }
+  }),
+  standard({
+    files: [
+      'src/**/*.{mjs,cjs,mts,cts}'
+    ],
+    languageOptions: {
+      globals: {
+        ...globals.node
+      }
+    }
+  }),
+  standard({
+    files: [
+      'test/**/*.{mjs,cjs,mts,cts}'
+    ],
+    languageOptions: {
+      globals: {
+        ...globals.mocha
+      }
+    }
+  }),
+  /**
+   *  Standard config for all `jsx` files
+   */
+  standard({
+    files: [
+      'src/**/*.jsx'
+    ],
+    languageOptions: {
+      parser: babelParser,
+      parserOptions: {
+        ...reactParserOptions,
+        project: null
+      },
+      globals: {
+        ...globals.browser
+      }
+    },
+    plugins: {
+      ...reactPlugins
+    }, // @ts-expect-error Storybook
+    rules: {
+      ...reactRules
+    },
+    settings: {
+      ...reactSettings
+    }
+  }),
+  /**
+   *  TypeScript config
+   */
+  typescript({
+    files: [
+      '**/*.{mts,cts}'
+    ],
+    languageOptions: {
+      parser: typescriptParser,
+      parserOptions: {
+        projectService: true,
+        project: 'tsconfig.json'
+      },
+      globals: {
+        ...globals.node,
+        ReactRenderTypes: 'readonly'
+      }
+    }
+  })
+]

package/index.d.mts

@@ -0,0 +1,10 @@
+import type React from 'react'
+
+declare global {
+  namespace ReactRenderTypes {
+    export type ComponentType = () => React.JSX.Element
+    export type PropsType = Record<string, unknown>
+  }
+}
+
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sequencemedia/react-render",
-  "version": "2.3.51",
+  "version": "2.4.1",
   "description": "React Render",
   "keywords": [
     "React",
@@ -11,6 +11,7 @@
   ],
   "main": "./src/index.mjs",
   "type": "module",
+  "types": "./index.d.mts",
   "author": {
     "name": "Jonathan Perry for Sequence Media Limited",
     "email": "jonathanperry@sequencemedia.net",
@@ -25,7 +26,7 @@
     "url": "git://github.com/sequencemedia/react-render.git"
   },
   "scripts": {
-    "lint": "eslint . --ext .mjs,.cjs,.jsx",
+    "lint": "eslint",
     "lint:fix": "npm run lint -- --fix",
     "prepare": "husky",
     "test": "NODE_ENV=test mocha test --recursive --verbose"
@@ -35,17 +36,26 @@
     "debug": "^4.4.0"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.9",
-    "@babel/eslint-parser": "^7.26.8",
+    "@babel/core": "^7.26.10",
+    "@babel/eslint-parser": "^7.26.10",
     "@babel/preset-env": "^7.26.9",
     "@babel/preset-react": "^7.26.3",
     "@babel/register": "^7.25.9",
+    "@sequencemedia/eslint-config-standard": "^0.2.42",
+    "@sequencemedia/eslint-config-typescript": "^0.1.60",
     "@sequencemedia/sinon-chai": "^0.0.131",
+    "@types/babel__register": "^7.17.3",
+    "@types/debug": "^4.1.12",
+    "@types/prop-types": "^15.7.14",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@typescript-eslint/eslint-plugin": "^8.26.1",
+    "@typescript-eslint/parser": "^8.26.1",
     "chai": "^5.2.0",
     "core-js": "^3.41.0",
-    "eslint": "8.57.1",
-    "eslint-config-standard": "^17.1.0",
+    "eslint": "^9.22.0",
     "eslint-plugin-react": "^7.37.4",
+    "globals": "^16.0.0",
     "husky": "^9.1.7",
     "mocha": "^11.1.0",
     "prop-types": "^15.8.1",

package/src/index.d.cts

@@ -0,0 +1,5 @@
+export {
+  renderToString,
+  renderToStaticMarkup,
+  render
+} from '#react-render'

package/src/index.d.mts

@@ -0,0 +1,5 @@
+export {
+  renderToString,
+  renderToStaticMarkup,
+  render
+} from '#react-render'

package/src/index.mjs

@@ -1,3 +1,8 @@
+/**
+ *  @typedef {ReactRenderTypes.ComponentType} ComponentType
+ *  @typedef {ReactRenderTypes.PropsType} PropsType
+ */
+
 import debug from 'debug'
 
 import {
@@ -10,22 +15,34 @@ const log = debug('@sequencemedia/react-render')
 log('`react-render` is awake')
 
 /**
- * @param {React.ReactElement} Component
- * @param {Object.<string, any>} props
- * @returns {string}
+ *  @param {ComponentType} Component
+ *  @param {PropsType} props
+ *  @returns {string}
  */
-export const renderToString = (Component, props = {}) => getReactDOMServerRenderToString(Component, props)
+export function renderToString (Component, props = {}) {
+  return (
+    getReactDOMServerRenderToString(Component, props)
+  )
+}
 
 /**
- * @param {React.ReactElement} Component
- * @param {Object.<string, any>} props
- * @returns {string}
+ *  @param {ComponentType} Component
+ *  @param {PropsType} props
+ *  @returns {string}
  */
-export const renderToStaticMarkup = (Component, props = {}) => getReactDOMServerRenderToStaticMarkup(Component, props)
+export function renderToStaticMarkup (Component, props = {}) {
+  return (
+    getReactDOMServerRenderToStaticMarkup(Component, props)
+  )
+}
 
 /**
- * @param {React.ReactElement} Component
- * @param {Object.<string, any>} props
- * @returns {Promise<string>}
+ *  @param {ComponentType} Component
+ *  @param {PropsType} props
+ *  @returns {string}
  */
-export const render = async (Component, props = {}) => getReactDOMServerRenderToString(Component, props)
+export function render (Component, props = {}) {
+  return (
+    getReactDOMServerRenderToString(Component, props)
+  )
+}

package/src/react-dom-server.cjs

@@ -1,5 +1,7 @@
 require('@babel/register')({
-  ignore: [/node_modules\/(?!@sequencemedia\/react-render)/]
+  ignore: [
+    /node_modules\/(?!@sequencemedia\/react-render)/
+  ]
 })
 
 const {

package/src/react-dom-server.d.cts

@@ -0,0 +1,4 @@
+export {
+  getReactDOMServerRenderToString,
+  getReactDOMServerRenderToStaticMarkup
+} from '#react-render/react-dom-server'

package/src/react-dom-server.d.mts

@@ -0,0 +1,8 @@
+declare module '#react-render/react-dom-server' {
+  type ComponentType = ReactRenderTypes.ComponentType
+  type PropsType = ReactRenderTypes.PropsType
+
+  export function getReactDOMServerRenderToString (Component: ComponentType, props: PropsType): string
+
+  export function getReactDOMServerRenderToStaticMarkup (Component: ComponentType, props: PropsType): string
+}

package/src/react-dom-server.jsx

@@ -1,3 +1,16 @@
+/**
+ *  @typedef {ReactRenderTypes.ComponentType} ComponentType
+ *  @typedef {ReactRenderTypes.PropsType} PropsType
+ *
+ *  @typedef {{
+ *    props: PropsType
+ *  }} PropsException
+ *
+ *  @typedef {{
+ *    e: unknown
+ *  }} Exception
+ */
+
 import debug from 'debug'
 import React from 'react'
 import ReactDOMServer from 'react-dom/server'
@@ -8,16 +21,20 @@ const log = debug('@sequencemedia/react-render')
 log('`react-render` is awake')
 
 /**
- * @param {Error} e
- * @param {{props: Object.<string, any>}} data
- * @returns A boom object
+ *  @param {Error} e
+ *  @param {PropsException | Exception} data
+ *  @returns A boom object
  */
-const badImplementation = (e, data) => Boom.boomify(e, { statusCode: 500, message: 'Rendering exception', data })
+function badImplementation (e, data) {
+  return (
+    Boom.boomify(e, { statusCode: 500, message: 'Rendering exception', data })
+  )
+}
 
 /**
- * @param {React.ReactElement} Component
- * @param {Object.<string, any>} props
- * @returns {string}
+ *  @param {ComponentType} Component
+ *  @param {PropsType} props
+ *  @returns {string}
  */
 export function getReactDOMServerRenderToString (Component, props) {
   try {
@@ -27,16 +44,15 @@ export function getReactDOMServerRenderToString (Component, props) {
       />
     )
   } catch (e) {
-    log(e)
-
-    throw badImplementation(e, { props })
+    if (e instanceof Error) throw badImplementation(e, { props })
+    throw badImplementation(new Error('Exception'), { e })
   }
 }
 
 /**
- * @param {React.ReactElement} Component
- * @param {Object.<string, any>} props
- * @returns {string}
+ *  @param {ComponentType} Component
+ *  @param {PropsType} props
+ *  @returns {string}
  */
 export function getReactDOMServerRenderToStaticMarkup (Component, props) {
   try {
@@ -46,8 +62,7 @@ export function getReactDOMServerRenderToStaticMarkup (Component, props) {
       />
     )
   } catch (e) {
-    log(e)
-
-    throw badImplementation(e, { props })
+    if (e instanceof Error) throw badImplementation(e, { props })
+    throw badImplementation(new Error('Exception'), { e })
   }
 }

package/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "target": "ESNext",
+    "allowJs": true,
+    "checkJs": true,
+    "noEmit": true,
+    "strict": true,
+    "jsx": "react",
+    "paths": {
+      "#react-render": [
+        "./src/index.mjs"
+      ],
+      "#react-render/react-dom-server": [
+        "./src/react-dom-server.cjs"
+      ]
+    }
+  },
+  "include": [
+    "."
+  ],
+  "exclude": [
+    "test"
+  ]
+}