@dcl/playground-assets 7.23.4-26723618219.commit-ea97433 → 7.23.4-26770223094.commit-52b9415

package/dist/alpha.d.ts

@@ -6570,6 +6570,14 @@ export declare interface PBUiCanvasInformation {
      * on the contrary, if the chat UI is shown, the rect would be smaller.
      */
     interactableArea: BorderRect | undefined;
+    /**
+     * informs the sdk about the screen inset area (safe margins). these are the
+     * insets from each edge of the screen that are reserved by the device or
+     * platform UI (for example: the notch, status bar, home indicator, or rounded
+     * corners on mobile). scenes should avoid placing critical UI within these
+     * insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+     */
+    screenInsetArea?: BorderRect | undefined;
 }
 
 /**
@@ -8560,6 +8568,27 @@ export declare namespace Schemas {
     }) => void;
 }
 
+/**
+ *
+ * @public
+ * ScreenInsetArea component
+ *
+ * Constrains its children to the area inside the renderer-reported screen
+ * inset (safe margins). On mobile this is the area excluding the notch,
+ * status bar, home indicator and rounded corners. On desktop the insets are
+ * typically zero, so the container fills the canvas.
+ *
+ * The container is absolutely positioned with top/left/right/bottom matching
+ * the current `UiCanvasInformation.screenInsetArea`, so a child sized
+ * 100%x100% fills the safe area exactly.
+ *
+ * @example
+ * <ScreenInsetArea><MyHud /></ScreenInsetArea>
+ *
+ * @category Component
+ */
+export declare function ScreenInsetArea(props: UiScreenInsetAreaProps): ReactEcs.JSX.Element;
+
 /**
  * Sets a globalThis property as a polyfill (only if undefined/null).
  * @public
@@ -9415,6 +9444,28 @@ export declare type UiRendererOptions = {
     virtualHeight: number;
 };
 
+/**
+ * ScreenInsetArea component props
+ *
+ * The container reads the current `screenInsetArea` reported by the renderer
+ * via `UiCanvasInformation` (the device safe margins — notch, status bar,
+ * home indicator, rounded corners) and constrains its children to the area
+ * inside those insets using absolute positioning. Layout props that control
+ * the container's own position (`positionType`, `position`) are owned by the
+ * component and are not configurable from props — every other layout,
+ * background and event prop is forwarded as usual.
+ *
+ * @public
+ */
+export declare type UiScreenInsetAreaProps = Omit<EntityPropTypes, 'uiTransform'> & {
+    /**
+     * Layout overrides forwarded to the underlying entity. The
+     * `positionType` and `position` fields are reserved by the container and
+     * any value provided here is ignored.
+     */
+    uiTransform?: Omit<NonNullable<EntityPropTypes['uiTransform']>, 'positionType' | 'position'>;
+};
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 

package/dist/beta.d.ts

@@ -6542,6 +6542,14 @@ export declare interface PBUiCanvasInformation {
      * on the contrary, if the chat UI is shown, the rect would be smaller.
      */
     interactableArea: BorderRect | undefined;
+    /**
+     * informs the sdk about the screen inset area (safe margins). these are the
+     * insets from each edge of the screen that are reserved by the device or
+     * platform UI (for example: the notch, status bar, home indicator, or rounded
+     * corners on mobile). scenes should avoid placing critical UI within these
+     * insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+     */
+    screenInsetArea?: BorderRect | undefined;
 }
 
 /**
@@ -8532,6 +8540,27 @@ export declare namespace Schemas {
     }) => void;
 }
 
+/**
+ *
+ * @public
+ * ScreenInsetArea component
+ *
+ * Constrains its children to the area inside the renderer-reported screen
+ * inset (safe margins). On mobile this is the area excluding the notch,
+ * status bar, home indicator and rounded corners. On desktop the insets are
+ * typically zero, so the container fills the canvas.
+ *
+ * The container is absolutely positioned with top/left/right/bottom matching
+ * the current `UiCanvasInformation.screenInsetArea`, so a child sized
+ * 100%x100% fills the safe area exactly.
+ *
+ * @example
+ * <ScreenInsetArea><MyHud /></ScreenInsetArea>
+ *
+ * @category Component
+ */
+export declare function ScreenInsetArea(props: UiScreenInsetAreaProps): ReactEcs.JSX.Element;
+
 /**
  * Sets a globalThis property as a polyfill (only if undefined/null).
  * @public
@@ -9382,6 +9411,28 @@ export declare type UiRendererOptions = {
     virtualHeight: number;
 };
 
+/**
+ * ScreenInsetArea component props
+ *
+ * The container reads the current `screenInsetArea` reported by the renderer
+ * via `UiCanvasInformation` (the device safe margins — notch, status bar,
+ * home indicator, rounded corners) and constrains its children to the area
+ * inside those insets using absolute positioning. Layout props that control
+ * the container's own position (`positionType`, `position`) are owned by the
+ * component and are not configurable from props — every other layout,
+ * background and event prop is forwarded as usual.
+ *
+ * @public
+ */
+export declare type UiScreenInsetAreaProps = Omit<EntityPropTypes, 'uiTransform'> & {
+    /**
+     * Layout overrides forwarded to the underlying entity. The
+     * `positionType` and `position` fields are reserved by the container and
+     * any value provided here is ignored.
+     */
+    uiTransform?: Omit<NonNullable<EntityPropTypes['uiTransform']>, 'positionType' | 'position'>;
+};
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;
 

