sample-cross-fx 0.14.24-beta.4144 → 0.14.24-beta.4161

package/app/index.d.ts

@@ -878,6 +878,10 @@ declare module "sample-cross-fx" {
      * The provided parameters for showing the extension.
      */
     params: T extends keyof PiralExtensionSlotMap ? PiralExtensionSlotMap[T] : T extends string ? any : T;
+    /**
+     * The optional children to receive, if any.
+     */
+    children?: React.ReactNode;
   }
 
   /**
@@ -898,9 +902,27 @@ declare module "sample-cross-fx" {
      * for the specified extension.
      */
     empty?(): React.ReactNode;
+    /**
+     * Determines if the `render` function should be called in case no
+     * components are available for the specified extension.
+     * 
+     * If true, `empty` will be called and returned from the slot.
+     * If false, `render` will be called with the result of calling `empty`.
+     * The result of calling `render` will then be returned from the slot.
+     */
+    emptySkipsRender?: boolean;
+    /**
+     * Defines the order of the components to render.
+     * May be more convient than using `render` w.r.t. ordering extensions
+     * by their supplied metadata.
+     * @param extensions The registered extensions.
+     * @returns The ordered extensions.
+     */
+    order?(extensions: Array<ExtensionRegistration>): Array<ExtensionRegistration>;
     /**
      * Defines how the provided nodes should be rendered.
      * @param nodes The rendered extension nodes.
+     * @returns The rendered nodes, i.e., an ReactElement.
      */
     render?(nodes: Array<React.ReactNode>): React.ReactElement<any, any> | null;
     /**
@@ -1188,6 +1210,24 @@ declare module "sample-cross-fx" {
    */
   export interface PiralCustomExtensionSlotMap {}
 
+  /**
+   * The interface modeling the registration of a pilet extension component.
+   */
+  export interface ExtensionRegistration extends BaseRegistration {
+    /**
+     * The wrapped registered extension component.
+     */
+    component: WrappedComponent<ExtensionComponentProps<string>>;
+    /**
+     * The original extension component that has been registered.
+     */
+    reference: any;
+    /**
+     * The default params (i.e., meta) of the extension.
+     */
+    defaults: any;
+  }
+
   /**
    * Metadata for pilets using the v0 schema with a content.
    */
@@ -1225,6 +1265,18 @@ declare module "sample-cross-fx" {
     readState: PiralActions["readState"];
   }
 
+  /**
+   * The base type for pilet component registration in the global state context.
+   */
+  export interface BaseRegistration {
+    /**
+     * The pilet registering the component.
+     */
+    pilet: string;
+  }
+
+  export type WrappedComponent<TProps> = React.ComponentType<Without<TProps, keyof BaseComponentProps>>;
+
   /**
    * Basic metadata for pilets using the v0 schema.
    */
@@ -1434,6 +1486,8 @@ declare module "sample-cross-fx" {
     readState<S>(select: (state: GlobalState) => S): S;
   }
 
+  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
+
   /**
    * Custom state extensions defined outside of piral-core.
    */
