@mapples/components 1.0.1 → 1.1.1

package/README.md

@@ -1,82 +1 @@
 # @mapples/components
-
-Placeholder package for app-specific component registration in the Mapples Open Kit. Use this package to register custom components and schematics that will be available to the render system and visual editor.
-
-## Features
-
-- **Component registry** – Export a `Components` object compatible with `@mapples/render` and `RegisteredComponents` from `@mapples/types`
-- **Schematics** – Attach component schematics (type, groupId, label, Icon, initialProps, styleKeys, props, actionProps) for visual editor integration
-- **TypeScript** – Aligns with `@mapples/types` and `@mapples/ui` patterns
-
-## Installation
-
-```bash
-npm install @mapples/components
-# or
-yarn add @mapples/components
-```
-
-## Usage
-
-The package currently exports an empty **`Components`** registry and re-exports from **schematics**. Applications can:
-
-1. **Extend in-app** – Import `@mapples/ui` (or other) components and merge with custom components, then pass the combined registry to `RenderProvider` (or use `MapplesApp` / `MapplesAppProvider` from `@mapples/app`, which use `@mapples/ui`’s `Components` by default).
-
-2. **Use this package as the app shell** – Add local component definitions and schematics in `src/schematics.ts` (and related files), then build and consume `Components` from `@mapples/components` in your app’s provider setup.
-
-### Example: custom component registration
-
-```tsx
-// In your app or in this package’s schematics
-import { RegisteredComponent } from '@mapples/types';
-import { MyWidget } from './MyWidget';
-import { MyWidgetIcon } from './MyWidgetIcon';
-
-const myWidgetSchematic: RegisteredComponent<MyWidgetProps> = {
-  type: 'MyWidget',
-  groupId: 'custom',
-  label: 'My Widget',
-  Component: MyWidget,
-  Icon: MyWidgetIcon,
-  initialProps: { title: '' },
-  styleKeys: [],
-  props: [],
-  actionProps: [],
-};
-
-// Merge with existing Components when providing to RenderProvider
-import { Components } from '@mapples/ui';
-const allComponents = { ...Components, MyWidget: myWidgetSchematic };
-```
-
-## API
-
-- **`Components`** – `Record<string, RegisteredComponent>` (currently `{}`). Populate via this package’s schematics or by merging in your app.
-- **Schematics** – Re-exported from `./schematics`; add your component definitions here for a single place to maintain the registry.
-
-## Dependencies
-
-- **@mapples/types** – For `RegisteredComponent`, `StyleKey`, `PropsFormField`, etc.
-- **react** / **react-native** – For component implementations
-- **react-native-svg** – For palette/icons when using SVG icons in schematics
-
-## Integration
-
-- **@mapples/app** – `MapplesApp` and `MapplesAppProvider` use `@mapples/ui`’s `Components` by default; replace or merge with `@mapples/components` if your app defines its components in this package.
-- **@mapples/render** – `RenderProvider` accepts a `components` prop; pass the registry you build from this package and/or `@mapples/ui`.
-
-## Development
-
-```bash
-npm run build
-npm run type-check
-npm run lint
-```
-
-## License
-
-MIT
-
-## Author
-
-Oleksandr Soloviov – [mapples.org](https://mapples.org/people/olek_soloviov)

package/dist/components/ImageCarousel/CarouselItem.d.ts

@@ -2,19 +2,59 @@ import { FC } from 'react';
 import { StyledProp } from '@mapples/style';
 import { ImageProps, ImageStyle } from 'expo-image';
 import { TextStyle, ViewStyle } from 'react-native';
+/** Controls how text is positioned relative to the image in a carousel item. */
 export type ImageCarouselMode = 'textOver' | 'textUnder';
+/** Props for a single item rendered inside {@link ImageCarousel}. */
 export interface ImageCarouselItemProps {
+    /** The image source passed to the underlying `StyledImage` or `StyledImageBackground`. */
     image?: any;
+    /** Primary text displayed over or under the image. */
     title?: string;
+    /** Secondary text displayed below the title. */
     subtitle?: string;
+    /** Layout mode: `'textOver'` renders text on top of the image; `'textUnder'` renders it beneath. */
     mode?: ImageCarouselMode;
+    /** Additional props forwarded to the underlying `expo-image` `Image` component. */
     imageProps?: ImageProps;
+    /** Styled prop applied to the outermost item container view. */
     styleItemContainer?: StyledProp<ViewStyle>;
+    /** Styled prop applied to the image. */
     styleImage?: StyledProp<ImageStyle>;
+    /** Styled prop applied to the text wrapper view. */
     styleTextContainer?: StyledProp<ViewStyle>;
+    /** Styled prop applied to the title `Typography` element. */
     styleTitle?: StyledProp<TextStyle>;
+    /** Styled prop applied to the subtitle `Typography` element. */
     styleSubtitle?: StyledProp<TextStyle>;
 }
+/**
+ * A single slide rendered inside an {@link ImageCarousel}.
+ *
+ * Depending on `mode`, text is either overlaid on top of the image (`'textOver'`,
+ * the default) or displayed in a separate view beneath it (`'textUnder'`).
+ *
+ * @param props - The component props.
+ * @param props.image - Image source for the slide.
+ * @param props.title - Primary heading text.
+ * @param props.subtitle - Secondary description text.
+ * @param props.mode - Layout mode controlling text placement.
+ * @param props.styleItemContainer - Styled prop for the outer container.
+ * @param props.styleImage - Styled prop for the image.
+ * @param props.styleTextContainer - Styled prop for the text wrapper.
+ * @param props.styleTitle - Styled prop for the title element.
+ * @param props.styleSubtitle - Styled prop for the subtitle element.
+ * @param props.imageProps - Extra props forwarded to the expo-image component.
+ *
+ * @example
+ * ```tsx
+ * <CarouselItem
+ *   image={require('./slide.jpg')}
+ *   title="Hello"
+ *   subtitle="World"
+ *   mode="textUnder"
+ * />
+ * ```
+ */
 declare const CarouselItem: FC<ImageCarouselItemProps>;
 export default CarouselItem;
 //# sourceMappingURL=CarouselItem.d.ts.map

package/dist/components/ImageCarousel/CarouselItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CarouselItem.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAGL,UAAU,EAGX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACvC;AAED,QAAA,MAAM,YAAY,EAAE,EAAE,CAAC,sBAAsB,CAwC5C,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CarouselItem.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAGL,UAAU,EAGX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEpD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzD,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,0FAA0F;IAC1F,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,wCAAwC;IACxC,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACpC,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAC3C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACnC,gEAAgE;IAChE,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,QAAA,MAAM,YAAY,EAAE,EAAE,CAAC,sBAAsB,CAwC5C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/ImageCarousel/CarouselItem.js

@@ -1,4 +1,32 @@
 import { StyledImage, StyledImageBackground, StyledView, Typography, } from '@mapples/style';
+/**
+ * A single slide rendered inside an {@link ImageCarousel}.
+ *
+ * Depending on `mode`, text is either overlaid on top of the image (`'textOver'`,
+ * the default) or displayed in a separate view beneath it (`'textUnder'`).
+ *
+ * @param props - The component props.
+ * @param props.image - Image source for the slide.
+ * @param props.title - Primary heading text.
+ * @param props.subtitle - Secondary description text.
+ * @param props.mode - Layout mode controlling text placement.
+ * @param props.styleItemContainer - Styled prop for the outer container.
+ * @param props.styleImage - Styled prop for the image.
+ * @param props.styleTextContainer - Styled prop for the text wrapper.
+ * @param props.styleTitle - Styled prop for the title element.
+ * @param props.styleSubtitle - Styled prop for the subtitle element.
+ * @param props.imageProps - Extra props forwarded to the expo-image component.
+ *
+ * @example
+ * ```tsx
+ * <CarouselItem
+ *   image={require('./slide.jpg')}
+ *   title="Hello"
+ *   subtitle="World"
+ *   mode="textUnder"
+ * />
+ * ```
+ */
 const CarouselItem = ({ image, title, subtitle, mode = 'textOver', styleItemContainer, styleImage, styleTextContainer, styleTitle, styleSubtitle, imageProps, }) => {
     if (mode === 'textUnder') {
         return (<StyledView styled={{ style: styleItemContainer }}>

package/dist/components/ImageCarousel/CarouselItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"CarouselItem.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItem.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,qBAAqB,EAErB,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AAmBxB,MAAM,YAAY,GAA+B,CAAC,EAChD,KAAK,EACL,KAAK,EACL,QAAQ,EACR,IAAI,GAAG,UAAU,EACjB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,GACX,EAAE,EAAE;IACH,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,CACL,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;QAAA,CAAC,WAAW,CACV,IAAI,UAAU,CAAC,CACf,MAAM,CAAC,CAAC,KAAK,CAAC,CACd,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAEhC;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;UAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAC9D;UAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACtE;QAAA,EAAE,UAAU,CACd;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;IACJ,CAAC;IAED,OAAO,CACL,CAAC,qBAAqB,CACpB,IAAI,UAAU,CAAC,CACf,MAAM,CAAC,CAAC,KAAK,CAAC,CACd,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAE9D;MAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAC9D;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACtE;MAAA,EAAE,UAAU,CACd;IAAA,EAAE,qBAAqB,CAAC,CACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CarouselItem.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItem.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,qBAAqB,EAErB,UAAU,EACV,UAAU,GACX,MAAM,gBAAgB,CAAC;AA+BxB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,YAAY,GAA+B,CAAC,EAChD,KAAK,EACL,KAAK,EACL,QAAQ,EACR,IAAI,GAAG,UAAU,EACjB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,UAAU,GACX,EAAE,EAAE;IACH,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,OAAO,CACL,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;QAAA,CAAC,WAAW,CACV,IAAI,UAAU,CAAC,CACf,MAAM,CAAC,CAAC,KAAK,CAAC,CACd,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAEhC;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;UAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAC9D;UAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACtE;QAAA,EAAE,UAAU,CACd;MAAA,EAAE,UAAU,CAAC,CACd,CAAC;IACJ,CAAC;IAED,OAAO,CACL,CAAC,qBAAqB,CACpB,IAAI,UAAU,CAAC,CACf,MAAM,CAAC,CAAC,KAAK,CAAC,CACd,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAE9D;MAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAChD;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAC9D;QAAA,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CACtE;MAAA,EAAE,UAAU,CACd;IAAA,EAAE,qBAAqB,CAAC,CACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/components/ImageCarousel/CarouselItemIndicator.d.ts

@@ -1,13 +1,37 @@
 import { FC } from 'react';
 import { StyledProp } from '@mapples/style';
 import { ViewStyle } from 'react-native';
+/** Props for the dot-based page indicator shown below an {@link ImageCarousel}. */
 interface CarouselItemIndicatorProps {
+    /** Total number of slides (dots) to render. */
     total: number;
+    /** Zero-based index of the currently visible slide. */
     activeIndex: number;
+    /** Styled prop applied to the row container that wraps all dots. */
     styleIndicatorContainer?: StyledProp<ViewStyle>;
+    /** Styled prop applied to every dot. */
     styleIndicator?: StyledProp<ViewStyle>;
+    /** Styled prop applied to the currently active dot (merged on top of `styleIndicator`). */
     styleIndicatorActive?: StyledProp<ViewStyle>;
 }
+/**
+ * Row of dot indicators that reflect the current slide position in an
+ * {@link ImageCarousel}.
+ *
+ * Renders `total` dots and highlights the one at `activeIndex`.
+ *
+ * @param props - The component props.
+ * @param props.total - Number of dots to render.
+ * @param props.activeIndex - Index of the active dot.
+ * @param props.styleIndicatorContainer - Styled prop for the container row.
+ * @param props.styleIndicator - Styled prop applied to every dot.
+ * @param props.styleIndicatorActive - Additional styled prop for the active dot.
+ *
+ * @example
+ * ```tsx
+ * <CarouselItemIndicator total={5} activeIndex={2} />
+ * ```
+ */
 declare const CarouselItemIndicator: FC<CarouselItemIndicatorProps>;
 export default CarouselItemIndicator;
 //# sourceMappingURL=CarouselItemIndicator.d.ts.map

package/dist/components/ImageCarousel/CarouselItemIndicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CarouselItemIndicator.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItemIndicator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,UAAU,0BAA0B;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAChD,cAAc,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CAC9C;AAED,QAAA,MAAM,qBAAqB,EAAE,EAAE,CAAC,0BAA0B,CAsBzD,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"CarouselItemIndicator.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItemIndicator.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAc,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,mFAAmF;AACnF,UAAU,0BAA0B;IAClC,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,uBAAuB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IAChD,wCAAwC;IACxC,cAAc,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACvC,2FAA2F;IAC3F,oBAAoB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,qBAAqB,EAAE,EAAE,CAAC,0BAA0B,CAsBzD,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/components/ImageCarousel/CarouselItemIndicator.js

@@ -1,4 +1,22 @@
 import { StyledView } from '@mapples/style';
+/**
+ * Row of dot indicators that reflect the current slide position in an
+ * {@link ImageCarousel}.
+ *
+ * Renders `total` dots and highlights the one at `activeIndex`.
+ *
+ * @param props - The component props.
+ * @param props.total - Number of dots to render.
+ * @param props.activeIndex - Index of the active dot.
+ * @param props.styleIndicatorContainer - Styled prop for the container row.
+ * @param props.styleIndicator - Styled prop applied to every dot.
+ * @param props.styleIndicatorActive - Additional styled prop for the active dot.
+ *
+ * @example
+ * ```tsx
+ * <CarouselItemIndicator total={5} activeIndex={2} />
+ * ```
+ */
 const CarouselItemIndicator = ({ total, activeIndex, styleIndicatorContainer, styleIndicator, styleIndicatorActive, }) => {
     return (<StyledView styled={{ style: styleIndicatorContainer }}>
       {Array.from({ length: total }).map((_, index) => (<StyledView key={index} styled={{

package/dist/components/ImageCarousel/CarouselItemIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"CarouselItemIndicator.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItemIndicator.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAWxD,MAAM,qBAAqB,GAAmC,CAAC,EAC7D,KAAK,EACL,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GACrB,EAAE,EAAE;IACH,OAAO,CACL,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CACrD;MAAA,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/C,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,KAAK,CAAC,CACX,MAAM,CAAC,CAAC;gBACN,KAAK,EAAE;oBACL,cAAc;oBACd,KAAK,KAAK,WAAW,IAAI,oBAAoB;iBAC9C;aACF,CAAC,EACF,CACH,CAAC,CACJ;IAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"CarouselItemIndicator.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/CarouselItemIndicator.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAiBxD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,qBAAqB,GAAmC,CAAC,EAC7D,KAAK,EACL,WAAW,EACX,uBAAuB,EACvB,cAAc,EACd,oBAAoB,GACrB,EAAE,EAAE;IACH,OAAO,CACL,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CACrD;MAAA,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/C,CAAC,UAAU,CACT,GAAG,CAAC,CAAC,KAAK,CAAC,CACX,MAAM,CAAC,CAAC;gBACN,KAAK,EAAE;oBACL,cAAc;oBACd,KAAK,KAAK,WAAW,IAAI,oBAAoB;iBAC9C;aACF,CAAC,EACF,CACH,CAAC,CACJ;IAAA,EAAE,UAAU,CAAC,CACd,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/components/ImageCarousel/index.d.ts

@@ -2,30 +2,93 @@ import { StyledProp } from '@mapples/style';
 import { ImageProps } from 'expo-image';
 import { ImageStyle, TextStyle, View, ViewStyle } from 'react-native';
 import { ImageCarouselMode } from './CarouselItem';
+/**
+ * Shape of a single data record accepted by {@link ImageCarousel}.
+ *
+ * Field names can be remapped via `keyMap` so any object shape is supported.
+ */
 export interface ImageCarouselDataItem {
+    /** Image source for the slide. */
     image?: any;
+    /** Primary heading text. */
     title?: string;
+    /** Secondary description text. */
     subtitle?: string;
+    /** Unique identifier used as the FlatList `key`. */
     id?: string | number;
 }
+/** Props for {@link ImageCarousel}. */
 export interface ImageCarouselProps<T extends ImageCarouselDataItem> {
+    /** Array of data items to render as slides. */
     data?: T[];
+    /** Controls text placement: `'textOver'` (default) or `'textUnder'`. */
     mode?: ImageCarouselMode;
+    /** Whether to render the dot page-indicator below the carousel. Defaults to `true`. */
     showIndicators?: boolean;
+    /**
+     * Maps the expected `ImageCarouselDataItem` field names to the actual keys on
+     * each `data` record, enabling arbitrary data shapes without transformation.
+     */
     keyMap?: Record<keyof ImageCarouselDataItem, string>;
+    /** Extra props forwarded to the underlying `expo-image` component in each slide. */
     imageProps?: ImageProps;
+    /** Styled props for every visual part of the carousel. */
     styled?: {
+        /** Styled prop for the outermost container view. */
         style?: StyledProp<ViewStyle>;
+        /** Styled prop for each indicator dot. */
         styleIndicator?: StyledProp<ViewStyle>;
+        /** Additional styled prop applied to the active indicator dot. */
         styleIndicatorActive?: StyledProp<ViewStyle>;
+        /** Styled prop for each slide's container view. */
         styleItemContainer?: StyledProp<ViewStyle>;
+        /** Styled prop for each slide's image. */
         styleImage?: StyledProp<ImageStyle>;
+        /** Styled prop for each slide's text wrapper view. */
         styleTextContainer?: StyledProp<ViewStyle>;
+        /** Styled prop for each slide's title element. */
         styleTitle?: StyledProp<TextStyle>;
+        /** Styled prop for each slide's subtitle element. */
         styleSubtitle?: StyledProp<TextStyle>;
+        /** Styled prop for the indicator row container. */
         styleIndicatorContainer?: StyledProp<ViewStyle>;
     };
 }
+/**
+ * Horizontally scrollable image carousel with optional dot page indicators.
+ *
+ * Accepts an array of data items and renders each one as a full-width slide
+ * via {@link CarouselItem}. The active slide is tracked automatically using
+ * `FlatList` viewability callbacks, and the {@link CarouselItemIndicator} is
+ * updated accordingly.
+ *
+ * Use `keyMap` to adapt objects whose field names differ from the defaults
+ * (`image`, `title`, `subtitle`, `id`).
+ *
+ * @param props - The component props.
+ * @param props.data - Array of slide data items.
+ * @param props.mode - Text placement mode for each slide.
+ * @param props.showIndicators - Whether to show dot indicators.
+ * @param props.keyMap - Field-name remapping for data items.
+ * @param props.imageProps - Extra props forwarded to the image in each slide.
+ * @param props.styled - Styled props for every visual layer.
+ * @param ref - Forwarded ref attached to the outermost `View`.
+ *
+ * @example
+ * ```tsx
+ * const slides = [
+ *   { image: require('./a.jpg'), title: 'Slide 1', subtitle: 'Description', id: '1' },
+ *   { image: require('./b.jpg'), title: 'Slide 2', subtitle: 'Description', id: '2' },
+ * ];
+ *
+ * <ImageCarousel
+ *   data={slides}
+ *   mode="textUnder"
+ *   showIndicators
+ *   styled={{ style: { height: 200 } }}
+ * />
+ * ```
+ */
 declare const ImageCarousel: import("react").ForwardRefExoticComponent<ImageCarouselProps<any> & import("react").RefAttributes<View>>;
 export default ImageCarousel;
 //# sourceMappingURL=index.d.ts.map

package/dist/components/ImageCarousel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkB,UAAU,EAAc,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EACL,UAAU,EAEV,SAAS,EACT,IAAI,EACJ,SAAS,EACV,MAAM,cAAc,CAAC;AAEtB,OAAqB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGjE,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AASD,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,qBAAqB;IACjE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACrD,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9B,cAAc,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACvC,oBAAoB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACnC,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACtC,uBAAuB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACjD,CAAC;CACH;AAED,QAAA,MAAM,aAAa,0GA0FlB,CAAC;AAGF,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkB,UAAU,EAAc,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EACL,UAAU,EAEV,SAAS,EACT,IAAI,EACJ,SAAS,EACV,MAAM,cAAc,CAAC;AAEtB,OAAqB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGjE;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AASD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,qBAAqB;IACjE,+CAA+C;IAC/C,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACX,wEAAwE;IACxE,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACrD,oFAAoF;IACpF,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,0DAA0D;IAC1D,MAAM,CAAC,EAAE;QACP,oDAAoD;QACpD,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9B,0CAA0C;QAC1C,cAAc,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACvC,kEAAkE;QAClE,oBAAoB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,mDAAmD;QACnD,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,0CAA0C;QAC1C,UAAU,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QACpC,sDAAsD;QACtD,kBAAkB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3C,kDAAkD;QAClD,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACnC,qDAAqD;QACrD,aAAa,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QACtC,mDAAmD;QACnD,uBAAuB,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;KACjD,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,QAAA,MAAM,aAAa,0GA0FlB,CAAC;AAGF,eAAe,aAAa,CAAC"}

package/dist/components/ImageCarousel/index.js

@@ -9,6 +9,41 @@ const defaultKeyMap = {
     subtitle: 'subtitle',
     id: 'id',
 };
+/**
+ * Horizontally scrollable image carousel with optional dot page indicators.
+ *
+ * Accepts an array of data items and renders each one as a full-width slide
+ * via {@link CarouselItem}. The active slide is tracked automatically using
+ * `FlatList` viewability callbacks, and the {@link CarouselItemIndicator} is
+ * updated accordingly.
+ *
+ * Use `keyMap` to adapt objects whose field names differ from the defaults
+ * (`image`, `title`, `subtitle`, `id`).
+ *
+ * @param props - The component props.
+ * @param props.data - Array of slide data items.
+ * @param props.mode - Text placement mode for each slide.
+ * @param props.showIndicators - Whether to show dot indicators.
+ * @param props.keyMap - Field-name remapping for data items.
+ * @param props.imageProps - Extra props forwarded to the image in each slide.
+ * @param props.styled - Styled props for every visual layer.
+ * @param ref - Forwarded ref attached to the outermost `View`.
+ *
+ * @example
+ * ```tsx
+ * const slides = [
+ *   { image: require('./a.jpg'), title: 'Slide 1', subtitle: 'Description', id: '1' },
+ *   { image: require('./b.jpg'), title: 'Slide 2', subtitle: 'Description', id: '2' },
+ * ];
+ *
+ * <ImageCarousel
+ *   data={slides}
+ *   mode="textUnder"
+ *   showIndicators
+ *   styled={{ style: { height: 200 } }}
+ * />
+ * ```
+ */
 const ImageCarousel = forwardRef(({ styled, keyMap = defaultKeyMap, data = [], mode = 'textOver', showIndicators = true, imageProps, }, ref) => {
     const [activeIndex, setActiveIndex] = useState(0);
     const viewabilityConfig = useRef({

package/dist/components/ImageCarousel/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/index.tsx"],"names":[],"mappings":"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"}

package/dist/components/ImageCarousel/schematic.d.ts

@@ -1,3 +1,9 @@
 import { RegisteredComponent } from '@mapples/types';
+/**
+ * Schematic registration entry for the {@link ImageCarousel} component.
+ *
+ * Registers `ImageCarousel` under the `'ImageCarousel'` type key so it can be
+ * resolved by the `@mapples/render` pipeline via the {@link Components} registry.
+ */
 export declare const ImageCarouselSchematic: RegisteredComponent;
 //# sourceMappingURL=schematic.d.ts.map

package/dist/components/ImageCarousel/schematic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematic.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/schematic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD,eAAO,MAAM,sBAAsB,EAAE,mBAGpC,CAAC"}
+{"version":3,"file":"schematic.d.ts","sourceRoot":"","sources":["../../../src/components/ImageCarousel/schematic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAGpC,CAAC"}

package/dist/components/ImageCarousel/schematic.js

@@ -1,4 +1,10 @@
 import ImageCarousel from './index';
+/**
+ * Schematic registration entry for the {@link ImageCarousel} component.
+ *
+ * Registers `ImageCarousel` under the `'ImageCarousel'` type key so it can be
+ * resolved by the `@mapples/render` pipeline via the {@link Components} registry.
+ */
 export const ImageCarouselSchematic = {
     type: 'ImageCarousel',
     Component: ImageCarousel,

package/dist/components/ImageCarousel/schematic.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematic.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/schematic.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,MAAM,SAAS,CAAC;AAEpC,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,aAAoB;CAChC,CAAC"}
+{"version":3,"file":"schematic.js","sourceRoot":"","sources":["../../../src/components/ImageCarousel/schematic.ts"],"names":[],"mappings":"AAEA,OAAO,aAAa,MAAM,SAAS,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAwB;IACzD,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,aAAoB;CAChC,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,3 @@
-/**
- * @packageDocumentation
- * @module @mapples/components
- *
- * Placeholder package for app-specific component registration in the Mapples Open Kit.
- * Export a Components registry and schematics for use with @mapples/render and visual editors.
- */
 export * from './schematics';
 export { default as ImageCarousel } from './components/ImageCarousel';
 export * from './components/ImageCarousel/schematic';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,sCAAsC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,sCAAsC,CAAC"}

package/dist/index.js

@@ -1,10 +1,3 @@
-/**
- * @packageDocumentation
- * @module @mapples/components
- *
- * Placeholder package for app-specific component registration in the Mapples Open Kit.
- * Export a Components registry and schematics for use with @mapples/render and visual editors.
- */
 export * from './schematics';
 export { default as ImageCarousel } from './components/ImageCarousel';
 export * from './components/ImageCarousel/schematic';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,sCAAsC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACtE,cAAc,sCAAsC,CAAC"}

package/dist/schematics.d.ts

@@ -1,3 +1,18 @@
 import { RegisteredComponents } from '@mapples/types';
+/**
+ * Registry of all `@mapples/components` components, keyed by their schematic
+ * `type` string.
+ *
+ * Pass this object to the `@mapples/render` pipeline so it can resolve
+ * component types at runtime.
+ *
+ * @example
+ * ```tsx
+ * import { Components } from '@mapples/components';
+ * import { RenderEngine } from '@mapples/render';
+ *
+ * <RenderEngine components={Components} tree={tree} />
+ * ```
+ */
 export declare const Components: RegisteredComponents;
 //# sourceMappingURL=schematics.d.ts.map

package/dist/schematics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../src/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAItD,eAAO,MAAM,UAAU,EAAE,oBAExB,CAAC"}
+{"version":3,"file":"schematics.d.ts","sourceRoot":"","sources":["../src/schematics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAItD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,EAAE,oBAExB,CAAC"}

package/dist/schematics.js

@@ -1,4 +1,19 @@
 import { ImageCarouselSchematic } from './components/ImageCarousel/schematic';
+/**
+ * Registry of all `@mapples/components` components, keyed by their schematic
+ * `type` string.
+ *
+ * Pass this object to the `@mapples/render` pipeline so it can resolve
+ * component types at runtime.
+ *
+ * @example
+ * ```tsx
+ * import { Components } from '@mapples/components';
+ * import { RenderEngine } from '@mapples/render';
+ *
+ * <RenderEngine components={Components} tree={tree} />
+ * ```
+ */
 export const Components = {
     [ImageCarouselSchematic.type]: ImageCarouselSchematic,
 };

package/dist/schematics.js.map

@@ -1 +1 @@
-{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../src/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,sBAAsB;CACtD,CAAC"}
+{"version":3,"file":"schematics.js","sourceRoot":"","sources":["../src/schematics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,sBAAsB;CACtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapples/components",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -26,7 +26,7 @@
   },
   "devDependencies": {
     "@types/react": ">=18.0.0 <20.0.0",
-    "typescript": "~5.9.2"
+    "typescript": "~6.0.3"
   },
   "files": [
     "dist",