@sudobility/building_blocks 0.0.17 → 0.0.18

package/dist/components/index.d.ts

@@ -4,3 +4,4 @@ export * from './footer';
 export * from './layout';
 export * from './settings';
 export * from './subscription';
+export * from './pages';

package/dist/components/pages/app-privacy-policy-page.d.ts

@@ -0,0 +1,137 @@
+import React, { type ReactNode, type ComponentType } from 'react';
+/**
+ * Configuration for a content section with a list
+ */
+export interface PrivacySectionWithList {
+    /** Section title */
+    title: string;
+    /** Optional description before the list */
+    description?: string;
+    /** List items */
+    items: string[];
+}
+/**
+ * Configuration for a content section with paragraph text
+ */
+export interface PrivacySectionWithContent {
+    /** Section title */
+    title: string;
+    /** Paragraph content */
+    content: string;
+}
+/**
+ * Configuration for a subsection (h3 level)
+ */
+export interface PrivacySubsection {
+    /** Subsection title */
+    title: string;
+    /** List items */
+    items: string[];
+}
+/**
+ * Contact information configuration
+ */
+export interface PrivacyContactInfo {
+    /** Email label (e.g., "Email:") */
+    emailLabel: string;
+    /** Email address */
+    email: string;
+    /** Website label (e.g., "Website:") */
+    websiteLabel: string;
+    /** Website URL */
+    websiteUrl: string;
+    /** Data Protection Officer label */
+    dpoLabel: string;
+    /** DPO email */
+    dpoEmail: string;
+    /** GDPR section title */
+    gdprTitle: string;
+    /** GDPR section content */
+    gdprContent: string;
+}
+/**
+ * All text content for the privacy policy page
+ */
+export interface PrivacyPolicyPageText {
+    /** Page heading */
+    heading: string;
+    /** Last updated label */
+    lastUpdatedLabel: string;
+    /** Introduction section */
+    introduction: PrivacySectionWithContent;
+    /** Information We Collect section */
+    informationWeCollect: {
+        title: string;
+        youProvide: PrivacySubsection;
+        automatic: PrivacySubsection;
+    };
+    /** How We Use Your Information section */
+    howWeUse: PrivacySectionWithList;
+    /** Information Sharing section */
+    informationSharing: PrivacySectionWithList;
+    /** Data Security section */
+    dataSecurity: PrivacySectionWithList;
+    /** Data Retention section */
+    dataRetention: PrivacySectionWithContent;
+    /** Your Privacy Rights section */
+    privacyRights: PrivacySectionWithList;
+    /** Web3 Considerations section (optional) */
+    web3Considerations?: PrivacySectionWithList;
+    /** International Transfers section */
+    internationalTransfers: PrivacySectionWithContent;
+    /** Children's Privacy section */
+    childrensPrivacy: PrivacySectionWithContent;
+    /** Cookies section */
+    cookies: PrivacySectionWithContent;
+    /** Changes to Policy section */
+    changes: PrivacySectionWithContent;
+    /** Contact section */
+    contact: {
+        title: string;
+        description: string;
+        info: PrivacyContactInfo;
+    };
+}
+/**
+ * Props for AppPrivacyPolicyPage component
+ */
+export interface AppPrivacyPolicyPageProps {
+    /** All text content (must be provided by consumer) */
+    text: PrivacyPolicyPageText;
+    /** Current date for "last updated" display */
+    lastUpdatedDate?: string;
+    /** Optional wrapper component for the page layout */
+    PageWrapper?: ComponentType<{
+        children: ReactNode;
+    }>;
+    /** Optional className for the container */
+    className?: string;
+}
+/**
+ * AppPrivacyPolicyPage - A reusable privacy policy page component
+ *
+ * Displays a comprehensive privacy policy with:
+ * - Standard legal sections
+ * - Optional Web3-specific considerations
+ * - Contact information with GDPR notice
+ *
+ * All text content must be provided by the consumer app.
+ *
+ * @example
+ * ```tsx
+ * <AppPrivacyPolicyPage
+ *   text={{
+ *     heading: "Privacy Policy",
+ *     lastUpdatedLabel: "Last updated",
+ *     introduction: {
+ *       title: "Introduction",
+ *       content: "We respect your privacy..."
+ *     },
+ *     // ... other sections
+ *   }}
+ *   lastUpdatedDate="January 1, 2025"
+ * />
+ * ```
+ */
+export declare const AppPrivacyPolicyPage: React.FC<AppPrivacyPolicyPageProps>;
+export default AppPrivacyPolicyPage;