@@ -1584,19 +1638,16 @@ declare module "sample-cross-fx" {
    * The interface modeling the registration of a pilet page component.
    */
   export interface PageRegistration extends BaseRegistration {
+    /**
+     * The registered page component.
+     */
     component: WrappedComponent<PageComponentProps>;
+    /**
+     * The page's associated metadata.
+     */
     meta: PiralPageMeta;
   }
 
-  /**
-   * The interface modeling the registration of a pilet extension component.
-   */
-  export interface ExtensionRegistration extends BaseRegistration {
-    component: WrappedComponent<ExtensionComponentProps<string>>;
-    reference: any;
-    defaults: any;
-  }
-
   /**
    * Map of all error types to their respective props.
    */
@@ -1733,15 +1784,6 @@ declare module "sample-cross-fx" {
     options: LoadPiletsOptions;
   }
 
-  /**
-   * The base type for pilet component registration in the global state context.
-   */
-  export interface BaseRegistration {
-    pilet: string;
-  }
-
-  export type WrappedComponent<TProps> = React.ComponentType<Without<TProps, keyof BaseComponentProps>>;
-
   /**
    * Custom errors defined outside of piral-core.
    */
@@ -1927,8 +1969,6 @@ declare module "sample-cross-fx" {
     strategy?: PiletLoadingStrategy;
   }
 
-  export type Without<T, K> = Pick<T, Exclude<keyof T, K>>;
-
   export interface TileErrorInfoProps {
     /**
      * The type of the error.

package/app/{index.b6b3d6.js → index.ea3783.js}

@@ -129049,22 +129049,30 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
+function defaultOrder(extensions) {
+  return extensions;
+}
 /**
  * The extension slot component to be used when the available
  * extensions of a given name should be rendered at a specific
  * location.
  */
 
+
 function ExtensionSlot(props) {
   const {
     name,
     render = _utils__WEBPACK_IMPORTED_MODULE_1__.defaultRender,
     empty,
     params,
-    children
+    children,
+    emptySkipsRender = false,
+    order = defaultOrder
   } = props;
   const extensions = (0,_hooks__WEBPACK_IMPORTED_MODULE_2__.useGlobalState)(s => s.registry.extensions[name] || _utils__WEBPACK_IMPORTED_MODULE_3__.none);
-  return render(extensions.length === 0 && (0,piral_base__WEBPACK_IMPORTED_MODULE_4__.isfunc)(empty) ? [(0,_utils__WEBPACK_IMPORTED_MODULE_1__.defaultRender)(empty(), 'empty')] : extensions.map(({
+  const isEmpty = extensions.length === 0 && (0,piral_base__WEBPACK_IMPORTED_MODULE_4__.isfunc)(empty);
+  const content = isEmpty ? [(0,_utils__WEBPACK_IMPORTED_MODULE_1__.defaultRender)(empty(), 'empty')] : order(extensions).map(({
     component: Component,
     reference,
     defaults = {}
@@ -129072,7 +129080,13 @@ function ExtensionSlot(props) {
     key: `${(reference === null || reference === void 0 ? void 0 : reference.displayName) || '_'}${i}`,
     children: children,
     params: Object.assign(Object.assign({}, defaults), params || {})
-  })));
+  }));
+
+  if (isEmpty && emptySkipsRender) {
+    return content[0];
+  }
+
+  return render(content);
 }
 ExtensionSlot.displayName = `ExtensionSlot`;
 
@@ -129757,7 +129771,7 @@ function createInstance(config = {}) {
   const createApi = apiFactory(context, usedPlugins);
   const root = createApi({
     name: 'root',
-    version: "0.14.24-beta.4144" || 0,
+    version: "0.14.24-beta.4161" || 0,
     spec: ''
   });
   const options = (0,_helpers__WEBPACK_IMPORTED_MODULE_6__.createPiletOptions)({
@@ -131757,11 +131771,11 @@ function installPiralDebug(options) {
     debug: debugApiVersion,
     instance: {
       name: "sample-cross-fx",
-      version: "0.14.24-beta.4144",
+      version: "0.14.24-beta.4161",
       dependencies: "@angular/common,@angular/compiler,@angular/core,@angular/platform-browser,@angular/platform-browser-dynamic,@webcomponents/webcomponentsjs,angular,aurelia-framework,aurelia-templating-binding,aurelia-templating-resources,aurelia-pal-browser,aurelia-event-aggregator,aurelia-history-browser,hyperapp,inferno,inferno-create-element,mithril,lit-element,solid-js,solid-js/dom,piral-ng/common,preact,riot,rxjs,vue,zone.js,react,react-dom,react-router,react-router-dom,history,tslib,path-to-regexp,@libre/atom,@dbeining/react-atom"
     },
     build: {
-      date: "2022-05-04T12:53:45.333Z",
+      date: "2022-05-06T14:34:53.098Z",
       cli: "0.14.23",
       compat: "0.14"
     },
@@ -254023,4 +254037,4 @@ const app = /*#__PURE__*/react__WEBPACK_IMPORTED_MODULE_7__.createElement(piral_
 
 /******/ })()
 ;
-//# sourceMappingURL=index.b6b3d6.js.map
+//# sourceMappingURL=index.ea3783.js.map