@avocadostudio-ai/shared 0.1.0

package/dist/blocks/footer.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Footer", {
+    schema: z.object({
+        copyright: z.string().min(1),
+        columns: z.array(z.object({ id: z.string().optional(), title: z.string().min(1), links: z.string().min(1) })).min(1)
+    }),
+    meta: {
+        displayName: "Footer",
+        description: "Multi-column footer with link groups and copyright.",
+        category: "navigation",
+        chrome: true,
+        fields: { copyright: f.text("Copyright text"), headingLevel: f.headingLevel() },
+        listFields: {
+            columns: {
+                label: "Footer columns",
+                itemFields: { title: f.text("Column title"), links: f.richtext("Links (one label|url per line)") }
+            }
+        }
+    }
+});
+export function footerDefaultProps() {
+    return {
+        copyright: "\u00a9 2026 Your Company",
+        columns: [
+            { title: "Product", links: "Features|/features\nPricing|/pricing" },
+            { title: "Company", links: "About|/about\nContact|/contact" }
+        ]
+    };
+}

package/dist/blocks/gallery.d.ts

@@ -0,0 +1 @@
+export declare function galleryDefaultProps(): Record<string, unknown>;

package/dist/blocks/gallery.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { registerBlock, IMAGE_PLACEHOLDER } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Gallery", {
+    schema: z.object({
+        title: z.string().optional(),
+        headingLevel: z.string().optional(),
+        columns: z.enum(["2", "3", "4"]).default("3").catch("3"),
+        images: z.array(z.object({
+            id: z.string().optional(),
+            imageUrl: z.string().min(1),
+            alt: z.string().optional(),
+            caption: z.string().optional(),
+        })).min(1),
+    }),
+    meta: {
+        displayName: "Gallery",
+        description: "Image grid with configurable columns and optional captions.",
+        category: "media",
+        fields: {
+            title: f.text("Section title"),
+            columns: { kind: "enum", label: "Columns", options: ["2", "3", "4"], inlineEditable: false },
+            headingLevel: f.headingLevel(),
+        },
+        listFields: {
+            images: {
+                label: "Images",
+                itemFields: {
+                    imageUrl: f.image("Image", { aspectRatio: "landscape", width: 800, height: 600 }),
+                    alt: f.imageAlt("Alt text"),
+                    caption: f.text("Caption"),
+                }
+            }
+        }
+    }
+});
+export function galleryDefaultProps() {
+    return {
+        title: "",
+        columns: "3",
+        images: [
+            { imageUrl: IMAGE_PLACEHOLDER, alt: "Gallery image 1", caption: "" },
+            { imageUrl: IMAGE_PLACEHOLDER, alt: "Gallery image 2", caption: "" },
+            { imageUrl: IMAGE_PLACEHOLDER, alt: "Gallery image 3", caption: "" },
+        ],
+    };
+}

package/dist/blocks/hero.d.ts

@@ -0,0 +1 @@
+export declare function heroDefaultProps(): Record<string, unknown>;

package/dist/blocks/hero.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { registerBlock, IMAGE_PLACEHOLDER } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Hero", {
+    schema: z.object({
+        heading: z.string().min(1),
+        subheading: z.string().min(1),
+        ctaText: z.string().min(1),
+        ctaHref: z.string().min(1),
+        imageUrl: z.string().min(1),
+        imageAlt: z.string().min(1),
+        imagePosition: z.enum(["left", "right", "full"]).default("right").catch("right"),
+        textAlign: z.enum(["left", "center"]).default("left").catch("left"),
+        eyebrow: z.string().optional(),
+        secondaryCtaText: z.string().optional(),
+        secondaryCtaHref: z.string().optional()
+    }),
+    meta: {
+        displayName: "Hero",
+        description: "Full-width hero section with headline, subheading, CTA buttons, and image.",
+        category: "content",
+        fields: {
+            heading: f.text("Heading"),
+            subheading: f.text("Subheading"),
+            ctaText: f.text("CTA button text"),
+            ctaHref: f.url("CTA link"),
+            imageUrl: f.image("Hero image", { aspectRatio: "landscape", width: 1536, height: 1024 }),
+            imageAlt: f.imageAlt("Hero image alt text"),
+            imagePosition: { kind: "enum", label: "Image position", options: ["left", "right", "full"], inlineEditable: false },
+            textAlign: { kind: "enum", label: "Text alignment", options: ["left", "center"], inlineEditable: false },
+            eyebrow: f.text("Eyebrow text"),
+            secondaryCtaText: f.text("Secondary CTA text"),
+            secondaryCtaHref: f.url("Secondary CTA link"),
+            headingLevel: f.headingLevel(),
+        }
+    }
+});
+export function heroDefaultProps() {
+    return {
+        heading: "Build with confidence",
+        subheading: "Make changes safely with instant preview.",
+        ctaText: "Get Started",
+        ctaHref: "/",
+        imageUrl: IMAGE_PLACEHOLDER,
+        imageAlt: "Abstract generated illustration",
+        imagePosition: "right"
+    };
+}

