@b9g/crank 0.4.4 → 0.5.0-beta.0

package/crank.d.ts

@@ -166,9 +166,9 @@ export declare function isElement(value: any): value is Element;
  * children prop according to any additional arguments passed to the function.
  */
 export declare function createElement<TTag extends Tag>(tag: TTag, props?: TagProps<TTag> | null | undefined, ...children: Array<unknown>): Element<TTag>;
-/**
- * Clones a given element, shallowly copying the props object.
- */
+/** A single-letter alias for createElement */
+export declare const c: typeof createElement;
+/** Clones a given element, shallowly copying the props object. */
 export declare function cloneElement<TTag extends Tag>(el: Element<TTag>): Element<TTag>;
 /**
  * A helper type which repesents all possible rendered values of an element.

package/crank.js

@@ -105,6 +105,7 @@ class Element {
         this.static_ = static_;
     }
 }
+// See Element interface
 Element.prototype.$$typeof = ElementSymbol;
 function isElement(value) {
     return value != null && value.$$typeof === ElementSymbol;
@@ -127,6 +128,7 @@ function createElement(tag, props, ...children) {
             switch (name) {
                 case "crank-key":
                 case "c-key":
+                case "$key":
                     // We have to make sure we don’t assign null to the key because we
                     // don’t check for null keys in the diffing functions.
                     if (props[name] != null) {
@@ -135,12 +137,14 @@ function createElement(tag, props, ...children) {
                     break;
                 case "crank-ref":
                 case "c-ref":
+                case "$ref":
                     if (typeof props[name] === "function") {
                         ref = props[name];
                     }
                     break;
                 case "crank-static":
                 case "c-static":
+                case "$static":
                     static_ = !!props[name];
                     break;
                 default:
@@ -154,11 +158,27 @@ function createElement(tag, props, ...children) {
     else if (children.length === 1) {
         props1.children = children[0];
     }
+    // string aliases for the special tags
+    // TODO: Does this logic belong here, or in the Element constructor
+    switch (tag) {
+        case "$FRAGMENT":
+            tag = Fragment;
+            break;
+        case "$PORTAL":
+            tag = Portal;
+            break;
+        case "$COPY":
+            tag = Copy;
+            break;
+        case "$RAW":
+            tag = Raw;
+            break;
+    }
     return new Element(tag, props1, key, ref, static_);
 }
-/**
- * Clones a given element, shallowly copying the props object.
- */
+/** A single-letter alias for createElement */
+const c = createElement;
+/** Clones a given element, shallowly copying the props object. */
 function cloneElement(el) {
     if (!isElement(el)) {
         throw new TypeError("Cannot clone non-element");
@@ -732,9 +752,9 @@ const IsDone = 1 << 4;
  *
  * NOTE: This is mainly used to prevent some false positives in component
  * yields or returns undefined warnings. The reason we’re using this versus
- * IsUnmounted is a very troubling jest test (cascades sync generator parent
- * and sync generator child) where synchronous code causes a stack overflow
- * error in a non-deterministic way. Deeply disturbing stuff.
+ * IsUnmounted is a very troubling test (cascades sync generator parent and
+ * sync generator child) where synchronous code causes a stack overflow error
+ * in a non-deterministic way. Deeply disturbing stuff.
  */
 const IsErrored = 1 << 5;
 /**
@@ -1635,5 +1655,5 @@ function propagateError(ctx, err) {
 // default export. Prefer named exports when importing directly.
 var crank = { createElement, Fragment };
 
-export { Context, Copy, Element, Fragment, Portal, Raw, Renderer, cloneElement, createElement, crank as default, isElement };
+export { Context, Copy, Element, Fragment, Portal, Raw, Renderer, c, cloneElement, createElement, crank as default, isElement };
 //# sourceMappingURL=crank.js.map