@marvalt/shcoder 0.1.0

package/README.md

@@ -0,0 +1,64 @@
+# @marvalt/shcoder
+
+Shortcode renderer components for DigiValt Custom Post Types (Members, Testimonials, Projects, etc.)
+
+## Overview
+
+This package provides React components and hooks for rendering WordPress shortcodes in headless React applications. It works in conjunction with the `wp-custom-api-endpoints` WordPress plugin, which auto-discovers CPTs and registers shortcodes dynamically.
+
+## Installation
+
+```bash
+npm install @marvalt/shcoder
+```
+
+## Usage
+
+### Components
+
+#### Member Components
+
+- **MemberCard** - Displays a single member profile
+- **MemberCardsGrid** - Displays multiple members in a grid layout
+- **MemberSlideshow** - Displays members in a rotating slideshow
+
+#### Testimonial Components
+
+- **TestimonialCard** - Displays a single testimonial
+- **TestimonialCardsGrid** - Displays multiple testimonials in a grid layout
+- **TestimonialSlideshow** - Displays testimonials in a rotating slideshow
+
+### Hooks
+
+- **useMembers** - Fetch members based on shortcode attributes
+- **useMember** - Fetch a single member by ID
+- **useTestimonials** - Fetch testimonials based on shortcode attributes
+- **useTestimonial** - Fetch a single testimonial by ID
+
+## WordPress Shortcodes
+
+The following shortcodes are automatically registered by the `wp-custom-api-endpoints` plugin:
+
+### Member Shortcodes
+
+- `[member_card id="123"]` - Single member profile
+- `[member_cards tax="leadership" cols="3" image="true"]` - Member grid
+- `[member_slideshow category="leadership" interval="5000" show_bio="true"]` - Member slideshow
+
+### Testimonial Shortcodes
+
+- `[testimonial_card id="123"]` - Single testimonial
+- `[testimonial_cards category="external" cols="2"]` - Testimonial grid
+- `[testimonial_slideshow category="external" interval="5000"]` - Testimonial slideshow
+
+## Configuration
+
+Set the WordPress API URL in your environment:
+
+```env
+VITE_WORDPRESS_API_URL=https://your-wordpress-site.com/wp-json
+```
+
+## License
+
+GPL-3.0-or-later

package/dist/components/MemberCard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/member';
+export interface MemberCardProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * MemberCard component - displays a single member profile
+ * Usage: [member_card id="123"]
+ */
+export declare const MemberCard: React.FC<MemberCardProps>;
+//# sourceMappingURL=MemberCard.d.ts.map

package/dist/components/MemberCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemberCard.d.ts","sourceRoot":"","sources":["../../src/components/MemberCard.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAyChD,CAAC"}

package/dist/components/MemberCardsGrid.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/member';
+export interface MemberCardsGridProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * MemberCardsGrid component - displays multiple members in a grid
+ * Usage: [member_cards tax="leadership" cols="3" image="true"]
+ */
+export declare const MemberCardsGrid: React.FC<MemberCardsGridProps>;
+//# sourceMappingURL=MemberCardsGrid.d.ts.map

package/dist/components/MemberCardsGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemberCardsGrid.d.ts","sourceRoot":"","sources":["../../src/components/MemberCardsGrid.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAyF1D,CAAC"}

package/dist/components/MemberSlideshow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/member';
+export interface MemberSlideshowProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * MemberSlideshow component - displays members in a rotating slideshow
+ * Usage: [member_slideshow category="leadership" interval="5000" show_bio="true"]
+ */
+export declare const MemberSlideshow: React.FC<MemberSlideshowProps>;
+//# sourceMappingURL=MemberSlideshow.d.ts.map

package/dist/components/MemberSlideshow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemberSlideshow.d.ts","sourceRoot":"","sources":["../../src/components/MemberSlideshow.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAgH1D,CAAC"}

package/dist/components/TestimonialCard.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/testimonial';
+export interface TestimonialCardProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * TestimonialCard component - displays a single testimonial
+ * Usage: [testimonial_card id="123"]
+ */
+export declare const TestimonialCard: React.FC<TestimonialCardProps>;
+//# sourceMappingURL=TestimonialCard.d.ts.map

package/dist/components/TestimonialCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestimonialCard.d.ts","sourceRoot":"","sources":["../../src/components/TestimonialCard.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAqC1D,CAAC"}

package/dist/components/TestimonialCardsGrid.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/testimonial';
+export interface TestimonialCardsGridProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * TestimonialCardsGrid component - displays multiple testimonials in a grid
+ * Usage: [testimonial_cards category="external" cols="2"]
+ */
+export declare const TestimonialCardsGrid: React.FC<TestimonialCardsGridProps>;
+//# sourceMappingURL=TestimonialCardsGrid.d.ts.map

package/dist/components/TestimonialCardsGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestimonialCardsGrid.d.ts","sourceRoot":"","sources":["../../src/components/TestimonialCardsGrid.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA0FpE,CAAC"}

package/dist/components/TestimonialSlideshow.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import React from 'react';
+import type { ShortcodeAttributes } from '../types/testimonial';
+export interface TestimonialSlideshowProps extends ShortcodeAttributes {
+    className?: string;
+}
+/**
+ * TestimonialSlideshow component - displays testimonials in a rotating slideshow
+ * Usage: [testimonial_slideshow category="external" interval="5000" showContent="true"]
+ */
+export declare const TestimonialSlideshow: React.FC<TestimonialSlideshowProps>;
+//# sourceMappingURL=TestimonialSlideshow.d.ts.map

package/dist/components/TestimonialSlideshow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestimonialSlideshow.d.ts","sourceRoot":"","sources":["../../src/components/TestimonialSlideshow.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,yBAAyB,CA+GpE,CAAC"}

package/dist/hooks/useMembers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import type { Member } from '../types/member';
+import type { ShortcodeAttributes } from '../types/shortcode';
+export declare function setWordPressApiUrl(url: string): void;
+/**
+ * Hook to fetch members based on shortcode attributes
+ */
+export declare function useMembers(attrs: ShortcodeAttributes): {
+    members: Member[];
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch a single member by ID
+ */
+export declare function useMember(id: string | number): {
+    member: Member | null;
+    loading: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=useMembers.d.ts.map

package/dist/hooks/useMembers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMembers.d.ts","sourceRoot":"","sources":["../../src/hooks/useMembers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAS9D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,QAE7C;AAyBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,mBAAmB;;;;EAsGpD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;;;;EAwE5C"}

package/dist/hooks/useTestimonials.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license GPL-3.0-or-later
+ *
+ * This file is part of the MarVAlt Open SDK.
+ * Copyright (c) 2025 Vibune Pty Ltd.
+ */
+import type { Testimonial } from '../types/testimonial';
+import type { ShortcodeAttributes } from '../types/shortcode';
+export declare function setWordPressApiUrl(url: string): void;
+/**
+ * Hook to fetch testimonials based on shortcode attributes
+ */
+export declare function useTestimonials(attrs: ShortcodeAttributes): {
+    testimonials: Testimonial[];
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to fetch a single testimonial by ID
+ */
+export declare function useTestimonial(id: string | number): {
+    testimonial: Testimonial | null;
+    loading: boolean;
+    error: Error | null;
+};
+//# sourceMappingURL=useTestimonials.d.ts.map

package/dist/hooks/useTestimonials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTestimonials.d.ts","sourceRoot":"","sources":["../../src/hooks/useTestimonials.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAS9D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,QAE7C;AAyBD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB;;;;EA6EzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;;;;EAsCjD"}