package/dist/index.bundled.d.ts

@@ -6542,6 +6542,14 @@ export declare interface PBUiCanvasInformation {
      * on the contrary, if the chat UI is shown, the rect would be smaller.
      */
     interactableArea: BorderRect | undefined;
+    /**
+     * informs the sdk about the screen inset area (safe margins). these are the
+     * insets from each edge of the screen that are reserved by the device or
+     * platform UI (for example: the notch, status bar, home indicator, or rounded
+     * corners on mobile). scenes should avoid placing critical UI within these
+     * insets to ensure it is not occluded. on desktop this is typically (0, 0, 0, 0).
+     */
+    screenInsetArea?: BorderRect | undefined;
 }
 
 /**
@@ -8532,6 +8540,27 @@ export declare namespace Schemas {
     }) => void;
 }
 
+/**
+ *
+ * @public
+ * ScreenInsetArea component
+ *
+ * Constrains its children to the area inside the renderer-reported screen
+ * inset (safe margins). On mobile this is the area excluding the notch,
+ * status bar, home indicator and rounded corners. On desktop the insets are
+ * typically zero, so the container fills the canvas.
+ *
+ * The container is absolutely positioned with top/left/right/bottom matching
+ * the current `UiCanvasInformation.screenInsetArea`, so a child sized
+ * 100%x100% fills the safe area exactly.
+ *
+ * @example
+ * <ScreenInsetArea><MyHud /></ScreenInsetArea>
+ *
+ * @category Component
+ */
+export declare function ScreenInsetArea(props: UiScreenInsetAreaProps): ReactEcs.JSX.Element;
+
 /**
  * Sets a globalThis property as a polyfill (only if undefined/null).
  * @public
@@ -9382,6 +9411,28 @@ export declare type UiRendererOptions = {
     virtualHeight: number;
 };
 
+/**
+ * ScreenInsetArea component props
+ *
+ * The container reads the current `screenInsetArea` reported by the renderer
+ * via `UiCanvasInformation` (the device safe margins — notch, status bar,
+ * home indicator, rounded corners) and constrains its children to the area
+ * inside those insets using absolute positioning. Layout props that control
+ * the container's own position (`positionType`, `position`) are owned by the
+ * component and are not configurable from props — every other layout,
+ * background and event prop is forwarded as usual.
+ *
+ * @public
+ */
+export declare type UiScreenInsetAreaProps = Omit<EntityPropTypes, 'uiTransform'> & {
+    /**
+     * Layout overrides forwarded to the underlying entity. The
+     * `positionType` and `position` fields are reserved by the container and
+     * any value provided here is ignored.
+     */
+    uiTransform?: Omit<NonNullable<EntityPropTypes['uiTransform']>, 'positionType' | 'position'>;
+};
+
 /** @public */
 export declare const UiText: LastWriteWinElementSetComponentDefinition<PBUiText>;