package/dist/components/pages/app-sitemap-page.d.ts

@@ -0,0 +1,116 @@
+import React, { type ComponentType, type ReactNode } from 'react';
+import type { LinkComponentProps } from '../../types';
+/**
+ * Configuration for a single sitemap link
+ */
+export interface SitemapLink {
+    /** URL path */
+    path: string;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Configuration for a sitemap section
+ */
+export interface SitemapSection {
+    /** Section title */
+    title: string;
+    /** Section icon type (optional) */
+    icon?: 'home' | 'document' | 'envelope' | 'cog' | 'language';
+    /** Links in this section */
+    links: SitemapLink[];
+}
+/**
+ * Configuration for a language option
+ */
+export interface LanguageOption {
+    /** Language code (e.g., 'en', 'es') */
+    code: string;
+    /** Display name */
+    name: string;
+    /** Flag emoji */
+    flag: string;
+}
+/**
+ * Configuration for quick action buttons
+ */
+export interface QuickLink {
+    /** URL path */
+    path: string;
+    /** Display label */
+    label: string;
+    /** Button variant */
+    variant: 'primary' | 'secondary' | 'outline';
+    /** Optional icon */
+    icon?: 'envelope' | 'document';
+}
+/**
+ * Text content for the sitemap page
+ */
+export interface SitemapPageText {
+    /** Page title */
+    title: string;
+    /** Page subtitle */
+    subtitle: string;
+    /** Languages section title */
+    languagesSectionTitle: string;
+    /** Languages section description */
+    languagesDescription: string;
+    /** Quick links section title */
+    quickLinksTitle: string;
+}
+/**
+ * Props for AppSitemapPage component
+ */
+export interface AppSitemapPageProps {
+    /** All text content (must be provided by consumer) */
+    text: SitemapPageText;
+    /** Sitemap sections */
+    sections: SitemapSection[];
+    /** Available languages */
+    languages: LanguageOption[];
+    /** Quick action links */
+    quickLinks?: QuickLink[];
+    /** Custom Link component for navigation */
+    LinkComponent: ComponentType<LinkComponentProps & {
+        language?: string;
+    }>;
+    /** Optional wrapper component for the page layout */
+    PageWrapper?: ComponentType<{
+        children: ReactNode;
+    }>;
+    /** Optional className for the container */
+    className?: string;
+}
+/**
+ * AppSitemapPage - A reusable sitemap page component
+ *
+ * Displays a comprehensive sitemap with:
+ * - Language selector
+ * - Organized sections with links
+ * - Quick action buttons
+ *
+ * All text content must be provided by the consumer app.
+ *
+ * @example
+ * ```tsx
+ * <AppSitemapPage
+ *   text={{
+ *     title: "Sitemap",
+ *     subtitle: "Explore all pages",
+ *     languagesSectionTitle: "Languages",
+ *     languagesDescription: "Available in multiple languages",
+ *     quickLinksTitle: "Quick Links"
+ *   }}
+ *   sections={[
+ *     { title: "Main", icon: "home", links: [{ path: "/", label: "Home" }] }
+ *   ]}
+ *   languages={[{ code: "en", name: "English", flag: "🇺🇸" }]}
+ *   LinkComponent={LocalizedLink}
+ * />
+ * ```
+ */
+export declare const AppSitemapPage: React.FC<AppSitemapPageProps>;
+export default AppSitemapPage;

package/dist/components/pages/app-terms-of-service-page.d.ts

@@ -0,0 +1,107 @@
+import React, { type ReactNode, type ComponentType } from 'react';
+/**
+ * Configuration for a section with paragraph content
+ */
+export interface TermsSectionWithContent {
+    /** Section title */
+    title: string;
+    /** Paragraph content (can include HTML for links) */
+    content: string;
+    /** Whether content contains HTML that should be rendered */
+    isHtml?: boolean;
+}
+/**
+ * Configuration for a section with a list
+ */
+export interface TermsSectionWithList {
+    /** Section title */
+    title: string;
+    /** Optional description before the list */
+    description?: string;
+    /** List items */
+    items: string[];
+    /** Optional additional content after the list */
+    additionalContent?: string;
+}
+/**
+ * Contact information configuration
+ */
+export interface TermsContactInfo {
+    /** Email label (e.g., "Email:") */
+    emailLabel: string;
+    /** Email address */
+    email: string;
+    /** Website label (e.g., "Website:") */
+    websiteLabel: string;
+    /** Website URL */
+    websiteUrl: string;
+}
+/**
+ * All text content for the terms of service page
+ */
+export interface TermsOfServicePageText {
+    /** Page title */
+    title: string;
+    /** Last updated text (with placeholder for date) */
+    lastUpdated: string;
+    /** All sections in order */
+    sections: Array<TermsSectionWithContent | TermsSectionWithList>;
+    /** Contact information */
+    contact: {
+        /** Section title */
+        title: string;
+        /** Section description */
+        description: string;
+        /** Whether description contains HTML */
+        isHtml?: boolean;
+        /** Contact details */
+        info: TermsContactInfo;
+    };
+}
+/**
+ * Props for AppTermsOfServicePage component
+ */
+export interface AppTermsOfServicePageProps {
+    /** All text content (must be provided by consumer) */
+    text: TermsOfServicePageText;
+    /** Current date for "last updated" display */
+    lastUpdatedDate?: string;
+    /** Optional wrapper component for the page layout */
+    PageWrapper?: ComponentType<{
+        children: ReactNode;
+    }>;
+    /** Optional className for the container */
+    className?: string;
+}
+/**
+ * AppTermsOfServicePage - A reusable terms of service page component
+ *
+ * Displays a comprehensive terms of service document with:
+ * - Flexible section structure (content or list-based)
+ * - Contact information
+ * - Support for HTML content in specific sections
+ *
+ * All text content must be provided by the consumer app.
+ *
+ * @example
+ * ```tsx
+ * <AppTermsOfServicePage
+ *   text={{
+ *     title: "Terms of Service",
+ *     lastUpdated: "Last updated: {{date}}",
+ *     sections: [
+ *       { title: "Acceptance", content: "By using..." },
+ *       { title: "User Responsibilities", items: ["Item 1", "Item 2"] }
+ *     ],
+ *     contact: {
+ *       title: "Contact",
+ *       description: "Questions?",
+ *       info: { emailLabel: "Email:", email: "support@example.com", ... }
+ *     }
+ *   }}
+ *   lastUpdatedDate="January 1, 2025"
+ * />
+ * ```
+ */
+export declare const AppTermsOfServicePage: React.FC<AppTermsOfServicePageProps>;
+export default AppTermsOfServicePage;

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

@@ -0,0 +1,6 @@
+export { AppSitemapPage } from './app-sitemap-page';
+export type { AppSitemapPageProps, SitemapPageText, SitemapSection, SitemapLink, LanguageOption, QuickLink, } from './app-sitemap-page';
+export { AppPrivacyPolicyPage } from './app-privacy-policy-page';
+export type { AppPrivacyPolicyPageProps, PrivacyPolicyPageText, PrivacySectionWithList, PrivacySectionWithContent, PrivacySubsection, PrivacyContactInfo, } from './app-privacy-policy-page';
+export { AppTermsOfServicePage } from './app-terms-of-service-page';
+export type { AppTermsOfServicePageProps, TermsOfServicePageText, TermsSectionWithContent, TermsSectionWithList, TermsContactInfo, } from './app-terms-of-service-page';