jsx-slack v2

[yhatt]

I'm happy to announce jsx-slack v2 is now in beta! ✨

npm install --save @speee-js/jsx-slack@next

I've fully rewritten JSX structure and built-in components based on a proposal at #128.

▶︎ See highlight of v2

▶︎ Show v2 branch

▶︎ REPL demo in v2

We want to collect feedback to v2 beta for a while. If had no critical problems, I'm going to merge into master and bump to v2 in late April or early May.

Remaining ToDo in beta

• Throw more helpful error when defined __source prop by @babel/plugin-transform-react-jsx-source ([v2] Reset stack trace to point the location of error caused JSX if possible #143)
• Support a new JSX transform by React / Babel: jsx, jsxs and jsxDEV (EXPERIMENTAL) ([v2] Provide runtimes for Babel 7.9 automatic JSX transpile (experimental) #142)
• Add JSDoc for HTML-like elements ([v2] JSDoc for intrinsic HTML elements #147)
• Bundle CommonJS scripts for publish through rollup ([v2] Bundle modules through rollup #144)
• Improvement for REPL demo
  • Update demo schema ([v2] Update demo schema and design #148)
  • Generate permalink to specific JSX in REPL demo ([v2] Generate permalink to specific JSX in REPL demo #149)
  • Dark mode ([v2] Dark mode for REPL demo #150)
• New logo ([v2] New jsx-slack logo and logotype #152)

For now #20 is not scope of v2 release.

---

Breaking

• Checked states defined in <CheckboxGroup values> and <Checkbox checked> do no longer merge

• Breaking for TypeScript
  • Require TypeScript >= 3.7 when using jsx-slack through TypeScript
  • Container components have strict type checking for its children
  • Exported type JSXSlack.Child and JSXSlack.Children have been renamed into JSXSlack.ChildElement and JSXSlack.ChildElements and no longer provided generics

Changed

• Fully rewrote JSX structure to render from JSX to JSON directly (#128)
• All built-in components can render the partial JSON of Block Kit
• <Home> container now accepts <Input type="hidden" /> and custom transformer to store private metadata
• value prop for <Option> has made optional to follow HTML specification
• confirm prop for interactive block elements accepts the raw confirm composition object
• <a> tag renders short syntax for hyperlink if possible
• Throws error with more helpful message and stacktrace when there is invalid JSX structure (#143)
• Bundle modules through rollup (#144)

Added

• React-compatible public APIs: JSXSlack.createElement, JSXSlack.isValidElement, and JSXSlack.Children helpers
• HTML-compatible <Option selected> and <RadioButton checked>
• value prop as an alias into initialXXX prop in some interactive components
• Added JSDoc to many public APIs and components
• Support new JSX transpile via automatic runtime in Babel >= 7.9 (experimental) (#142)
• REPL demo now generates the permalink to specific JSX (#149)
• Dark mode for REPL demo (#150)
• New logo and logo type (#152)

Fixed

• Suggest string literals on IDE when typing the kind of conversation in <ConversationsSelect include> (#145)

Removed

• Deprecated features in v1: JSXSlack.legacyParser() and jsxslack.fragment

Deprecated

• jsxslack.raw template literal tag (It has become just an alias to jsxslack in v2)