npm - @zoyth/simple-site-framework - Versions diffs - 1.0.0 - Mend

@zoyth/simple-site-framework 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

package/LICENSE +21 -0
package/README.md +572 -0
package/bin/create-simple-site.js +390 -0
package/bin/simple-site.js +664 -0
package/dist/client.js +135 -0
package/dist/client.js.map +1 -0
package/dist/client.mjs +107 -0
package/dist/client.mjs.map +1 -0
package/dist/components/index.d.mts +3936 -0
package/dist/components/index.d.ts +3936 -0
package/dist/components/index.js +38265 -0
package/dist/components/index.js.map +1 -0
package/dist/components/index.mjs +38173 -0
package/dist/components/index.mjs.map +1 -0
package/dist/config/index.d.mts +298 -0
package/dist/config/index.d.ts +298 -0
package/dist/config/index.js +19 -0
package/dist/config/index.js.map +1 -0
package/dist/config/index.mjs +1 -0
package/dist/config/index.mjs.map +1 -0
package/dist/index.d.mts +2184 -0
package/dist/index.d.ts +2184 -0
package/dist/index.js +1713 -0
package/dist/index.js.map +1 -0
package/dist/index.mjs +1605 -0
package/dist/index.mjs.map +1 -0
package/dist/lib/i18n/index.js +665 -0
package/dist/lib/i18n/index.js.map +1 -0
package/dist/lib/i18n/index.mjs +621 -0
package/dist/lib/i18n/index.mjs.map +1 -0
package/docs/DOCUMENTATION-STRUCTURE.md +1156 -0
package/docs/EXPORTS.md +125 -0
package/docs/PERFORMANCE.md +757 -0
package/docs/POLICY-PAGES.md +867 -0
package/docs/ROADMAP.md +334 -0
package/docs/SEO.md +455 -0
package/docs/SITEMAP.md +708 -0
package/docs/STRUCTURED-DATA.md +671 -0
package/docs/accessibility/common-patterns.md +529 -0
package/docs/accessibility/keyboard-navigation.md +263 -0
package/docs/accessibility/overview.md +122 -0
package/docs/accessibility/screen-readers.md +311 -0
package/docs/accessibility/wcag-compliance.md +159 -0
package/docs/api/README.md +164 -0
package/docs/api/components/Accessibility.md +356 -0
package/docs/api/components/Button.md +240 -0
package/docs/api/components/HeroSection.md +306 -0
package/docs/architecture/decisions.md +449 -0
package/docs/components/AnalyticsTracker.md +58 -0
package/docs/components/AnimatedCounter.md +48 -0
package/docs/components/AnimatedSection.md +56 -0
package/docs/components/BlogCard.md +42 -0
package/docs/components/Checkbox.md +56 -0
package/docs/components/CodeBlock.md +52 -0
package/docs/components/ComparisonTable.md +40 -0
package/docs/components/ComponentDemo.md +38 -0
package/docs/components/CountdownTimer.md +51 -0
package/docs/components/ExitIntentModal.md +56 -0
package/docs/components/FAQAccordion.md +66 -0
package/docs/components/FeaturesGrid.md +55 -0
package/docs/components/FileUpload.md +54 -0
package/docs/components/I18nMetaTags.md +55 -0
package/docs/components/Icon.md +53 -0
package/docs/components/LazySection.md +46 -0
package/docs/components/LiveProof.md +53 -0
package/docs/components/LoadingSpinner.md +46 -0
package/docs/components/MultiStepForm.md +48 -0
package/docs/components/PolicyLayout.md +55 -0
package/docs/components/PricingTable.md +49 -0
package/docs/components/Radio.md +59 -0
package/docs/components/SEOMetaTags.md +58 -0
package/docs/components/ScriptInjector.md +50 -0
package/docs/components/Select.md +72 -0
package/docs/components/Skeleton.md +47 -0
package/docs/components/StatsSection.md +48 -0
package/docs/components/StickyBar.md +62 -0
package/docs/components/StructuredData.md +99 -0
package/docs/components/StyleGuide.md +46 -0
package/docs/components/TableOfContents.md +47 -0
package/docs/components/TestimonialCarousel.md +42 -0
package/docs/components/Timeline.md +51 -0
package/docs/components/Toast.md +59 -0
package/docs/components/TrackedLink.md +62 -0
package/docs/components/TrustBadges.md +44 -0
package/docs/components/conversion/MobileCTA.md +363 -0
package/docs/components/forms/ContactForm.md +75 -0
package/docs/components/forms/FormField.md +74 -0
package/docs/components/layout/Footer.md +601 -0
package/docs/components/layout/Header.md +549 -0
package/docs/components/layout/LanguageSelector.md +54 -0
package/docs/components/layout/LanguageSwitcher.md +24 -0
package/docs/components/overview.md +447 -0
package/docs/components/sections/AboutSection.md +48 -0
package/docs/components/sections/CTASection.md +596 -0
package/docs/components/sections/CaseStudySection.md +47 -0
package/docs/components/sections/ContactSection.md +599 -0
package/docs/components/sections/FeatureSection.md +44 -0
package/docs/components/sections/HeroSection.md +404 -0
package/docs/components/sections/LogosSection.md +47 -0
package/docs/components/sections/PersonalTaxesSection.md +23 -0
package/docs/components/sections/RecruitingSection.md +23 -0
package/docs/components/sections/SecurePortalSection.md +23 -0
package/docs/components/sections/ServicePageLayout.md +52 -0
package/docs/components/sections/ServicesSection.md +49 -0
package/docs/components/sections/TestimonialSection.md +44 -0
package/docs/components/sections/WhyChooseUsSection.md +54 -0
package/docs/components/ui/Breadcrumb.md +70 -0
package/docs/components/ui/Button.md +514 -0
package/docs/components/ui/Card.md +501 -0
package/docs/components/ui/Input.md +54 -0
package/docs/components/ui/MobileLinks.md +43 -0
package/docs/components/ui/Modal.md +60 -0
package/docs/components/ui/Tabs.md +62 -0
package/docs/components/ui/Textarea.md +52 -0
package/docs/core-concepts/configuration-driven.md +552 -0
package/docs/core-concepts/overview.md +351 -0
package/docs/features/accessibility/README.md +73 -0
package/docs/features/accessibility/aria-support.md +177 -0
package/docs/features/accessibility/color-contrast.md +155 -0
package/docs/features/accessibility/focus-management.md +187 -0
package/docs/features/accessibility/testing.md +196 -0
package/docs/features/analytics/README.md +51 -0
package/docs/features/analytics/ab-testing.md +171 -0
package/docs/features/analytics/conversion-tracking.md +207 -0
package/docs/features/analytics/custom-events.md +219 -0
package/docs/features/analytics/privacy.md +198 -0
package/docs/features/analytics/setup.md +114 -0
package/docs/features/analytics/tracking-events.md +224 -0
package/docs/features/i18n/README.md +51 -0
package/docs/features/i18n/best-practices.md +273 -0
package/docs/features/i18n/configuration.md +84 -0
package/docs/features/i18n/formatting.md +133 -0
package/docs/features/i18n/locale-detection.md +122 -0
package/docs/features/i18n/routing.md +99 -0
package/docs/features/i18n/rtl-support.md +191 -0
package/docs/features/i18n/translations.md +129 -0
package/docs/features/internationalization.md +595 -0
package/docs/features/performance/README.md +77 -0
package/docs/features/performance/bundle-size.md +134 -0
package/docs/features/performance/caching.md +131 -0
package/docs/features/performance/code-splitting.md +121 -0
package/docs/features/performance/image-optimization.md +110 -0
package/docs/features/performance/lazy-loading.md +92 -0
package/docs/features/performance/monitoring.md +148 -0
package/docs/features/seo/README.md +51 -0
package/docs/features/seo/best-practices.md +184 -0
package/docs/features/seo/canonical-urls.md +182 -0
package/docs/features/seo/meta-tags.md +126 -0
package/docs/features/seo/open-graph.md +166 -0
package/docs/features/seo/robots-txt.md +146 -0
package/docs/features/seo/sitemaps.md +162 -0
package/docs/features/seo/structured-data.md +166 -0
package/docs/getting-started/installation.md +292 -0
package/docs/getting-started/introduction.md +195 -0
package/docs/getting-started/quick-start.md +460 -0
package/docs/guides/analytics-setup.md +616 -0
package/docs/i18n/CONFIGURATION.md +353 -0
package/docs/i18n/EXAMPLES.md +402 -0
package/docs/i18n/MIGRATION.md +260 -0
package/docs/i18n/SEO.md +392 -0
package/docs/i18n/STATIC-GENERATION-FIX.md +71 -0
package/docs/migration/changelog.md +136 -0
package/docs/migration/overview.md +233 -0
package/docs/recipes/adding-animations.md +475 -0
package/docs/recipes/forms-with-validation.md +393 -0
package/package.json +152 -0

