@mapples/ui 1.1.0 → 1.1.2

package/dist/components/views/FlatList/FlatList.js

@@ -1,6 +1,30 @@
 import { forwardRef, Fragment } from 'react';
 import StateProvider from '@mapples/state';
 import { StyledFlatList, StyledView } from '@mapples/style';
+/**
+ * A data-driven list component with built-in styling support.
+ *
+ * `FlatList` renders a scrollable list of items from the `data` prop, wrapping
+ * each item in a `StateProvider` so that child components can access item state
+ * directly. The outer container and the inner list accept independent `styled`
+ * entries, enabling separate layout and scroll-area styling.
+ *
+ * @example
+ * ```tsx
+ * <FlatList
+ *   data={items}
+ *   styled={{
+ *     style: { flex: 1, backgroundColor: 'white' },
+ *     styleList: { paddingHorizontal: 16 },
+ *     contentContainerStyle: { paddingBottom: 32 },
+ *   }}
+ * >
+ *   <Text text="item name" />
+ * </FlatList>
+ * ```
+ *
+ * @public
+ */
 const FlatListComponent = forwardRef(({ styled, children, ...props }, ref) => {
     const containerStyled = { style: styled?.style };
     const listStyled = {

package/dist/components/views/FlatList/FlatList.js.map

@@ -1 +1 @@
-{"version":3,"file":"FlatList.js","sourceRoot":"","sources":["../../../../src/components/views/FlatList/FlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAC;AAEhE,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAexE,MAAM,iBAAiB,GAAG,UAAU,CAClC,CACE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAoB,EAChD,GAAgB,EAChB,EAAE;IACF,MAAM,eAAe,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAS,CAAC;IACxD,MAAM,UAAU,GAAG;QACjB,KAAK,EAAE,MAAM,EAAE,SAAS;QACxB,qBAAqB,EAAE,MAAM,EAAE,qBAAqB;QACpD,kBAAkB,EAAG,MAAc,EAAE,kBAAkB;KACjD,CAAC;IAET,MAAM,UAAU,GAAwB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACnD,OAAO,CACL,CAAC,QAAQ,CACP;UAAA,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CACvD;QAAA,EAAE,QAAQ,CAAC,CACZ,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAC5C;QAAA,CAAC,cAAc,CACb,IAAK,KAAa,CAAC,CACnB,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,UAAU,CAAC,EAEvB;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CACF,CAAC;AACF,iBAAiB,CAAC,WAAW,GAAG,UAAU,CAAC;AAE3C,MAAM,cAAc,GAAG,iBAEN,CAAC;AAElB,eAAe,cAAc,CAAC"}
+{"version":3,"file":"FlatList.js","sourceRoot":"","sources":["../../../../src/components/views/FlatList/FlatList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAqB,MAAM,OAAO,CAAC;AAEhE,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AA2BxE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,iBAAiB,GAAG,UAAU,CAClC,CACE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAoB,EAChD,GAAgB,EAChB,EAAE;IACF,MAAM,eAAe,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAS,CAAC;IACxD,MAAM,UAAU,GAAG;QACjB,KAAK,EAAE,MAAM,EAAE,SAAS;QACxB,qBAAqB,EAAE,MAAM,EAAE,qBAAqB;QACpD,kBAAkB,EAAG,MAAc,EAAE,kBAAkB;KACjD,CAAC;IAET,MAAM,UAAU,GAAwB,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;QACnD,OAAO,CACL,CAAC,QAAQ,CACP;UAAA,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,aAAa,CACvD;QAAA,EAAE,QAAQ,CAAC,CACZ,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CACL,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAC5C;QAAA,CAAC,cAAc,CACb,IAAK,KAAa,CAAC,CACnB,UAAU,CAAC,CAAC,UAAU,CAAC,CACvB,MAAM,CAAC,CAAC,UAAU,CAAC,EAEvB;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CACF,CAAC;AACF,iBAAiB,CAAC,WAAW,GAAG,UAAU,CAAC;AAE3C,MAAM,cAAc,GAAG,iBAEN,CAAC;AAElB,eAAe,cAAc,CAAC"}

package/dist/components/views/FlatList/schematics.d.ts

@@ -1,6 +1,26 @@
 import { RegisteredComponent } from '@mapples/types';
+/**
+ * Schematic configuration for the FlatList component.
+ *
+ * @public
+ */
 export declare const FlatListSchematic: RegisteredComponent;
+/**
+ * Schematic configuration for a two-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export declare const GridTwoColumnsSchematic: RegisteredComponent;
+/**
+ * Schematic configuration for a three-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export declare const GridThreeColumnsSchematic: RegisteredComponent;
+/**
+ * Schematic configuration for a four-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export declare const GridFourColumnsSchematic: RegisteredComponent;
 //# sourceMappingURL=schematics.d.ts.map

package/dist/components/views/FlatList/schematics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/FlatList/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,eAAO,MAAM,iBAAiB,EAAE,mBAG/B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,mBAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,mBAGvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAGtC,CAAC"}
+{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/FlatList/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAG/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,mBAGrC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,mBAGvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,mBAGtC,CAAC"}

package/dist/components/views/FlatList/schematics.js

@@ -1,16 +1,36 @@
 import FlatList from './FlatList';
+/**
+ * Schematic configuration for the FlatList component.
+ *
+ * @public
+ */
 export const FlatListSchematic = {
     type: 'FlatList',
     Component: FlatList,
 };
+/**
+ * Schematic configuration for a two-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export const GridTwoColumnsSchematic = {
     ...FlatListSchematic,
     type: 'GridTwoColumns',
 };
+/**
+ * Schematic configuration for a three-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export const GridThreeColumnsSchematic = {
     ...FlatListSchematic,
     type: 'GridThreeColumns',
 };
+/**
+ * Schematic configuration for a four-column grid layout backed by FlatList.
+ *
+ * @public
+ */
 export const GridFourColumnsSchematic = {
     ...FlatListSchematic,
     type: 'GridFourColumns',

package/dist/components/views/FlatList/schematics.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/FlatList/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,QAA0B;CACtC,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAwB;IAC1D,GAAG,iBAAiB;IACpB,IAAI,EAAE,gBAAgB;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,GAAG,iBAAiB;IACpB,IAAI,EAAE,kBAAkB;CACzB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,GAAG,iBAAiB;IACpB,IAAI,EAAE,iBAAiB;CACxB,CAAC"}
+{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/FlatList/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAwB;IACpD,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,QAA0B;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAwB;IAC1D,GAAG,iBAAiB;IACpB,IAAI,EAAE,gBAAgB;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAwB;IAC5D,GAAG,iBAAiB;IACpB,IAAI,EAAE,kBAAkB;CACzB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IAC3D,GAAG,iBAAiB;IACpB,IAAI,EAAE,iBAAiB;CACxB,CAAC"}

package/dist/components/views/GradientBackground/GradientBackground.d.ts

@@ -0,0 +1,52 @@
+import { PropsWithChildren } from 'react';
+import { WithStyledProps } from '@mapples/style';
+import type { LinearGradient } from '@mapples/types';
+import { ViewProps as RNViewProps } from 'react-native';
+/**
+ * Props for the GradientBackground component.
+ *
+ * @public
+ */
+export type GradientBackgroundProps = PropsWithChildren<WithStyledProps<RNViewProps> & {
+    /** The linear gradient painted behind the container's children. */
+    gradient?: LinearGradient;
+}>;
+/**
+ * A container view with a linear-gradient background.
+ *
+ * Mirrors `ImageBackgroundView`: it `forwardRef`s to a native `View` (via
+ * `StyledView`) so the canvas can measure it (`measureInWindow`) and make it
+ * selectable, paints the gradient as a full-bleed layer beneath its children,
+ * and is sized by its own `styled.style`. Falls back to the solid
+ * `backgroundColor` when no gradient is present or unrenderable.
+ *
+ * @example
+ * ```tsx
+ * <GradientBackground
+ *   gradient={{
+ *     type: 'linear',
+ *     stops: [
+ *       { color: '#FF5C35', position: 0 },
+ *       { color: '#FFC53D', position: 1 },
+ *     ],
+ *     start: { x: 0, y: 0 },
+ *     end: { x: 1, y: 1 },
+ *   }}
+ *   styled={{ style: { width: 150, height: 150, overflow: 'hidden' } }}
+ * >
+ *   <Text text="On gradient" />
+ * </GradientBackground>
+ * ```
+ *
+ * @public
+ */
+declare const GradientBackground: import("react").ForwardRefExoticComponent<{
+    styled?: import("@mapples/style").StyledProps<Partial<RNViewProps>> | undefined;
+} & RNViewProps & {
+    /** The linear gradient painted behind the container's children. */
+    gradient?: LinearGradient;
+} & {
+    children?: import("react").ReactNode | undefined;
+} & import("react").RefAttributes<unknown>>;
+export default GradientBackground;
+//# sourceMappingURL=GradientBackground.d.ts.map

package/dist/components/views/GradientBackground/GradientBackground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientBackground.d.ts","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/GradientBackground.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAc,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAIxD;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CACrD,eAAe,CAAC,WAAW,CAAC,GAAG;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,QAAA,MAAM,kBAAkB;;;IAlCpB,mEAAmE;eACxD,cAAc;;;2CA0C5B,CAAC;AAGF,eAAe,kBAAkB,CAAC"}

package/dist/components/views/GradientBackground/GradientBackground.js

@@ -0,0 +1,41 @@
+import { forwardRef } from 'react';
+import { StyledView } from '@mapples/style';
+import GradientLayer from './GradientLayer';
+/**
+ * A container view with a linear-gradient background.
+ *
+ * Mirrors `ImageBackgroundView`: it `forwardRef`s to a native `View` (via
+ * `StyledView`) so the canvas can measure it (`measureInWindow`) and make it
+ * selectable, paints the gradient as a full-bleed layer beneath its children,
+ * and is sized by its own `styled.style`. Falls back to the solid
+ * `backgroundColor` when no gradient is present or unrenderable.
+ *
+ * @example
+ * ```tsx
+ * <GradientBackground
+ *   gradient={{
+ *     type: 'linear',
+ *     stops: [
+ *       { color: '#FF5C35', position: 0 },
+ *       { color: '#FFC53D', position: 1 },
+ *     ],
+ *     start: { x: 0, y: 0 },
+ *     end: { x: 1, y: 1 },
+ *   }}
+ *   styled={{ style: { width: 150, height: 150, overflow: 'hidden' } }}
+ * >
+ *   <Text text="On gradient" />
+ * </GradientBackground>
+ * ```
+ *
+ * @public
+ */
+const GradientBackground = forwardRef(({ styled, children, gradient, ...props }, ref) => {
+    return (<StyledView ref={ref} styled={{ ...styled }} {...props}>
+        <GradientLayer gradient={gradient}/>
+        {children}
+      </StyledView>);
+});
+GradientBackground.displayName = 'GradientBackground';
+export default GradientBackground;
+//# sourceMappingURL=GradientBackground.js.map

package/dist/components/views/GradientBackground/GradientBackground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientBackground.js","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/GradientBackground.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAmB,MAAM,gBAAgB,CAAC;AAI7D,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAc5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,kBAAkB,GAAG,UAAU,CACnC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,EAA2B,EAAE,GAAG,EAAE,EAAE;IACzE,OAAO,CACL,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CACrD;QAAA,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAClC;QAAA,CAAC,QAAQ,CACX;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CACF,CAAC;AACF,kBAAkB,CAAC,WAAW,GAAG,oBAAoB,CAAC;AAEtD,eAAe,kBAAkB,CAAC"}

package/dist/components/views/GradientBackground/GradientLayer.d.ts

@@ -0,0 +1,39 @@
+import type { LinearGradient as LinearGradientData } from '@mapples/types';
+/**
+ * Props for {@link GradientLayer}.
+ *
+ * @public
+ */
+export interface GradientLayerProps {
+    /** The gradient payload from a node's `props.gradient`. */
+    gradient?: LinearGradientData;
+    /**
+     * Corner radius to clip the gradient layer to, matching the host container's
+     * `borderRadius`. Optional — when omitted, the host must set
+     * `overflow: 'hidden'` for the gradient to respect rounded corners.
+     */
+    borderRadius?: number;
+}
+/**
+ * Renders a linear gradient as an absolutely-positioned fill layer that a
+ * container paints behind its children. This is an **internal layer**, not a
+ * standalone canvas component — it has no ref and no intrinsic size. Containers
+ * (`View`, `GradientBackground`) mount it as their first child.
+ *
+ * React Native has no native gradient style, so a gradient travels as data on
+ * `props.gradient` (see `@mapples/types`' `LinearGradient`) and is painted here.
+ * The layer is `pointerEvents="none"` so it never intercepts touches.
+ *
+ * Degrades to `null` (the container keeps its solid `backgroundColor`) when:
+ * - no gradient is supplied,
+ * - `expo-linear-gradient` isn't installed,
+ * - the gradient has fewer than two stops (RN requires ≥2 colors).
+ *
+ * @public
+ */
+declare const GradientLayer: {
+    ({ gradient, borderRadius }: GradientLayerProps): import("react").JSX.Element | null;
+    displayName: string;
+};
+export default GradientLayer;
+//# sourceMappingURL=GradientLayer.d.ts.map

package/dist/components/views/GradientBackground/GradientLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientLayer.d.ts","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/GradientLayer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAgC3E;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,QAAA,MAAM,aAAa;iCAAgC,kBAAkB;;CA0BpE,CAAC;AAGF,eAAe,aAAa,CAAC"}

package/dist/components/views/GradientBackground/GradientLayer.js

@@ -0,0 +1,51 @@
+import { StyleSheet } from 'react-native';
+/**
+ * `expo-linear-gradient` is an **optional peer dependency** of `@mapples/ui`:
+ * apps that never render a gradient shouldn't have to install a native module.
+ * It's resolved lazily so the package builds and runs without it — when it's
+ * absent (or a node carries no gradient) this component renders nothing and the
+ * container falls back to its solid `backgroundColor`.
+ */
+let LinearGradient = null;
+try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    LinearGradient = require('expo-linear-gradient').LinearGradient;
+}
+catch {
+    LinearGradient = null;
+}
+/**
+ * Renders a linear gradient as an absolutely-positioned fill layer that a
+ * container paints behind its children. This is an **internal layer**, not a
+ * standalone canvas component — it has no ref and no intrinsic size. Containers
+ * (`View`, `GradientBackground`) mount it as their first child.
+ *
+ * React Native has no native gradient style, so a gradient travels as data on
+ * `props.gradient` (see `@mapples/types`' `LinearGradient`) and is painted here.
+ * The layer is `pointerEvents="none"` so it never intercepts touches.
+ *
+ * Degrades to `null` (the container keeps its solid `backgroundColor`) when:
+ * - no gradient is supplied,
+ * - `expo-linear-gradient` isn't installed,
+ * - the gradient has fewer than two stops (RN requires ≥2 colors).
+ *
+ * @public
+ */
+const GradientLayer = ({ gradient, borderRadius }) => {
+    if (!gradient || !LinearGradient || gradient.type !== 'linear') {
+        return null;
+    }
+    const colors = gradient.stops.map((stop) => stop.color);
+    if (colors.length < 2) {
+        return null;
+    }
+    const locations = gradient.stops.map((stop) => stop.position);
+    const style = [
+        StyleSheet.absoluteFill,
+        borderRadius ? { borderRadius } : null,
+    ];
+    return (<LinearGradient colors={colors} locations={locations} start={gradient.start} end={gradient.end} pointerEvents="none" style={style}/>);
+};
+GradientLayer.displayName = 'GradientLayer';
+export default GradientLayer;
+//# sourceMappingURL=GradientLayer.js.map

package/dist/components/views/GradientBackground/GradientLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientLayer.js","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/GradientLayer.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAa,UAAU,EAAa,MAAM,cAAc,CAAC;AAgBhE;;;;;;GAMG;AACH,IAAI,cAAc,GAAuD,IAAI,CAAC;AAC9E,IAAI,CAAC;IACH,iEAAiE;IACjE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,cAAc,CAAC;AAClE,CAAC;AAAC,MAAM,CAAC;IACP,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAkBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,aAAa,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAsB,EAAE,EAAE;IACvE,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAyB;QAClC,UAAU,CAAC,YAAY;QACvB,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI;KACvC,CAAC;IAEF,OAAO,CACL,CAAC,cAAc,CACb,MAAM,CAAC,CAAC,MAAM,CAAC,CACf,SAAS,CAAC,CAAC,SAAS,CAAC,CACrB,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CACtB,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAClB,aAAa,CAAC,MAAM,CACpB,KAAK,CAAC,CAAC,KAAK,CAAC,EACb,CACH,CAAC;AACJ,CAAC,CAAC;AACF,aAAa,CAAC,WAAW,GAAG,eAAe,CAAC;AAE5C,eAAe,aAAa,CAAC"}

package/dist/components/views/GradientBackground/index.d.ts

@@ -0,0 +1,7 @@
+import GradientBackground from './GradientBackground';
+export * from './GradientBackground';
+export { default as GradientLayer } from './GradientLayer';
+export * from './GradientLayer';
+export * from './schematics';
+export default GradientBackground;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/views/GradientBackground/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAE7B,eAAe,kBAAkB,CAAC"}

package/dist/components/views/GradientBackground/index.js

@@ -0,0 +1,7 @@
+import GradientBackground from './GradientBackground';
+export * from './GradientBackground';
+export { default as GradientLayer } from './GradientLayer';
+export * from './GradientLayer';
+export * from './schematics';
+export default GradientBackground;
+//# sourceMappingURL=index.js.map

package/dist/components/views/GradientBackground/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAE7B,eAAe,kBAAkB,CAAC"}

package/dist/components/views/GradientBackground/schematics.d.ts

@@ -0,0 +1,13 @@
+import { RegisteredComponent } from '@mapples/types';
+/**
+ * Schematic configuration for the GradientBackground component.
+ *
+ * A gradient-filled container that `forwardRef`s to a native `View`, so the
+ * canvas can measure it (`measureInWindow`) and make it selectable. It has
+ * children, sizing, and the normal view styling, plus a linear gradient painted
+ * behind its children.
+ *
+ * @public
+ */
+export declare const GradientBackgroundSchematic: RegisteredComponent;
+//# sourceMappingURL=schematics.d.ts.map

package/dist/components/views/GradientBackground/schematics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,EAAE,mBAGzC,CAAC"}

package/dist/components/views/GradientBackground/schematics.js

@@ -0,0 +1,16 @@
+import GradientBackground from './GradientBackground';
+/**
+ * Schematic configuration for the GradientBackground component.
+ *
+ * A gradient-filled container that `forwardRef`s to a native `View`, so the
+ * canvas can measure it (`measureInWindow`) and make it selectable. It has
+ * children, sizing, and the normal view styling, plus a linear gradient painted
+ * behind its children.
+ *
+ * @public
+ */
+export const GradientBackgroundSchematic = {
+    type: 'GradientBackground',
+    Component: GradientBackground,
+};
+//# sourceMappingURL=schematics.js.map

package/dist/components/views/GradientBackground/schematics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/GradientBackground/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAwB;IAC9D,IAAI,EAAE,oBAAoB;IAC1B,SAAS,EAAE,kBAAkB;CAC9B,CAAC"}

package/dist/components/views/ImageBackgroundView/ImageBackgroundView.d.ts

@@ -2,18 +2,58 @@ import { PropsWithChildren } from 'react';
 import { StyledProp, StyledProps, WithStyledProps } from '@mapples/style';
 import { ImageProps as ExpoImageProps } from 'expo-image';
 import { ImageStyle, ViewProps, ViewStyle } from 'react-native';
+/**
+ * Props for the ImageBackgroundView component.
+ *
+ * Combines Expo Image props with an extended `styled` object that controls the
+ * outer container, the background image, and the overlaid content view
+ * independently. Accepts an optional `dataSource` string that takes precedence
+ * over the standard `source` prop when provided.
+ *
+ * @public
+ */
 export type ImageProps = PropsWithChildren<Omit<WithStyledProps<ExpoImageProps>, 'styled'> & {
     styled?: StyledProps<ViewProps> & {
+        /** Style applied to the absolutely-positioned background image */
         styleImage?: StyledProp<ImageStyle>;
+        /** Style applied to the view rendered on top of the background image */
         styleContent?: StyledProp<ViewStyle>;
     };
+    /** URI string that overrides `source` when present */
     dataSource?: string;
 }>;
+/**
+ * A container view with an absolutely-positioned background image.
+ *
+ * `ImageBackgroundView` renders a full-bleed background image (via Expo Image)
+ * beneath an overlay content view. Children are placed inside the content
+ * view and are rendered on top of the image. Pass `dataSource` (a URI string)
+ * to override the standard `source` prop at runtime.
+ *
+ * @example
+ * ```tsx
+ * <ImageBackgroundView
+ *   dataSource="https://example.com/hero.jpg"
+ *   alt="Hero background"
+ *   styled={{
+ *     style: { flex: 1 },
+ *     styleContent: { padding: 24, justifyContent: 'flex-end' },
+ *   }}
+ * >
+ *   <Text text="Welcome" />
+ * </ImageBackgroundView>
+ * ```
+ *
+ * @public
+ */
 declare const ImageBackgroundView: import("react").ForwardRefExoticComponent<Omit<WithStyledProps<ExpoImageProps>, "styled"> & {
     styled?: StyledProps<ViewProps> & {
+        /** Style applied to the absolutely-positioned background image */
         styleImage?: StyledProp<ImageStyle>;
+        /** Style applied to the view rendered on top of the background image */
         styleContent?: StyledProp<ViewStyle>;
     };
+    /** URI string that overrides `source` when present */
     dataSource?: string;
 } & {
     children?: import("react").ReactNode | undefined;

package/dist/components/views/ImageBackgroundView/ImageBackgroundView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageBackgroundView.d.ts","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/ImageBackgroundView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAEL,UAAU,EACV,WAAW,EAGX,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAsB,UAAU,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,iBAAiB,CACxC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,GAAG;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG;QAChC,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACtC,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CACF,CAAC;AAIF,QAAA,MAAM,mBAAmB;aAVZ,WAAW,CAAC,SAAS,CAAC,GAAG;QAChC,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACtC;iBACY,MAAM;;;2CAwBtB,CAAC;AAcF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"ImageBackgroundView.d.ts","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/ImageBackgroundView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAEL,UAAU,EACV,WAAW,EAGX,eAAe,EAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAsB,UAAU,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CACxC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,GAAG;IAChD,MAAM,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG;QAChC,kEAAkE;QAClE,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,wEAAwE;QACxE,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACtC,CAAC;IACF,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CACF,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAA,MAAM,mBAAmB;aArCZ,WAAW,CAAC,SAAS,CAAC,GAAG;QAChC,kEAAkE;QAClE,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,wEAAwE;QACxE,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACtC;IACD,sDAAsD;iBACzC,MAAM;;;2CAgDtB,CAAC;AAcF,eAAe,mBAAmB,CAAC"}

package/dist/components/views/ImageBackgroundView/ImageBackgroundView.js

@@ -2,6 +2,30 @@ import { forwardRef } from 'react';
 import { styled, StyledView, Styler, } from '@mapples/style';
 import { Image as ExpoImage } from 'expo-image';
 const StyledExpoImage = styled(ExpoImage);
+/**
+ * A container view with an absolutely-positioned background image.
+ *
+ * `ImageBackgroundView` renders a full-bleed background image (via Expo Image)
+ * beneath an overlay content view. Children are placed inside the content
+ * view and are rendered on top of the image. Pass `dataSource` (a URI string)
+ * to override the standard `source` prop at runtime.
+ *
+ * @example
+ * ```tsx
+ * <ImageBackgroundView
+ *   dataSource="https://example.com/hero.jpg"
+ *   alt="Hero background"
+ *   styled={{
+ *     style: { flex: 1 },
+ *     styleContent: { padding: 24, justifyContent: 'flex-end' },
+ *   }}
+ * >
+ *   <Text text="Welcome" />
+ * </ImageBackgroundView>
+ * ```
+ *
+ * @public
+ */
 const ImageBackgroundView = forwardRef(({ styled, source, alt, children, dataSource, ...props }, ref) => {
     const { styleImage, styleContent, ...styledProps } = styled || {};
     return (<StyledView ref={ref} styled={styledProps} {...props}>

package/dist/components/views/ImageBackgroundView/ImageBackgroundView.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImageBackgroundView.js","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/ImageBackgroundView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEtD,OAAO,EACL,MAAM,EAGN,UAAU,EACV,MAAM,GAEP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAgC,MAAM,YAAY,CAAC;AAa9E,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAE1C,MAAM,mBAAmB,GAAG,UAAU,CACpC,CACE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,EAAc,EACnE,GAAG,EACH,EAAE;IACF,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;IAElE,OAAO,CACL,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,CACnD;QAAA,CAAC,eAAe,CACd,MAAM,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,CAC7B,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,EAE7D;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACrE;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CACF,CAAC;AACF,mBAAmB,CAAC,WAAW,GAAG,qBAAqB,CAAC;AACxD,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE;QACL,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;KACf;CACF,CAAC,CAAC;AAEH,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"ImageBackgroundView.js","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/ImageBackgroundView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEtD,OAAO,EACL,MAAM,EAGN,UAAU,EACV,MAAM,GAEP,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,IAAI,SAAS,EAAgC,MAAM,YAAY,CAAC;AA0B9E,MAAM,eAAe,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,mBAAmB,GAAG,UAAU,CACpC,CACE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,KAAK,EAAc,EACnE,GAAG,EACH,EAAE;IACF,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;IAElE,OAAO,CACL,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,CACnD;QAAA,CAAC,eAAe,CACd,MAAM,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,CAC7B,GAAG,CAAC,CAAC,GAAG,CAAC,CACT,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC,EAE7D;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACrE;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CACF,CAAC;AACF,mBAAmB,CAAC,WAAW,GAAG,qBAAqB,CAAC;AACxD,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE;QACL,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,MAAM;KACf;CACF,CAAC,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/dist/components/views/ImageBackgroundView/schematics.d.ts

@@ -1,3 +1,8 @@
 import { RegisteredComponent } from '@mapples/types';
+/**
+ * Schematic configuration for the ImageBackgroundView component.
+ *
+ * @public
+ */
 export declare const ImageBackgroundViewSchematics: RegisteredComponent;
 //# sourceMappingURL=schematics.d.ts.map

package/dist/components/views/ImageBackgroundView/schematics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC"}
+{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,EAAE,mBAG3C,CAAC"}

package/dist/components/views/ImageBackgroundView/schematics.js

@@ -1,4 +1,9 @@
 import ImageBackgroundView from './ImageBackgroundView';
+/**
+ * Schematic configuration for the ImageBackgroundView component.
+ *
+ * @public
+ */
 export const ImageBackgroundViewSchematics = {
     type: 'ImageBackgroundView',
     Component: ImageBackgroundView,

package/dist/components/views/ImageBackgroundView/schematics.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}
+{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/ImageBackgroundView/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,mBAAmB,MAAM,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAwB;IAChE,IAAI,EAAE,qBAAqB;IAC3B,SAAS,EAAE,mBAAmB;CAC/B,CAAC"}

package/dist/components/views/SafeAreaView/SafeAreaView.d.ts

@@ -1,7 +1,36 @@
 import { PropsWithChildren } from 'react';
 import { WithStyledProps } from '@mapples/style';
 import { SafeAreaViewProps as RNSafeAreaViewProps } from 'react-native-safe-area-context';
+/**
+ * Props for the SafeAreaView component.
+ *
+ * @public
+ */
 export type SafeAreaViewProps = PropsWithChildren<WithStyledProps<RNSafeAreaViewProps>>;
+/**
+ * A customizable safe-area view component with built-in styling support.
+ *
+ * `SafeAreaView` wraps `react-native-safe-area-context`'s `SafeAreaView` and
+ * adds styling capabilities through the `@mapples/style` system. It ensures
+ * content is rendered within the device's safe-area insets (notch, home
+ * indicator, status bar, etc.).
+ *
+ * @example
+ * ```tsx
+ * <SafeAreaView
+ *   styled={{
+ *     style: {
+ *       flex: 1,
+ *       backgroundColor: 'white',
+ *     },
+ *   }}
+ * >
+ *   <Text text="Safe content" />
+ * </SafeAreaView>
+ * ```
+ *
+ * @public
+ */
 declare const SafeAreaView: import("react").ForwardRefExoticComponent<{
     styled?: import("@mapples/style").StyledProps<Partial<import("react-native-safe-area-context").NativeSafeAreaViewProps>> | undefined;
 } & import("react-native-safe-area-context").NativeSafeAreaViewProps & {

package/dist/components/views/SafeAreaView/SafeAreaView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SafeAreaView.d.ts","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/SafeAreaView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1F,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAC/C,eAAe,CAAC,mBAAmB,CAAC,CACrC,CAAC;AAEF,QAAA,MAAM,YAAY;;;;2CAQjB,CAAC;AAGF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SafeAreaView.d.ts","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/SafeAreaView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAc,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAsB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,iBAAiB,IAAI,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1F;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAC/C,eAAe,CAAC,mBAAmB,CAAC,CACrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAA,MAAM,YAAY;;;;2CAQjB,CAAC;AAGF,eAAe,YAAY,CAAC"}

package/dist/components/views/SafeAreaView/SafeAreaView.js

@@ -1,5 +1,29 @@
 import { forwardRef } from 'react';
 import { StyledSafeAreaView } from '@mapples/style';
+/**
+ * A customizable safe-area view component with built-in styling support.
+ *
+ * `SafeAreaView` wraps `react-native-safe-area-context`'s `SafeAreaView` and
+ * adds styling capabilities through the `@mapples/style` system. It ensures
+ * content is rendered within the device's safe-area insets (notch, home
+ * indicator, status bar, etc.).
+ *
+ * @example
+ * ```tsx
+ * <SafeAreaView
+ *   styled={{
+ *     style: {
+ *       flex: 1,
+ *       backgroundColor: 'white',
+ *     },
+ *   }}
+ * >
+ *   <Text text="Safe content" />
+ * </SafeAreaView>
+ * ```
+ *
+ * @public
+ */
 const SafeAreaView = forwardRef(({ styled, children, ...props }, ref) => {
     return (<StyledSafeAreaView ref={ref} styled={{ ...styled }} {...props}>
         {children}

package/dist/components/views/SafeAreaView/SafeAreaView.js.map

@@ -1 +1 @@
-{"version":3,"file":"SafeAreaView.js","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/SafeAreaView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,gBAAgB,CAAC;AAOrE,MAAM,YAAY,GAAG,UAAU,CAC7B,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAqB,EAAE,GAAG,EAAE,EAAE;IACzD,OAAO,CACL,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAC7D;QAAA,CAAC,QAAQ,CACX;MAAA,EAAE,kBAAkB,CAAC,CACtB,CAAC;AACJ,CAAC,CACF,CAAC;AACF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC;AAE1C,eAAe,YAAY,CAAC"}
+{"version":3,"file":"SafeAreaView.js","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/SafeAreaView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAqB,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,gBAAgB,CAAC;AAYrE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,YAAY,GAAG,UAAU,CAC7B,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAqB,EAAE,GAAG,EAAE,EAAE;IACzD,OAAO,CACL,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAC7D;QAAA,CAAC,QAAQ,CACX;MAAA,EAAE,kBAAkB,CAAC,CACtB,CAAC;AACJ,CAAC,CACF,CAAC;AACF,YAAY,CAAC,WAAW,GAAG,cAAc,CAAC;AAE1C,eAAe,YAAY,CAAC"}

package/dist/components/views/SafeAreaView/schematics.d.ts

@@ -1,3 +1,8 @@
 import { RegisteredComponent } from '@mapples/types';
+/**
+ * Schematic configuration for the SafeAreaView component.
+ *
+ * @public
+ */
 export declare const SafeAreaViewSchematic: RegisteredComponent;
 //# sourceMappingURL=schematics.d.ts.map

package/dist/components/views/SafeAreaView/schematics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,eAAO,MAAM,qBAAqB,EAAE,mBAGnC,CAAC"}
+{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,mBAGnC,CAAC"}

package/dist/components/views/SafeAreaView/schematics.js

@@ -1,4 +1,9 @@
 import SafeAreaView from './SafeAreaView';
+/**
+ * Schematic configuration for the SafeAreaView component.
+ *
+ * @public
+ */
 export const SafeAreaViewSchematic = {
     type: 'SafeAreaView',
     Component: SafeAreaView,

package/dist/components/views/SafeAreaView/schematics.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,YAAY;CACxB,CAAC"}
+{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../../../../src/components/views/SafeAreaView/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAwB;IACxD,IAAI,EAAE,cAAc;IACpB,SAAS,EAAE,YAAY;CACxB,CAAC"}