feat: terse Fragment syntax

README.md

@@ -28,6 +28,25 @@ class SomeComponent extends Component {
 module.exports = SomeComponent;
 ```
 
+You can create a Fragment tersely by passing only one argument: an
+array of other nodes or strings:
+
+```js
+const frag = h([
+  h('div', 'one'),
+  h('div', 'two'),
+  'three'
+]);
+
+// is equivalent to:
+
+const { Fragment } = require('preact');
+const frag = h(Fragment, [
+  h('div', 'one'),
+  h('div', 'two'),
+  'three'
+]);
+
 ## Optional Tag Helpers
 
 At the cost of a modestly larger import and slight function call overhead,

lib/phy.js

@@ -69,11 +69,19 @@ function isAttributes(obj) {
 // possible arg combos (eliding createElement) (kids* = 0-or-more-kids):
 /**
  * @param {typeof preact.createElement} createElement
- * @param {string | ComponentType} selector
+ * @param {string | ComponentType | (string | ComponentType)[]} selector
  * @param {Readonly<Record<string, any>>} [attrs]
  * @param {ComponentChildren[]} kids
+ * @return {preact.VNode}
  */
 function h(createElement, selector, attrs, ...kids) {
+  if (Array.isArray(selector)) {
+    if (attrs != null || kids.length > 0) {
+      throw new Error('Fragment mode does not accept attrs or kids');
+    }
+    return h(createElement, preact.Fragment, undefined, selector);
+  }
+
   if (attrs) {
     if (!isAttributes(attrs)) {
       kids.unshift(/** @type {ComponentChildren} */ (attrs));

lib/typedefs.d.ts

@@ -3,6 +3,7 @@ import p from 'preact';
 
 declare function isPreactNode(obj: object): boolean;
 
+declare function phy(fragments: (string | ComponentType)[]): VNode;
 declare function phy(
   selectorOrComp: string | ComponentType,
   ...kids: ComponentChildren[]

test/phy.test.js

@@ -93,6 +93,11 @@ const tests = [
     h('litter-box', {}, [h(Fragment, {}, ['kitten', h('toy', 'mouse')])]),
     '<litter-box>kitten<toy>mouse</toy></litter-box>',
   ],
+  [
+    'Fragment terse usage',
+    h(['kitten', h('toy', 'mouse')]),
+    'kitten<toy>mouse</toy>',
+  ],
 ];
 
 describe('phy', () => {
@@ -102,6 +107,17 @@ describe('phy', () => {
         assert.equal(test[2], render(test[1]));
       });
     });
+
+    it('throws on surplus fragment args', () => {
+      assert.include(
+        'Fragment mode',
+        assert.throws(() => h(['a', 'b'], { some: 'attr' })).message
+      );
+      assert.include(
+        'Fragment mode',
+        assert.throws(() => h(['a', 'b'], undefined, 'kid')).message
+      );
+    });
   });
 
   describe('isVNode', () => {