package/docs/features/i18n/rtl-support.md ADDED Viewed

@@ -0,0 +1,191 @@
+# RTL (Right-to-Left) Support
+Support for right-to-left languages like Arabic and Hebrew.
+## Configuration
+Specify RTL locales in configuration:
+```typescript
+export const i18nConfig = {
+  locales: ['en', 'ar', 'he', 'fr'],
+  defaultLocale: 'en',
+  rtlLocales: ['ar', 'he'], // RTL languages
+};
+```
+## HTML Direction Attribute
+Set the `dir` attribute on the root HTML element:
+```typescript
+// app/[locale]/layout.tsx
+import { getTextDirection } from '@zoyth/simple-site-framework/lib/i18n';
+export default function RootLayout({ children, params }) {
+  const { locale } = params;
+  const direction = getTextDirection(locale);
+  return (
+    <html lang={locale} dir={direction}>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+This outputs:
+- `<html dir="ltr">` for LTR languages (English, French, etc.)
+- `<html dir="rtl">` for RTL languages (Arabic, Hebrew)
+## Utility Functions
+### isRtlLocale
+Check if a locale is RTL:
+```typescript
+import { isRtlLocale } from '@zoyth/simple-site-framework/lib/i18n';
+isRtlLocale('ar'); // true
+isRtlLocale('he'); // true
+isRtlLocale('en'); // false
+isRtlLocale('fr'); // false
+```
+### getTextDirection
+Get text direction for locale:
+```typescript
+import { getTextDirection } from '@zoyth/simple-site-framework/lib/i18n';
+getTextDirection('ar'); // 'rtl'
+getTextDirection('en'); // 'ltr'
+```
+## CSS Considerations
+### Logical Properties
+Use CSS logical properties for RTL compatibility:
+```css
+/* ✅ Good - RTL compatible */
+.element {
+  margin-inline-start: 1rem;
+  padding-inline-end: 2rem;
+  border-inline-start: 1px solid;
+}
+/* ❌ Bad - Not RTL compatible */
+.element {
+  margin-left: 1rem;
+  padding-right: 2rem;
+  border-left: 1px solid;
+}
+```
+### Tailwind CSS
+Tailwind v3+ supports RTL with logical properties:
+```tsx
+<div className="ms-4 pe-6">
+  {/* margin-inline-start: 1rem, padding-inline-end: 1.5rem */}
+</div>
+```
+Or use RTL variants:
+```tsx
+<div className="ml-4 rtl:mr-4 rtl:ml-0">
+  {/* Margin left in LTR, margin right in RTL */}
+</div>
+```
+## Component Adjustments
+### Icons and Arrows
+Flip directional icons in RTL:
+```tsx
+import { isRtlLocale } from '@zoyth/simple-site-framework/lib/i18n';
+function NavigationArrow({ locale }: Props) {
+  const isRtl = isRtlLocale(locale);
+  return (
+    <svg className={isRtl ? 'scale-x-[-1]' : ''}>
+      {/* Arrow icon */}
+    </svg>
+  );
+}
+```
+### Text Alignment
+Adjust text alignment based on direction:
+```tsx
+<p className="text-start">
+  {/* Aligns left in LTR, right in RTL */}
+</p>
+```
+## Testing RTL
+### Browser Testing
+1. Add Arabic or Hebrew to your config
+2. Switch to RTL locale via LanguageSelector
+3. Verify layout mirrors correctly
+4. Check navigation, forms, and interactive elements
+### Development Tools
+Chrome DevTools can force RTL:
+1. Open DevTools
+2. Rendering tab → Enable "Emulate RTL"
+## Common RTL Issues
+### Floats and Positioning
+Use flexbox/grid instead of floats:
+```css
+/* ✅ Good */
+.container {
+  display: flex;
+  justify-content: flex-start;
+}
+/* ❌ Avoid */
+.container {
+  float: left;
+}
+```
+### Absolute Positioning
+Use logical properties:
+```css
+/* ✅ Good */
+.element {
+  inset-inline-start: 0;
+}
+/* ❌ Avoid */
+.element {
+  left: 0;
+}
+```
+## See Also
+- [Configuration](./configuration.md)
+- [CSS Logical Properties (MDN)](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Logical_Properties)
+- [Tailwind RTL Support](https://tailwindcss.com/docs/hover-focus-and-other-states#rtl-support)

package/docs/features/i18n/translations.md ADDED Viewed

@@ -0,0 +1,129 @@
+# Managing Translations
+Organize and manage translated content across multiple languages.
+## LocalizedString Type
+The core type for translated content:
+```typescript
+type LocalizedString = {
+  [locale: string]: string;
+};
+```
+## Usage in Components
+All framework components accept LocalizedString:
+```typescript
+const content = {
+  heading: {
+    en: 'Welcome to Our Site',
+    fr: 'Bienvenue sur notre site',
+    es: 'Bienvenido a nuestro sitio',
+  },
+  description: {
+    en: 'Professional services for your business',
+    fr: 'Services professionnels pour votre entreprise',
+    es: 'Servicios profesionales para su negocio',
+  },
+};
+<HeroSection
+  heading={content.heading}
+  description={content.description}
+  locale={locale}
+/>
+```
+## Translation Organization
+### Option 1: Configuration Files
+```typescript
+// config/translations/en.ts
+export const en = {
+  nav: {
+    home: 'Home',
+    about: 'About',
+    services: 'Services',
+    contact: 'Contact',
+  },
+  hero: {
+    title: 'Welcome',
+    subtitle: 'Professional services',
+  },
+};
+// config/translations/fr.ts
+export const fr = {
+  nav: {
+    home: 'Accueil',
+    about: 'À propos',
+    services: 'Services',
+    contact: 'Contact',
+  },
+  hero: {
+    title: 'Bienvenue',
+    subtitle: 'Services professionnels',
+  },
+};
+```
+### Option 2: Inline LocalizedStrings
+```typescript
+const translations = {
+  title: { en: 'Welcome', fr: 'Bienvenue', es: 'Bienvenido' },
+  button: { en: 'Get Started', fr: 'Commencer', es: 'Comenzar' },
+};
+```
+### Option 3: JSON Translation Files
+```json
+// locales/en.json
+{
+  "home": {
+    "hero": {
+      "title": "Welcome",
+      "subtitle": "Professional services"
+    }
+  }
+}
+```
+## Helper Utilities
+### getLocalizedString
+Extract string for specific locale:
+```typescript
+import { getLocalizedString } from '@zoyth/simple-site-framework/lib/i18n';
+const heading = { en: 'Welcome', fr: 'Bienvenue' };
+const text = getLocalizedString(heading, 'fr'); // 'Bienvenue'
+```
+### Fallback Behavior
+1. Requested locale
+2. Default locale
+3. First available translation
+4. Empty string
+## Best Practices
+- Keep translations co-located with components when possible
+- Use TypeScript to ensure translation completeness
+- Provide default locale translation for all strings
+- Consider using a translation management service for large projects
+- Validate translations at build time
+## See Also
+- [Configuration](./configuration.md)
+- [LocalizedString Type](../../api-reference/types.md)
+- [Translation Examples](../../i18n/EXAMPLES.md)