package/dist/blocks/index.d.ts

@@ -0,0 +1,3 @@
+import type { BlockType } from "./_registry.ts";
+export declare function defaultPropsForType(type: BlockType): Record<string, unknown>;
+export { DEFAULT_HEADING_LEVELS, resolveHeadingTag, resolveItemHeadingTag } from "./_helpers.ts";

package/dist/blocks/index.js

@@ -0,0 +1,53 @@
+// Named imports trigger each module's registerBlock() side effect
+import { heroDefaultProps } from "./hero.js";
+import { featureGridDefaultProps } from "./feature-grid.js";
+import { testimonialsDefaultProps } from "./testimonials.js";
+import { faqAccordionDefaultProps } from "./faq-accordion.js";
+import { ctaDefaultProps } from "./cta.js";
+import { cardDefaultProps } from "./card.js";
+import { cardGridDefaultProps } from "./card-grid.js";
+import { richTextDefaultProps } from "./rich-text.js";
+import { statsDefaultProps } from "./stats.js";
+import { twoColumnDefaultProps } from "./two-column.js";
+import { footerDefaultProps } from "./footer.js";
+import { siteHeaderDefaultProps } from "./site-header.js";
+import { embedDefaultProps } from "./embed.js";
+import { bannerDefaultProps } from "./banner.js";
+import { carouselDefaultProps } from "./carousel.js";
+import { galleryDefaultProps } from "./gallery.js";
+import { tabsDefaultProps } from "./tabs.js";
+import { tableDefaultProps } from "./table.js";
+import { quoteDefaultProps } from "./quote.js";
+import { videoDefaultProps } from "./video.js";
+const defaults = {
+    Hero: heroDefaultProps,
+    FeatureGrid: featureGridDefaultProps,
+    Testimonials: testimonialsDefaultProps,
+    FAQAccordion: faqAccordionDefaultProps,
+    CTA: ctaDefaultProps,
+    Card: cardDefaultProps,
+    CardGrid: cardGridDefaultProps,
+    RichText: richTextDefaultProps,
+    Stats: statsDefaultProps,
+    TwoColumn: twoColumnDefaultProps,
+    Footer: footerDefaultProps,
+    SiteHeader: siteHeaderDefaultProps,
+    Embed: embedDefaultProps,
+    Banner: bannerDefaultProps,
+    Carousel: carouselDefaultProps,
+    Gallery: galleryDefaultProps,
+    Tabs: tabsDefaultProps,
+    Table: tableDefaultProps,
+    Quote: quoteDefaultProps,
+    Video: videoDefaultProps,
+};
+const fallback = {
+    title: "Ready to get started?",
+    description: "Apply your next change in seconds.",
+    ctaText: "Start now",
+    ctaHref: "/"
+};
+export function defaultPropsForType(type) {
+    return defaults[type]?.() ?? { ...fallback };
+}
+export { DEFAULT_HEADING_LEVELS, resolveHeadingTag, resolveItemHeadingTag } from "./_helpers.js";

package/dist/blocks/quote.d.ts

@@ -0,0 +1 @@
+export declare function quoteDefaultProps(): Record<string, unknown>;

package/dist/blocks/quote.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Quote", {
+    schema: z.object({
+        quote: z.string().min(1),
+        author: z.string().optional(),
+        role: z.string().optional(),
+        imageUrl: z.string().optional(),
+        imageAlt: z.string().optional(),
+    }),
+    meta: {
+        displayName: "Quote",
+        description: "Pull quote or blockquote with optional author attribution and avatar.",
+        category: "content",
+        fields: {
+            quote: f.richtext("Quote text"),
+            author: f.text("Author name"),
+            role: f.text("Author role / title"),
+            imageUrl: f.image("Author avatar", { aspectRatio: "square", width: 128, height: 128 }),
+            imageAlt: f.imageAlt("Avatar alt text"),
+        },
+    }
+});
+export function quoteDefaultProps() {
+    return {
+        quote: "The best way to predict the future is to create it.",
+        author: "Peter Drucker",
+        role: "Management Consultant",
+        imageUrl: "https://placehold.co/300x300/e2e8f0/475569?text=PD",
+    };
+}

