@builder.io/sdk-solid 4.2.2 → 4.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -803,7 +803,17 @@ type Search = URLSearchParams | string | QueryObject;
803
803
 
804
804
  declare function isEditing(search?: Search): boolean;
805
805
 
806
- declare function isPreviewing(_search?: Search): boolean;
806
+ /**
807
+ * Checks the current URL's search parameters to see if it is attempting to
808
+ * preview Builder Content.
809
+ *
810
+ * When called on the client, it uses `window.location.search`.
811
+ * When called on the server (SSR), it requires a `search` argument.
812
+ *
813
+ * @param search - The search parameters to check. Can be a URL string (containing the search parameters), `URLSearchParams`, or a key-value object containing the search parameters.
814
+ * @returns `true` if the current page is being previewed, `false` otherwise.
815
+ */
816
+ declare function isPreviewing(search?: Search): boolean;
807
817
 
808
818
  declare const createRegisterComponentMessage: (info: ComponentInfo) => {
809
819
  type: string;
@@ -852,8 +862,14 @@ type Settings = {
852
862
  declare function setEditorSettings(newSettings: Settings): void;
853
863
 
854
864
  /**
855
- * Receives a `URLSearchParams` object or a regular query object, and returns the subset of query params that are
856
- * relevant to the Builder SDK.
865
+ * Receives a `URLSearchParams` object or a regular query object, and returns
866
+ * the subset of query params that are relevant to the Builder SDK.
867
+ *
868
+ * Outputs a key-value object to be passed to `fetchOneEntry` or `fetchEntries`
869
+ * functions as the `options` argument.
870
+ *
871
+ * NOTE: This function is generally not needed. Instead, it is recommended to use `isPreviewing()`
872
+ * to check if the current page requires previewed content.
857
873
  *
858
874
  * @returns
859
875
  */