@yoamigo.com/core 0.1.0

package/LICENSE

@@ -0,0 +1,11 @@
+Copyright (c) 2025 YoAmigo. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the
+proprietary property of YoAmigo. Unauthorized copying, modification,
+distribution, or use of this Software, via any medium, is strictly prohibited.
+
+The Software is provided for use solely in connection with the YoAmigo platform
+and template development program. Any other use requires explicit written
+permission from YoAmigo.
+
+For licensing inquiries, contact: support@yoamigo.com

package/README.md

@@ -0,0 +1,81 @@
+# @yoamigo/core
+
+Core components, Vite plugin, and utilities for building YoAmigo templates.
+
+## Installation
+
+```bash
+npm install @yoamigo/core
+```
+
+## Usage
+
+### Vite Plugin
+
+Add the YoAmigo plugin to your `vite.config.ts`:
+
+```typescript
+import { defineConfig } from 'vite'
+import { yoamigoPlugin } from '@yoamigo/core/plugin'
+
+export default defineConfig({
+  plugins: [yoamigoPlugin()],
+})
+```
+
+The plugin automatically handles:
+- React/Preact swap in production builds
+- Path aliases (`@/` maps to `src/`)
+- Environment variables (`YA_*` prefix)
+- Optimized build output
+
+### Components
+
+Use the editable components in your templates:
+
+```tsx
+import { YaText, YaImage, YaLink, ContentStoreProvider } from '@yoamigo/core'
+
+function App() {
+  return (
+    <ContentStoreProvider>
+      <h1>
+        <YaText fieldId="hero.title" />
+      </h1>
+      <YaImage fieldId="hero.image" className="hero-img" />
+      <YaLink fieldId="hero.cta" className="btn">
+        <YaText fieldId="hero.cta.text" />
+      </YaLink>
+    </ContentStoreProvider>
+  )
+}
+```
+
+### Router
+
+A lightweight router for multi-page templates:
+
+```tsx
+import { Router, Route, Link, useLocation } from '@yoamigo/core/router'
+
+function App() {
+  return (
+    <Router>
+      <nav>
+        <Link href="/">Home</Link>
+        <Link href="/about">About</Link>
+      </nav>
+      <Route path="/" component={Home} />
+      <Route path="/about" component={About} />
+    </Router>
+  )
+}
+```
+
+## Documentation
+
+For full documentation, visit [yoamigo.com/developers](https://yoamigo.com/developers).
+
+## License
+
+Proprietary - All Rights Reserved. See LICENSE file for details.

package/dist/MarkdownText-mylt-QX-.d.ts

@@ -0,0 +1,106 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1, { ReactNode } from 'react';
+
+type EditMode = 'read-only' | 'inline-edit';
+interface ContentStore {
+    getValue: (fieldId: string) => string;
+    setValue: (fieldId: string, value: string) => void;
+    mode: EditMode;
+    setMode: (mode: EditMode) => void;
+    subscribe: (listener: () => void) => () => void;
+    saveToWorker?: (fieldId: string, value: string) => Promise<void>;
+}
+declare function useContentStore(): ContentStore;
+interface ContentStoreProviderProps {
+    children: ReactNode;
+    initialContent?: Record<string, string>;
+    initialMode?: EditMode;
+}
+declare function ContentStoreProvider({ children }: ContentStoreProviderProps): react_jsx_runtime.JSX.Element;
+
+interface PageInfo {
+    path: string;
+    label: string;
+}
+interface YaLinkProps {
+    fieldId: string;
+    /** Default href if not set in content store */
+    href?: string;
+    className?: string;
+    as?: 'a' | 'span';
+    children?: React$1.ReactNode;
+    /** Available pages for href dropdown (injected by template) */
+    availablePages?: PageInfo[];
+    /** Optional click handler called after navigation */
+    onClick?: () => void;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        fontSize: {
+            setFontSize: (fontSize: string) => ReturnType;
+            unsetFontSize: () => ReturnType;
+        };
+        fontWeight: {
+            setFontWeight: (fontWeight: string) => ReturnType;
+            unsetFontWeight: () => ReturnType;
+        };
+    }
+}
+declare function YaLink({ fieldId, href: defaultHref, className, as: Component, children, availablePages, onClick }: YaLinkProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * StaticText Component - Production-only static text renderer
+ *
+ * This component replaces MpText in production builds via Vite alias.
+ * No editing capabilities, no Tiptap, no DOMPurify - minimal bundle size.
+ *
+ * Content from content.json is trusted because:
+ * 1. It's created in the builder using Tiptap (which controls allowed markup)
+ * 2. It's sanitized by SafeHtml when displayed in the builder
+ * 3. Users can't inject arbitrary HTML
+ */
+/** Common HTML elements that MpText can render as */
+type MpTextElement = 'span' | 'div' | 'p' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'strong' | 'em';
+interface MpTextProps {
+    fieldId: string;
+    className?: string;
+    as?: MpTextElement;
+    /** Optional fallback content (used if fieldId not in store) */
+    children?: React.ReactNode;
+}
+declare function MpText({ fieldId, className, as: Component, children }: MpTextProps): react_jsx_runtime.JSX.Element;
+
+type StaticTextProps = MpTextProps;
+
+/**
+ * StaticImage Component - Production-only static image renderer
+ *
+ * This component replaces MpImage in production builds via Vite alias.
+ * No editing overlay, no click handlers, no postMessage - minimal bundle size.
+ */
+interface MpImageProps {
+    fieldId: string;
+    className?: string;
+    alt?: string;
+    objectFit?: 'cover' | 'contain' | 'fill';
+    objectPosition?: string;
+    loading?: 'lazy' | 'eager';
+    /** Fallback for backward compatibility with config.ts images */
+    fallbackSrc?: string;
+    /** Fallback alt text */
+    fallbackAlt?: string;
+}
+declare function MpImage({ fieldId, className, alt, objectFit: propObjectFit, objectPosition: propObjectPosition, loading, fallbackSrc, fallbackAlt, }: MpImageProps): react_jsx_runtime.JSX.Element;
+
+type StaticImageProps = MpImageProps;
+
+interface MarkdownTextProps {
+    content: string;
+    className?: string;
+}
+/**
+ * MarkdownText component - renders markdown content safely
+ */
+declare function MarkdownText({ content, className }: MarkdownTextProps): react_jsx_runtime.JSX.Element;
+
+export { ContentStoreProvider as C, type EditMode as E, MpText as M, type PageInfo as P, type StaticTextProps as S, YaLink as Y, type ContentStore as a, MpImage as b, type StaticImageProps as c, MarkdownText as d, type MarkdownTextProps as e, type YaLinkProps as f, useContentStore as u };

package/dist/api-client-D8FkeBAI.d.ts

@@ -0,0 +1,40 @@
+/**
+ * API Client
+ *
+ * Handles communication with the backend API for:
+ * - Email subscriptions
+ * - Contact form submissions
+ * - Product/cart operations (future)
+ */
+/**
+ * Subscribe to newsletter
+ */
+declare function subscribeToNewsletter(email: string): Promise<{
+    success: boolean;
+}>;
+/**
+ * Submit contact form
+ */
+interface ContactFormData {
+    name: string;
+    email: string;
+    phone?: string;
+    eventType?: string;
+    eventDate?: string;
+    location?: string;
+    message: string;
+}
+declare function submitContactForm(data: ContactFormData): Promise<{
+    success: boolean;
+}>;
+/**
+ * Get site metadata (used by worker for runtime config injection)
+ */
+interface SiteMetadata {
+    siteId: string;
+    apiUrl: string;
+    version: number;
+}
+declare function getSiteMetadata(): Promise<SiteMetadata | null>;
+
+export { type ContactFormData as C, type SiteMetadata as S, submitContactForm as a, getSiteMetadata as g, subscribeToNewsletter as s };

package/dist/asset-resolver-BnIvDkVv.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Content Registry - Global content store for production builds
+ *
+ * Templates register their content.json at startup, and StaticText/StaticImage
+ * components read from this registry instead of importing directly.
+ *
+ * @example
+ * // In template's main.tsx:
+ * import content from './content.json'
+ * import { registerContent } from '@yoamigo/template-base'
+ * registerContent(content)
+ */
+/**
+ * Register content from template's content.json
+ * Call this at app startup before rendering
+ */
+declare function registerContent(content: Record<string, string>): void;
+/**
+ * Get content value by fieldId
+ * @param fieldId - Dot-notation path (e.g., 'hero.title', 'artist.bio')
+ * @returns The content string, or empty string if not found
+ */
+declare function getContent(fieldId: string): string;
+/**
+ * Get all content as a Record
+ * Useful for initializing ContentStoreProvider
+ */
+declare function getAllContent(): Record<string, string>;
+/**
+ * Check if a fieldId exists in content
+ */
+declare function hasContent(fieldId: string): boolean;
+/**
+ * Content registry interface for type exports
+ */
+interface ContentRegistry {
+    registerContent: typeof registerContent;
+    getContent: typeof getContent;
+    getAllContent: typeof getAllContent;
+    hasContent: typeof hasContent;
+}
+/**
+ * Content registry object for convenience
+ */
+declare const contentRegistry: ContentRegistry;
+
+/**
+ * Asset Resolver - Configurable asset URL resolution
+ *
+ * Templates register their asset resolver at startup. This allows
+ * MpImage/StaticImage to resolve asset paths correctly based on
+ * Vite's base path configuration.
+ *
+ * @example
+ * // In template's main.tsx:
+ * import { setAssetResolver } from '@yoamigo/template-base'
+ * setAssetResolver((path) => `${import.meta.env.BASE_URL}${path}`)
+ */
+type AssetResolverFn = (path: string) => string;
+type AssetResolver = AssetResolverFn;
+/**
+ * Set the asset resolver function
+ * Call this at app startup before rendering
+ */
+declare function setAssetResolver(resolver: AssetResolver): void;
+/**
+ * Resolve an asset path to a full URL
+ * Uses the registered resolver function
+ */
+declare function resolveAssetUrl(path: string): string;
+
+export { type AssetResolverFn as A, type ContentRegistry as C, getAllContent as a, resolveAssetUrl as b, contentRegistry as c, getContent as g, hasContent as h, registerContent as r, setAssetResolver as s };

package/dist/builder-selection-CYP91nRu.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Initialize builder selection when running in iframe
+ */
+declare function initBuilderSelection(): void;
+
+export { initBuilderSelection as i };

package/dist/index.css

@@ -0,0 +1,372 @@
+/* src/components/ya-tooltip.css */
+.ya-tooltip {
+  position: fixed;
+  z-index: 9999;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 8px 12px;
+  background: #1a1a1a;
+  color: white;
+  border-radius: 6px;
+  font-size: 13px;
+  font-weight: 500;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif;
+  white-space: nowrap;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+  animation: ya-tooltip-fade-in 0.15s ease;
+  pointer-events: none;
+}
+@keyframes ya-tooltip-fade-in {
+  from {
+    opacity: 0;
+    transform: scale(0.95);
+  }
+  to {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+.ya-tooltip svg {
+  width: 16px;
+  height: 16px;
+  flex-shrink: 0;
+}
+.ya-tooltip-bottom {
+  transform: translateX(-50%);
+}
+.ya-tooltip-bottom::before {
+  content: "";
+  position: absolute;
+  bottom: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  border: 6px solid transparent;
+  border-bottom-color: #1a1a1a;
+}
+.ya-tooltip-top {
+  transform: translateX(-50%);
+}
+.ya-tooltip-top::before {
+  content: "";
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  transform: translateX(-50%);
+  border: 6px solid transparent;
+  border-top-color: #1a1a1a;
+}
+.ya-tooltip-right {
+  transform: translateY(-50%);
+}
+.ya-tooltip-right::before {
+  content: "";
+  position: absolute;
+  right: 100%;
+  top: 50%;
+  transform: translateY(-50%);
+  border: 6px solid transparent;
+  border-right-color: #1a1a1a;
+}
+.ya-tooltip-left {
+  transform: translateY(-50%);
+}
+.ya-tooltip-left::before {
+  content: "";
+  position: absolute;
+  left: 100%;
+  top: 50%;
+  transform: translateY(-50%);
+  border: 6px solid transparent;
+  border-left-color: #1a1a1a;
+}
+
+/* src/components/ya-link.css */
+.ya-link-wrapper {
+  position: relative;
+  display: inline;
+}
+.ya-link-editable {
+  cursor: pointer;
+  transition: outline 0.15s ease;
+}
+.ya-link-editable:hover {
+  outline: 2px dashed var(--color-primary, #D4A574);
+  outline-offset: 4px;
+  border-radius: 4px;
+}
+body.builder-selector-active .ya-link-editable:hover {
+  outline: none;
+  cursor: inherit;
+}
+.ya-link-editing {
+  outline: 2px solid var(--color-primary, #D4A574);
+  outline-offset: 4px;
+  border-radius: 4px;
+  position: relative;
+}
+.ya-link-actions {
+  display: flex;
+  gap: 8px;
+  position: absolute;
+  bottom: -60px;
+  right: 0;
+  z-index: 10;
+  background: rgba(26, 26, 26, 0.95);
+  padding: 8px 10px;
+  border-radius: 8px;
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.3);
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif;
+}
+.ya-link-btn {
+  padding: 6px 14px;
+  font-size: 12px;
+  font-weight: 500;
+  border-radius: 6px;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  border: none;
+}
+.ya-link-btn-cancel {
+  background: #333333;
+  color: #ffffff;
+  border: 1px solid #555555;
+}
+.ya-link-btn-cancel:hover {
+  background: #444444;
+  color: #ffffff;
+  border-color: #666666;
+}
+.ya-link-btn-save {
+  background: #D4A574;
+  color: #1a1a1a;
+}
+.ya-link-btn-save:hover {
+  background: #c4956a;
+}
+.ya-href-popover {
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  margin-top: 8px;
+  z-index: 10;
+  min-width: 280px;
+  max-width: 320px;
+  background: #1a1a1a;
+  border-radius: 12px;
+  box-shadow: 0 8px 32px rgba(0, 0, 0, 0.4);
+  transform: translateX(-50%);
+  animation: ya-href-popover-fade-in 0.15s ease;
+  overflow: hidden;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif;
+}
+@keyframes ya-href-popover-fade-in {
+  from {
+    opacity: 0;
+    transform: translateX(-50%) translateY(-8px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(-50%) translateY(0);
+  }
+}
+.ya-href-popover::before {
+  content: "";
+  position: absolute;
+  top: -6px;
+  left: 50%;
+  transform: translateX(-50%);
+  border-left: 8px solid transparent;
+  border-right: 8px solid transparent;
+  border-bottom: 8px solid #1a1a1a;
+}
+.ya-href-popover-header {
+  padding: 12px 16px;
+  font-size: 13px;
+  font-weight: 600;
+  color: #ffffff;
+  border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+}
+.ya-href-popover-section {
+  padding: 12px 16px;
+}
+.ya-href-popover-label {
+  display: block;
+  font-size: 11px;
+  font-weight: 500;
+  color: rgba(255, 255, 255, 0.6);
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  margin-bottom: 8px;
+}
+.ya-href-collapsible-header {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  width: 100%;
+  padding: 0;
+  background: transparent;
+  border: none;
+  cursor: pointer;
+  transition: color 0.15s ease;
+}
+.ya-href-collapsible-header:hover {
+  color: rgba(255, 255, 255, 0.8);
+}
+.ya-href-chevron {
+  font-size: 8px;
+  color: rgba(255, 255, 255, 0.4);
+}
+.ya-href-popover-pages {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  max-height: 200px;
+  overflow-y: auto;
+}
+.ya-href-page-btn {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 4px;
+  width: 100%;
+  padding: 10px 12px;
+  background: rgba(255, 255, 255, 0.05);
+  border: 1px solid transparent;
+  border-radius: 8px;
+  color: #e0e0e0;
+  font-size: 13px;
+  font-weight: 500;
+  text-align: left;
+  cursor: pointer;
+  transition: all 0.15s ease;
+}
+.ya-href-page-btn:hover {
+  background: rgba(255, 255, 255, 0.1);
+  border-color: rgba(255, 255, 255, 0.2);
+}
+.ya-href-page-btn.is-selected {
+  background: #D4A574;
+  color: #1a1a1a;
+}
+.ya-href-page-btn.is-selected .ya-href-page-path {
+  color: rgba(26, 26, 26, 0.6);
+}
+.ya-href-page-path {
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.4);
+  font-family: monospace;
+  word-break: break-all;
+}
+.ya-href-external-toggle {
+  display: block;
+  width: 100%;
+  padding: 10px 16px;
+  background: transparent;
+  border: none;
+  border-top: 1px solid rgba(255, 255, 255, 0.1);
+  color: #D4A574;
+  font-size: 12px;
+  font-weight: 500;
+  text-align: center;
+  cursor: pointer;
+  transition: background 0.15s ease;
+}
+.ya-href-external-toggle:hover {
+  background: rgba(255, 255, 255, 0.05);
+}
+.ya-href-url-input {
+  width: 100%;
+  padding: 10px 12px;
+  background: rgba(255, 255, 255, 0.05);
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  border-radius: 8px;
+  color: #ffffff;
+  font-size: 13px;
+  outline: none;
+  transition: border-color 0.15s ease;
+}
+.ya-href-url-input::placeholder {
+  color: rgba(255, 255, 255, 0.4);
+}
+.ya-href-url-input:focus {
+  border-color: var(--color-primary, #D4A574);
+}
+.ya-href-popover-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  padding: 12px 16px;
+  border-top: 1px solid rgba(255, 255, 255, 0.1);
+}
+.ya-link-edit-popover {
+  position: absolute;
+  top: 100%;
+  left: 50%;
+  margin-top: 8px;
+  z-index: 10;
+  background: #2a2a2a;
+  border-radius: 6px;
+  padding: 4px;
+  display: flex;
+  gap: 4px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+  transform: translateX(-50%);
+  animation: ya-edit-popover-fade-in 0.1s ease;
+  font-family:
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    "Segoe UI",
+    sans-serif;
+  white-space: nowrap;
+}
+@keyframes ya-edit-popover-fade-in {
+  from {
+    opacity: 0;
+    transform: translateX(-50%) translateY(-4px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(-50%) translateY(0);
+  }
+}
+.ya-link-edit-popover::before {
+  content: "";
+  position: absolute;
+  top: -5px;
+  left: 50%;
+  transform: translateX(-50%);
+  border-left: 6px solid transparent;
+  border-right: 6px solid transparent;
+  border-bottom: 6px solid #2a2a2a;
+}
+.ya-link-edit-popover button {
+  background: #3a3a3a;
+  border: none;
+  color: #fff;
+  padding: 6px 12px;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 13px;
+  font-weight: 500;
+  transition: background 0.15s ease;
+}
+.ya-link-edit-popover button:hover {
+  background: #4a4a4a;
+}