package/dist/blocks/rich-text.d.ts

@@ -0,0 +1 @@
+export declare function richTextDefaultProps(): Record<string, unknown>;

package/dist/blocks/rich-text.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("RichText", {
+    schema: z.object({
+        title: z.string(),
+        body: z.string().min(1)
+    }),
+    meta: {
+        displayName: "Rich Text",
+        description: "Freeform text content with markdown-style formatting.",
+        category: "content",
+        fields: {
+            title: f.text("Section title"),
+            body: f.richtext("Body"),
+            headingLevel: f.headingLevel(),
+        }
+    }
+});
+export function richTextDefaultProps() {
+    return {
+        title: "About this page",
+        body: [
+            "Rich text supports **bold**, *italic*, and [inline links](https://example.com) so you can weave emphasis and references into prose without leaving the editor.",
+            "## What you can format",
+            "Use short paragraphs to keep things scannable. Break ideas apart so readers can skim before they commit to reading.",
+            [
+                "- Unordered lists for grouped, non-sequential points",
+                "- Mix **bold** items with plain ones to highlight the important bits",
+                "- Keep each bullet to a single idea",
+            ].join("\n"),
+            "### When order matters",
+            [
+                "1. Start with the outcome you want",
+                "2. Describe the steps in the order a reader should follow",
+                "3. End with a link to [learn more](https://example.com/docs)",
+            ].join("\n"),
+            "Use rich text for long-form content — essays, documentation, changelogs, or anywhere a grid of cards would feel too rigid."
+        ].join("\n\n")
+    };
+}

package/dist/blocks/site-header.d.ts

@@ -0,0 +1 @@
+export declare function siteHeaderDefaultProps(): Record<string, unknown>;

package/dist/blocks/site-header.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+const navLinkLeaf = z.object({
+    id: z.string().optional(),
+    label: z.string().min(1),
+    href: z.string().min(1),
+});
+registerBlock("SiteHeader", {
+    schema: z.object({
+        siteName: z.string().min(1),
+        logoUrl: z.string().min(1),
+        links: z.array(navLinkLeaf.extend({
+            href: z.string().optional(), // parent dropdown items have no href
+            children: z.array(navLinkLeaf).optional(), // 2nd-level dropdown items
+        })).min(1),
+    }),
+    meta: {
+        displayName: "Site Header",
+        description: "Global site navigation bar with logo, site name, and nav links.",
+        category: "navigation",
+        chrome: true,
+        fields: {
+            siteName: f.text("Site name"),
+            logoUrl: f.image("Logo"),
+        },
+        listFields: {
+            links: {
+                label: "Nav links",
+                itemFields: {
+                    label: f.text("Link label"),
+                    href: f.url("Link URL"),
+                },
+            },
+        },
+    },
+});
+export function siteHeaderDefaultProps() {
+    return {
+        siteName: "My Site",
+        logoUrl: "/logo.svg",
+        links: [
+            { label: "Home", href: "/" },
+            { label: "About", href: "/about" },
+            { label: "Contact", href: "/contact" },
+        ],
+    };
+}

package/dist/blocks/stats.d.ts

@@ -0,0 +1 @@
+export declare function statsDefaultProps(): Record<string, unknown>;

package/dist/blocks/stats.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Stats", {
+    schema: z.object({
+        title: z.string().optional(),
+        stats: z.array(z.object({
+            id: z.string().optional(),
+            icon: z.string().optional(),
+            value: z.string().min(1),
+            label: z.string().min(1),
+            description: z.string().optional()
+        })).min(1)
+    }),
+    meta: {
+        displayName: "Stats",
+        description: "Row of big numbers with labels (e.g. 10K+ Users).",
+        category: "content",
+        fields: { title: f.text("Section title"), headingLevel: f.headingLevel() },
+        listFields: {
+            stats: {
+                label: "Stats",
+                itemFields: {
+                    icon: f.text("Icon (single emoji)"),
+                    value: f.text("Value"),
+                    label: f.text("Label"),
+                    description: f.text("Description"),
+                }
+            }
+        }
+    }
+});
+export function statsDefaultProps() {
+    return {
+        title: "By the numbers",
+        stats: [
+            { value: "10k+", label: "Active users" },
+            { value: "99.9%", label: "Uptime" },
+            { value: "24/7", label: "Support" }
+        ]
+    };
+}

package/dist/blocks/table.d.ts

@@ -0,0 +1 @@
+export declare function tableDefaultProps(): Record<string, unknown>;

