@a-la/jsx

@a-la/jsx

@a-la/jsx is The JSX transform For ÀLamode And Other Packages.

yarn add -E @a-la/jsx

Table Of Contents

• Table Of Contents
• API
• jsx(string: string, config: Config): string
  • Config
• The Transform
• The Dynamic Method
• Copyright

API

The package is available by importing its default function:

import jsx from '@a-la/jsx'

jsx(
  string: string,
  config: Config,
): string

Returns the transpiled JSX code into h pragma calls.

Config: Options for the program.

Name	Type	Description	Default
quoteProps	(true|'dom')	Whether to surround property names with quotes, e.g., for the Google Closure Compiler. When dom is passed, it will only quote props for invoking html components, i.e., those that start with a lowercase letter.	false
warn	function	The function to receive warnings, e.g., when destructuring of properties is used on dom elements (for Closure Compiler).	-

/* yarn example/ */
import read from '@wrote/read'
import jsx from '@a-la/jsx'

(async () => {
  const code = await read('example/Component.jsx')
  const res = jsx(code)
  console.log(res)
})()

Given the component's source code:

import RichTextArea from 'richtext'

const Title = <title>Example</title>

export const Component = ({
  align = 'right', tabs, img,
}) => {
  const props = {
    class: 'example',
    id: 'id',
  }
  return <div onClick={(e) => {
    e.preventDefault()
    alert('Hello World')
    return false
  }} role="aria-button">
    <Title/>
    <RichTextArea dynamic />
    {tabs.map((tab, i) => <span key={i}>{tab}</span>)}
    <p {...props} align={align}>
      Hello World!
      {img && <img src={img}/>}
    </p>
  </div>
}

The following result is achieved:

import RichTextArea from 'richtext'

const Title = h('title',{},`Example`)

export const Component = ({
  align = 'right', tabs, img,
}) => {
  const props = {
    class: 'example',
    id: 'id',
  }
  return h('div',{onClick:(e) => {
    e.preventDefault()
    alert('Hello World')
    return false
  },role:"aria-button"},
    h(Title),
    h(RichTextArea,{dynamic:1}),
    tabs.map((tab, i) => h('span',{key:i},tab)),
    h('p',{...props,align:align},
      `Hello World!`
      ,img && h('img',{src:img}),
    ),
  )
}

The Transform

The transform is the Reg-Exp alternative to Babel's implementation of the JSX transform. We're not aware of any other alternatives, however this approach provides a light-weight solution for transforming JSX syntax for front-end and back-end rendering and static website generation. The lit-html is based on template strings, and does not provide html highlighting which is enabled in .jsx files. This makes JSX the standard of modern HTML templating. The service using the JSX does not have to be a react page, so that the transform can be used to server-side rendering which will always require serving HTML using a template. To achieve this in Node.js, the ÀLaMode transpiler can be used, whereas this package just exports a single function to perform the translation of the code.

The import and export statements will be temporally commented out when transpiling, otherwise V8 will throw an error when trying to detect where JSX syntax starts (see the method).

The Dynamic Method

This package will try to create a new Script (an import from the vm module) to find out where JSX syntax failed (first <). The location of the opening tag is therefore found out and the name of the tag extracted. With the name of the tag, the closing tag name can be found, and the contents inside parsed.

/Users/zavr/a-la/jsx/test/fixture/Component.jsx:2
  <div className={className}>
  ^

SyntaxError: Unexpected token <
    at createScript (vm.js:80:10)
    at Object.runInThisContext (vm.js:139:10)
    at Module._compile (module.js:617:28)
    at Object.Module._extensions..js (module.js:664:10)
    at Module.load (module.js:566:32)
    at tryModuleLoad (module.js:506:12)
    at Function.Module._load (module.js:498:3)
    at Function.Module.runMain (module.js:694:10)
    at startup (bootstrap_node.js:204:16)
    at bootstrap_node.js:625:3

Copyright

	© Art Deco for À La Mode 2019		Tech Nation Visa Sucks

Changelog

1.4.0

• [feature] Parse boolean attributes, e.g., <Component required />.
• [fix] Trim blank lines but preserve line order.

7 February 2019