package/dist/blocks/table.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Table", {
+    schema: z.object({
+        title: z.string().optional(),
+        headingLevel: z.string().optional(),
+        headers: z.array(z.string().min(1)).min(1),
+        rows: z.array(z.array(z.coerce.string())).min(1),
+        striped: z.enum(["true", "false"]).default("false").catch("false"),
+    }),
+    meta: {
+        displayName: "Table",
+        description: "Data table with column headers, rows, and optional stripe styling. Headers is a string array. Rows is a 2D string array where each inner array is one row matching the headers order.",
+        category: "content",
+        fields: {
+            title: f.text("Section title"),
+            headingLevel: f.headingLevel(),
+            headers: f.text("Column headers"),
+            rows: f.text("Table rows"),
+            striped: { kind: "enum", label: "Striped rows", options: ["true", "false"], inlineEditable: false },
+        },
+    }
+});
+export function tableDefaultProps() {
+    return {
+        title: "",
+        headers: ["Feature", "Starter", "Pro", "Enterprise"],
+        rows: [
+            ["Users", "Up to 3", "Up to 20", "Unlimited"],
+            ["Storage", "1 GB", "10 GB", "100 GB"],
+            ["Support", "Community", "Email", "Dedicated"],
+            ["API access", "—", "Yes", "Yes"],
+        ],
+        striped: "true",
+    };
+}

package/dist/blocks/tabs.d.ts

@@ -0,0 +1 @@
+export declare function tabsDefaultProps(): Record<string, unknown>;

package/dist/blocks/tabs.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Tabs", {
+    schema: z.object({
+        title: z.string().optional(),
+        tabs: z.array(z.object({
+            id: z.string().optional(),
+            label: z.string().min(1),
+            content: z.string().min(1),
+        })).min(1),
+    }),
+    meta: {
+        displayName: "Tabs",
+        description: "Switchable tabbed content panels with rich text in each tab.",
+        category: "content",
+        fields: { title: f.text("Section title"), headingLevel: f.headingLevel() },
+        listFields: {
+            tabs: {
+                label: "Tabs",
+                itemFields: {
+                    label: f.text("Tab label"),
+                    content: f.richtext("Tab content"),
+                }
+            }
+        }
+    }
+});
+export function tabsDefaultProps() {
+    return {
+        tabs: [
+            { label: "Overview", content: "This is the overview tab with **general information** about the topic.\n\nKey highlights:\n\n- Easy to get started\n- Works across all devices\n- Built for teams of any size" },
+            { label: "Features", content: "## Core Features\n\n- **Real-time collaboration** — edit together with your team\n- **Version history** — roll back to any previous state\n- **API access** — integrate with your existing tools\n\nAll features are included in every plan." },
+            { label: "Pricing", content: "View our flexible pricing plans designed for teams of all sizes.\n\n1. **Starter** — Free for up to 3 users\n2. **Pro** — $12/user/month\n3. **Enterprise** — Custom pricing" },
+            { label: "Integrations", content: "Connect with the tools you already use:\n\n- Slack\n- GitHub\n- Jira\n- Figma\n- Google Workspace" },
+            { label: "Support", content: "Get help from our team:\n\n- **Live chat** — available 9am–6pm ET\n- **Email** — support@example.com\n- **Community forum** — [Visit the forum](https://example.com)" },
+        ],
+    };
+}

package/dist/blocks/testimonials.d.ts

@@ -0,0 +1 @@
+export declare function testimonialsDefaultProps(): Record<string, unknown>;

package/dist/blocks/testimonials.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Testimonials", {
+    schema: z.object({
+        title: z.string().min(1),
+        items: z.array(z.object({
+            id: z.string().optional(),
+            icon: z.string().optional(),
+            quote: z.string().min(1),
+            author: z.string().min(1),
+            role: z.string().optional(),
+            imageUrl: z.string().optional(),
+            imageAlt: z.string().optional()
+        })).min(1)
+    }),
+    meta: {
+        displayName: "Testimonials",
+        description: "Grid of testimonial cards with quotes and authors.",
+        category: "content",
+        fields: { title: f.text("Section title"), headingLevel: f.headingLevel() },
+        listFields: {
+            items: {
+                label: "Testimonials",
+                itemFields: {
+                    icon: f.text("Icon (single emoji)"),
+                    quote: f.longtext("Quote"),
+                    author: f.text("Author"),
+                    role: f.text("Role / Company"),
+                    imageUrl: f.image("Author photo", { aspectRatio: "square", width: 64, height: 64 }),
+                    imageAlt: f.imageAlt("Author photo alt"),
+                }
+            }
+        }
+    }
+});
+export function testimonialsDefaultProps() {
+    return {
+        title: "What customers say",
+        items: [
+            { quote: "We launched faster than expected.", author: "Alex" },
+            { quote: "Editing is straightforward for the whole team.", author: "Jordan" }
+        ]
+    };
+}

package/dist/blocks/two-column.d.ts

@@ -0,0 +1 @@
+export declare function twoColumnDefaultProps(): Record<string, unknown>;

package/dist/blocks/two-column.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { registerBlock, IMAGE_PLACEHOLDER } from "./_registry.js";
+import { f } from "./_helpers.js";
+const twoColumnChild = z.object({
+    id: z.string().optional(),
+    // Required, no natural default — coerce an out-of-range/legacy type to "paragraph"
+    // (a safe text component that keeps the item's `text`) so a single drifted child
+    // can't reject the whole block on re-validation during update_props/item ops (#21).
+    type: z.enum(["heading", "subheading", "paragraph", "list", "cta", "ctas", "image", "video"]).catch("paragraph"),
+    text: z.string().optional(),
+    label: z.string().optional(),
+    href: z.string().optional(),
+    src: z.string().optional(),
+    alt: z.string().optional(),
+    poster: z.string().optional(),
+    items: z.array(z.string()).optional(),
+    buttons: z.array(z.object({ label: z.string(), href: z.string(), variant: z.string().optional() })).optional(),
+    variant: z.string().optional()
+});
+const twoColumnItemFields = {
+    type: { kind: "enum", label: "Component type", options: ["heading", "subheading", "paragraph", "list", "cta", "ctas", "image", "video"] },
+    text: f.longtext("Text content"),
+    label: f.text("Button label"),
+    href: f.url("Link URL"),
+    src: f.image("Media source", { aspectRatio: "portrait", width: 768, height: 1024 }),
+    alt: f.imageAlt("Alt text"),
+    poster: f.image("Video poster image", { aspectRatio: "landscape", width: 768, height: 512 }),
+};
+registerBlock("TwoColumn", {
+    schema: z.object({
+        variant: z.enum(["default", "accent"]).default("default").catch("default"),
+        left: z.array(twoColumnChild).min(1),
+        right: z.array(twoColumnChild).min(1)
+    }),
+    meta: {
+        displayName: "Two Column",
+        description: "Composite two-column layout with typed child components in each column.",
+        category: "layout",
+        fields: {
+            variant: { kind: "enum", label: "Style variant", options: ["default", "accent"], inlineEditable: false },
+            headingLevel: f.headingLevel(),
+        },
+        listFields: {
+            left: { label: "Left column items", itemFields: twoColumnItemFields },
+            right: { label: "Right column items", itemFields: twoColumnItemFields }
+        }
+    }
+});
+export function twoColumnDefaultProps() {
+    return {
+        variant: "default",
+        left: [
+            { type: "heading", text: "Built for teams" },
+            { type: "paragraph", text: "Ship changes quickly with a clear, reliable workflow." },
+            { type: "cta", label: "Learn more", href: "/" }
+        ],
+        right: [
+            { type: "image", src: IMAGE_PLACEHOLDER, alt: "Team collaborating on a website update" }
+        ]
+    };
+}

package/dist/blocks/video.d.ts

@@ -0,0 +1 @@
+export declare function videoDefaultProps(): Record<string, unknown>;

package/dist/blocks/video.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { registerBlock } from "./_registry.js";
+import { f } from "./_helpers.js";
+registerBlock("Video", {
+    schema: z.object({
+        src: z.string().min(1),
+        title: z.string().optional(),
+        posterUrl: z.string().optional(),
+        autoplay: z.enum(["true", "false"]).default("false").catch("false"),
+        loop: z.enum(["true", "false"]).default("false").catch("false"),
+    }),
+    meta: {
+        displayName: "Video",
+        description: "Video player — supports YouTube, Vimeo URLs, or direct video files (mp4, webm). Auto-detects source type.",
+        category: "media",
+        fields: {
+            src: f.url("Video URL"),
+            title: f.text("Title / caption"),
+            posterUrl: f.image("Poster image", { aspectRatio: "landscape", width: 1200, height: 675 }),
+            autoplay: { kind: "enum", label: "Autoplay", options: ["true", "false"], inlineEditable: false },
+            loop: { kind: "enum", label: "Loop", options: ["true", "false"], inlineEditable: false },
+        },
+    }
+});
+export function videoDefaultProps() {
+    return {
+        src: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
+        title: "",
+        posterUrl: "",
+        autoplay: "false",
+        loop: "false",
+    };
+}