@vamos-ui/react 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vamos (vamos.ist)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @vamos-ui/react
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One component kit for every admin panel — CMS, CRM, HR, partner portals — and the websites around them.
+Five theme axes: theme, material (glass/solid), accent, density and font.
+
+Docs: https://ui.vamos.ist · Source: https://github.com/sametburaksari/vamos-ui
+
+```bash
+pnpm add @vamos-ui/react
+```
+
+```css
+/* app/globals.css (Tailwind CSS v4) */
+@import "tailwindcss";
+@import "@vamos-ui/react/styles.css";
+```
+
+```tsx
+import { Button } from "@vamos-ui/react";
+
+export default function Page() {
+  return <Button>Save</Button>;
+}
+```
+
+Prefer to own the source? Copy single components with the CLI: `npx vamos-ui add button`.
+
+MIT licensed. “Vamos UI” and the logo are trademarks of Vamos.

package/dist/blocks/block-heading.d.ts

@@ -0,0 +1,29 @@
+import * as React from "react";
+import { type BlockLabels } from "./labels.js";
+export type BlockHeadingSize = "display-2xl" | "display-xl" | "display-l" | "display-m" | "h3";
+/** Renders a heading string with its `*emphasis*` as `<em>`. ReactNodes pass through untouched. */
+export declare function renderEmphasis(text: React.ReactNode): React.ReactNode;
+export interface BlockHeadingProps extends Omit<React.HTMLAttributes<HTMLHeadingElement>, "children"> {
+    /** Heading copy. A string supports one `*emphasis*`. */
+    text?: React.ReactNode;
+    children?: React.ReactNode;
+    /** Outline level. Default 2 (the renderer passes 1 to the page's first intro block). */
+    level?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Visual size, independent of the level. Default `"display-m"`. */
+    size?: BlockHeadingSize;
+    /** Builder canvas: an empty heading renders an "Add a title" placeholder. */
+    editMode?: boolean;
+    /** Prop path for edit mode (`data-field`), e.g. `"props.title"`. */
+    field?: string;
+    labels?: Partial<BlockLabels>;
+    locale?: string;
+}
+/**
+ * Display heading for site blocks. Fluid size from the `--text-display-*` scale, follows the
+ * `data-font` preset (italic serif emphasis in editorial, accent ink in sans presets). Server component.
+ *
+ * ```tsx
+ * <BlockHeading level={1} size="display-xl" text="Dinner, *slowly*." />
+ * ```
+ */
+export declare const BlockHeading: React.ForwardRefExoticComponent<BlockHeadingProps & React.RefAttributes<HTMLHeadingElement>>;

package/dist/blocks/block-heading.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../lib/cn.js";
+import { parseEmphasis } from "./schema/emphasis.js";
+import { blockText } from "./labels.js";
+const sizeClass = {
+    "display-2xl": "font-display text-display-2xl",
+    "display-xl": "font-display text-display-xl",
+    "display-l": "font-display text-display-l",
+    "display-m": "font-display text-display-m",
+    h3: "text-h3 font-semibold tracking-[-0.012em]",
+};
+/** Renders a heading string with its `*emphasis*` as `<em>`. ReactNodes pass through untouched. */
+export function renderEmphasis(text) {
+    if (typeof text !== "string")
+        return text;
+    const parts = parseEmphasis(text);
+    if (parts.length === 0)
+        return "";
+    if (parts.length === 1 && !parts[0].em)
+        return parts[0].text;
+    return parts.map((p, i) => (p.em ? _jsx("em", { children: p.text }, i) : _jsx(React.Fragment, { children: p.text }, i)));
+}
+/**
+ * Display heading for site blocks. Fluid size from the `--text-display-*` scale, follows the
+ * `data-font` preset (italic serif emphasis in editorial, accent ink in sans presets). Server component.
+ *
+ * ```tsx
+ * <BlockHeading level={1} size="display-xl" text="Dinner, *slowly*." />
+ * ```
+ */
+export const BlockHeading = React.forwardRef(function BlockHeading({ text, children, level = 2, size = "display-m", editMode, field, labels, locale, className, ...props }, ref) {
+    const Tag = `h${level}`;
+    const content = children ?? renderEmphasis(text);
+    const empty = content === undefined || content === null || content === "";
+    if (empty && !editMode)
+        return null;
+    return (_jsx(Tag, { ref: ref, className: cn("vb-heading text-fg", sizeClass[size], className), "data-field": editMode ? field : undefined, "data-empty": empty ? "" : undefined, ...props, children: empty ? blockText(labels, locale)("addTitle") : content }));
+});

package/dist/blocks/block-image.d.ts

@@ -0,0 +1,52 @@
+import * as React from "react";
+import { type BlockLabels } from "./labels.js";
+import type { BlockAdapters } from "./types.js";
+export type ImageAspect = "1:1" | "4:5" | "3:4" | "4:3" | "3:2" | "2:3" | "16:9" | "21:9" | number;
+export interface BlockImageProps {
+    src?: string;
+    /** Required unless `decorative`. */
+    alt?: string;
+    /** Intrinsic size — prevents layout shift. */
+    width?: number;
+    height?: number;
+    /** The image only decorates: rendered with `alt=""`. */
+    decorative?: boolean;
+    /** Crop into a fixed ratio (cover). Without it the image keeps its own ratio. */
+    aspect?: ImageAspect;
+    fit?: "cover" | "contain";
+    /** 0..1 focal point → object-position. */
+    focal?: {
+        x: number;
+        y: number;
+    };
+    /** Tiny data-URL placeholder painted under the image. */
+    blurDataURL?: string;
+    /** Responsive `sizes`, e.g. `"(min-width: 72rem) 50vw, 100vw"`. */
+    sizes?: string;
+    /** Above the fold: eager + `fetchpriority="high"`. */
+    priority?: boolean;
+    /** Wraps the image in `<figure>` with this caption. */
+    caption?: React.ReactNode;
+    /** Classes for the frame (radius, width). */
+    className?: string;
+    /** Classes for the `<img>` itself. */
+    imgClassName?: string;
+    style?: React.CSSProperties;
+    components?: BlockAdapters;
+    labels?: Partial<BlockLabels>;
+    locale?: string;
+    /** Builder canvas: an empty `src` renders an "Add an image" placeholder. */
+    editMode?: boolean;
+    /** Prop path for edit mode (`data-field`). */
+    field?: string;
+}
+/**
+ * Images for site blocks: intrinsic size (no CLS), fixed-ratio crops by focal point, blur
+ * placeholder, priority hint, `sizes`, and the app's own `<Image>` via `components.Image`.
+ * Server component.
+ *
+ * ```tsx
+ * <BlockImage src="/dining-room.jpg" alt="The dining room at dusk" width={2400} height={1600} aspect="4:5" focal={{ x: 0.4, y: 0.5 }} />
+ * ```
+ */
+export declare function BlockImage({ src, alt, width, height, decorative, aspect, fit, focal, blurDataURL, sizes, priority, caption, className, imgClassName, style, components, labels, locale, editMode, field, }: BlockImageProps): React.JSX.Element | null;

package/dist/blocks/block-image.js

@@ -0,0 +1,48 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ImageOff } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { blockText } from "./labels.js";
+const ratioOf = (a, w, h) => {
+    if (a === undefined)
+        return undefined;
+    if (typeof a === "number")
+        return String(a);
+    const [x, y] = a.split(":").map(Number);
+    return x && y ? `${x} / ${y}` : w && h ? `${w} / ${h}` : undefined;
+};
+/**
+ * Images for site blocks: intrinsic size (no CLS), fixed-ratio crops by focal point, blur
+ * placeholder, priority hint, `sizes`, and the app's own `<Image>` via `components.Image`.
+ * Server component.
+ *
+ * ```tsx
+ * <BlockImage src="/dining-room.jpg" alt="The dining room at dusk" width={2400} height={1600} aspect="4:5" focal={{ x: 0.4, y: 0.5 }} />
+ * ```
+ */
+export function BlockImage({ src, alt, width, height, decorative, aspect, fit = "cover", focal, blurDataURL, sizes, priority, caption, className, imgClassName, style, components, labels, locale, editMode, field, }) {
+    const ratio = ratioOf(aspect, width, height);
+    const fieldAttr = editMode && field ? { "data-field": field } : undefined;
+    if (!src) {
+        if (!editMode)
+            return null;
+        const t = blockText(labels, locale);
+        return (_jsxs("span", { "data-empty": "", className: cn("vb-image gap-2 rounded-ui text-small", className), style: { aspectRatio: ratio ?? "3 / 2", ...style }, ...fieldAttr, children: [_jsx(ImageOff, { "aria-hidden": true, className: "size-5", strokeWidth: 1.5 }), _jsx("span", { children: t("addImage") })] }));
+    }
+    if (!decorative && !alt && process.env.NODE_ENV !== "production") {
+        console.warn(`[vamos-ui] BlockImage: "${src}" has no alt text. Describe it, or pass decorative.`);
+    }
+    const frameStyle = {
+        ...(ratio ? { aspectRatio: ratio } : null),
+        ...(focal ? { "--vb-focal": `${(focal.x * 100).toFixed(1)}% ${(focal.y * 100).toFixed(1)}%` } : null),
+        ...(fit !== "cover" ? { "--vb-fit": fit } : null),
+        ...(blurDataURL ? { backgroundImage: `url("${blurDataURL}")` } : null),
+        ...style,
+    };
+    const altText = decorative ? "" : (alt ?? "");
+    const Img = components?.Image;
+    const img = Img ? (_jsx(Img, { src: src, alt: altText, width: ratio ? undefined : width, height: ratio ? undefined : height, fill: ratio ? true : undefined, sizes: sizes, priority: priority, className: imgClassName })) : (_jsx("img", { src: src, alt: altText, width: width, height: height, sizes: sizes, loading: priority ? "eager" : "lazy", decoding: priority ? "sync" : "async", fetchPriority: priority ? "high" : undefined, className: imgClassName }));
+    const frame = (_jsx("span", { "data-ratio": ratio ? "" : undefined, className: cn("vb-image", !ratio && "h-auto", caption ? undefined : className), style: frameStyle, ...(caption ? null : fieldAttr), children: img }));
+    if (!caption)
+        return frame;
+    return (_jsxs("figure", { className: cn("vb-figure", className), ...fieldAttr, children: [frame, _jsx("figcaption", { className: "text-small text-fg-muted", children: caption })] }));
+}

package/dist/blocks/block-link.d.ts

@@ -0,0 +1,30 @@
+import * as React from "react";
+import { type BlockLabels } from "./labels.js";
+import type { BlockAdapters } from "./types.js";
+import type { CtaStyle } from "./schema/types.js";
+export interface BlockLinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    href: string;
+    /** Open in a new tab (adds `rel="noopener noreferrer"` and an announced "(opens in a new tab)"). */
+    newTab?: boolean;
+    /** Render as a button-styled call to action. One `primary` per block. */
+    appearance?: CtaStyle;
+    /** Button size when `appearance` is set. Default `"lg"`. */
+    size?: "md" | "lg" | "xl";
+    components?: BlockAdapters;
+    labels?: Partial<BlockLabels>;
+    locale?: string;
+    /** Prop path for edit mode (`data-field`). */
+    field?: string;
+    editMode?: boolean;
+}
+/**
+ * Links for site blocks. Internal paths go through the app's router `Link` (`components.Link`);
+ * external URLs, `mailto:` and `tel:` render `<a>`. Unsafe hrefs (`javascript:`, `data:`…) render
+ * as plain text. Server component.
+ *
+ * ```tsx
+ * <BlockLink href="/reservations" appearance="primary">Book a table</BlockLink>
+ * <BlockLink href="https://maps.app.goo.gl/x" newTab>Directions</BlockLink>
+ * ```
+ */
+export declare const BlockLink: React.ForwardRefExoticComponent<BlockLinkProps & React.RefAttributes<HTMLAnchorElement>>;

package/dist/blocks/block-link.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../lib/cn.js";
+import { buttonVariants } from "../components/button.js";
+import { blockText } from "./labels.js";
+import { isExternalUrl, sanitizeHref } from "./schema/safety.js";
+/**
+ * Links for site blocks. Internal paths go through the app's router `Link` (`components.Link`);
+ * external URLs, `mailto:` and `tel:` render `<a>`. Unsafe hrefs (`javascript:`, `data:`…) render
+ * as plain text. Server component.
+ *
+ * ```tsx
+ * <BlockLink href="/reservations" appearance="primary">Book a table</BlockLink>
+ * <BlockLink href="https://maps.app.goo.gl/x" newTab>Directions</BlockLink>
+ * ```
+ */
+export const BlockLink = React.forwardRef(function BlockLink({ href, newTab, appearance, size = "lg", components, labels, locale, field, editMode, className, children, rel, target, ...props }, ref) {
+    const safe = sanitizeHref(href);
+    const classes = cn(appearance === "link" ? "inline-flex items-center gap-1.5 font-medium text-fg underline decoration-line underline-offset-[0.3em] transition-colors hover:decoration-current focus-ring rounded-[2px]" : null, appearance && appearance !== "link" ? cn(buttonVariants({ variant: appearance, size }), appearance === "primary" && "vb-action-primary", appearance === "secondary" && "vb-action-secondary") : null, className);
+    const fieldAttr = editMode && field ? { "data-field": field } : undefined;
+    if (!safe) {
+        if (process.env.NODE_ENV !== "production")
+            console.warn(`[vamos-ui] BlockLink: unsafe href "${href}" was not rendered as a link.`);
+        return (_jsx("span", { className: classes, "data-unsafe-href": "", ...fieldAttr, children: children }));
+    }
+    const t = blockText(labels, locale);
+    const content = newTab ? (_jsxs(_Fragment, { children: [children, " ", _jsx("span", { className: "sr-only", children: t("opensInNewTab") })] })) : (children);
+    const relValue = rel ?? (newTab ? "noopener noreferrer" : undefined);
+    const targetValue = target ?? (newTab ? "_blank" : undefined);
+    const Link = components?.Link;
+    const routable = !isExternalUrl(safe) && !/^[a-z][a-z\d+.-]*:/i.test(safe) && !safe.startsWith("#");
+    if (Link && routable) {
+        return (_jsx(Link, { ref: ref, href: safe, className: classes, rel: relValue, target: targetValue, ...fieldAttr, ...props, children: content }));
+    }
+    return (_jsx("a", { ref: ref, href: safe, className: classes, rel: relValue, target: targetValue, ...fieldAttr, ...props, children: content }));
+});

package/dist/blocks/create-blocks.d.ts

@@ -0,0 +1,54 @@
+import * as React from "react";
+import { type SectionProps } from "./section.js";
+import { type BlockImageProps } from "./block-image.js";
+import { type BlockLinkProps } from "./block-link.js";
+import { type RichTextProps } from "./rich-text.js";
+import { type SectionHeaderProps } from "./section-header.js";
+import { type BlockHeadingProps } from "./block-heading.js";
+import { type SkipLinkProps } from "./section.js";
+import type { BlockLabels } from "./labels.js";
+import type { BlockAdapters } from "./types.js";
+export interface CreateBlocksOptions extends BlockAdapters {
+    /** Built-in strings for every bound block (e.g. `blockLabelsTr`). */
+    labels?: Partial<BlockLabels>;
+    /** Default locale for Intl formatting. */
+    locale?: string;
+}
+/** Props `bind()` fills in: adapters, labels and locale. */
+interface Bindable {
+    components?: BlockAdapters;
+    labels?: Partial<BlockLabels>;
+    locale?: string;
+}
+export interface BoundBlocks {
+    Section: React.ComponentType<SectionProps>;
+    SectionHeader: React.ComponentType<SectionHeaderProps>;
+    BlockHeading: React.ComponentType<BlockHeadingProps>;
+    BlockImage: React.ComponentType<BlockImageProps>;
+    BlockLink: React.ComponentType<BlockLinkProps>;
+    RichText: React.ComponentType<RichTextProps>;
+    SkipLink: React.ComponentType<SkipLinkProps>;
+    /** Binds the adapters/labels/locale into any block component (yours or the kit's). */
+    bind<P extends Bindable>(Component: React.ComponentType<P>): React.ComponentType<P>;
+    /** The options, for passing on (`<BlockRenderer components={blocks.adapters} />`). */
+    adapters: BlockAdapters;
+    labels?: Partial<BlockLabels>;
+    locale?: string;
+}
+/**
+ * Binds framework adapters once, without React context (works in Server Components).
+ *
+ * ```ts
+ * // app/blocks.ts
+ * import NextImage from "next/image";
+ * import NextLink from "next/link";
+ * export const { Section, BlockImage, BlockLink, RichText, bind } = createBlocks({ Image: NextImage, Link: NextLink });
+ * export const MyHero = bind(Hero);
+ * ```
+ */
+export declare function createBlocks(options?: CreateBlocksOptions): BoundBlocks;
+/** `data-field` for edit mode (spread onto the element that shows a prop). */
+export declare function fieldAttrs(editMode: boolean | undefined, path: string): {
+    "data-field"?: string;
+};
+export {};

package/dist/blocks/create-blocks.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Section } from "./section.js";
+import { BlockImage } from "./block-image.js";
+import { BlockLink } from "./block-link.js";
+import { RichText } from "./rich-text.js";
+import { SectionHeader } from "./section-header.js";
+import { BlockHeading } from "./block-heading.js";
+import { SkipLink } from "./section.js";
+/**
+ * Binds framework adapters once, without React context (works in Server Components).
+ *
+ * ```ts
+ * // app/blocks.ts
+ * import NextImage from "next/image";
+ * import NextLink from "next/link";
+ * export const { Section, BlockImage, BlockLink, RichText, bind } = createBlocks({ Image: NextImage, Link: NextLink });
+ * export const MyHero = bind(Hero);
+ * ```
+ */
+export function createBlocks(options = {}) {
+    const { labels, locale, ...adapters } = options;
+    function bind(Component) {
+        function Bound(props) {
+            const merged = {
+                ...props,
+                components: { ...adapters, ...props.components },
+                labels: labels || props.labels ? { ...labels, ...props.labels } : undefined,
+                locale: props.locale ?? locale,
+            };
+            return _jsx(Component, { ...merged });
+        }
+        Bound.displayName = `Bound(${Component.displayName ?? Component.name ?? "Block"})`;
+        return Bound;
+    }
+    return {
+        Section: bind(Section),
+        SectionHeader: bind(SectionHeader),
+        BlockHeading: bind(BlockHeading),
+        BlockImage: bind(BlockImage),
+        BlockLink: bind(BlockLink),
+        RichText: bind(RichText),
+        SkipLink: bind(SkipLink),
+        bind,
+        adapters,
+        labels,
+        locale,
+    };
+}
+/** `data-field` for edit mode (spread onto the element that shows a prop). */
+export function fieldAttrs(editMode, path) {
+    return editMode ? { "data-field": path.startsWith("props.") ? path : `props.${path}` } : {};
+}

package/dist/blocks/index.d.ts

@@ -0,0 +1,55 @@
+export { Section, Container, SkipLink, sectionThemeAttributes, accentForeground, type SectionProps, type ContainerProps, type ContainerSize, type SkipLinkProps } from "./section.js";
+export { SectionHeader, type SectionHeaderProps } from "./section-header.js";
+export { BlockHeading, renderEmphasis, type BlockHeadingProps, type BlockHeadingSize } from "./block-heading.js";
+export { BlockImage, type BlockImageProps, type ImageAspect } from "./block-image.js";
+export { BlockLink, type BlockLinkProps } from "./block-link.js";
+export { RichText, renderInline, renderRichBlocks, type RichTextProps, type RichTextRenderOptions } from "./rich-text.js";
+export { JsonLd, mergeJsonLd, serializeJsonLd, type JsonLdProps, type JsonLdNode } from "./json-ld.js";
+export { createBlocks, fieldAttrs, type CreateBlocksOptions, type BoundBlocks } from "./create-blocks.js";
+export { blockLabels, blockLabelsTr, blockText, type BlockLabels } from "./labels.js";
+export type { BlockAdapters, BlockBaseProps, BlockComponentProps, BlockRuntime, ImageData, LinkData } from "./types.js";
+export { parseEmphasis, stripEmphasis, type EmphasisPart } from "./schema/emphasis.js";
+export { sanitizeHref, isExternalUrl, linkKindOf } from "./schema/safety.js";
+export { pickLocale, type Localized } from "./schema/localized.js";
+export { richToText, richFromText, countWords } from "./schema/rich-doc.js";
+export type { BlockTheme, ImageRef, LinkRef, CtaRef, CtaStyle, BlockNode, VamosDoc, PageDoc, OpeningHours, MoneyValue, AddressValue, SocialLink } from "./schema/types.js";
+export type { RichDoc, RichBlock, RichInline, RichMark } from "./schema/rich-doc.js";
+export { AnnouncementBar, type AnnouncementBarProps, type AnnouncementVariant, type AnnouncementTone } from "./site/announcement-bar.js";
+export { Navbar, formatSitePhone, type NavbarProps, type NavbarVariant, type NavbarItem, type NavbarLink, type NavbarLocale } from "./site/navbar.js";
+export { Hero, type HeroProps, type HeroVariant } from "./site/hero.js";
+export { FeatureGrid, type FeatureGridProps, type FeatureGridVariant, type FeatureItem } from "./site/feature-grid.js";
+export { LogoStrip, type LogoStripProps, type LogoStripVariant, type LogoItem } from "./site/logo-strip.js";
+export { StatsBand, type StatsBandProps, type StatsBandVariant, type StatItem } from "./site/stats-band.js";
+export { PageIntro, breadcrumbJsonLd, type PageIntroProps, type PageIntroVariant, type PageIntroCrumb } from "./site/page-intro.js";
+export { RichTextSection, type RichTextSectionProps, type RichTextSectionVariant } from "./site/rich-text-section.js";
+export { MediaText, videoEmbedUrl, type MediaTextProps, type MediaTextVariant, type MediaTextVideo } from "./site/media-text.js";
+export { Cta, waLink, type CtaProps, type CtaVariant, type CtaBookingConfig } from "./site/cta.js";
+export { Faq, faqJsonLd, type FaqProps, type FaqVariant, type FaqItem } from "./site/faq.js";
+export { Steps, type StepsProps, type StepsVariant, type StepsItem } from "./site/process.js";
+export { site1Labels, site1LabelsTr, type Site1Labels, type SiteCta, type SiteMeta, type SiteImage } from "./site/_kit-1.js";
+export { PricingTable, type PricingTableProps, type PricingVariant, type PricingBilling, type PricingPlan, type PricingFeature } from "./site/pricing-table.js";
+export { ComparisonTable, type ComparisonTableProps, type ComparisonVariant, type ComparisonColumn, type ComparisonGroup, type ComparisonRow, type ComparisonValue } from "./site/comparison-table.js";
+export { Testimonials, RatingStars, REVIEW_SOURCE_NAMES, type TestimonialsProps, type TestimonialsVariant, type TestimonialItem, type ReviewSummary, type ReviewSource } from "./site/testimonials.js";
+export { Team, type TeamProps, type TeamVariant, type TeamMember } from "./site/team.js";
+export { BlogList, BlogListSkeleton, type BlogListProps, type BlogListVariant, type PostSummary, type BlogPagination } from "./site/blog-list.js";
+export { ArticleLayout, shareUrl, type ArticleLayoutProps, type ArticleVariant, type ArticlePost, type ArticleAuthor, type ShareTarget } from "./site/article-layout.js";
+export { ContactForm, type ContactFormProps, type ContactFormVariant, type ContactInfo } from "./site/contact-form.js";
+export { MapHours, HoursTable, directionsUrl, mapEmbedUrl, localBusinessJsonLd, type MapHoursProps, type MapHoursVariant, type Branch, type DirectionsProvider, type BusinessType, type HoursDisplay } from "./site/map-hours.js";
+export { MenuList, menuJsonLd, ALLERGENS, type MenuListProps, type MenuVariant, type MenuCategory, type MenuItem, type MenuPrice, type MenuTag, type Allergen } from "./site/menu-list.js";
+export { GallerySection, type GallerySectionProps, type GalleryVariant, type GalleryImage, type GallerySpan } from "./site/gallery-section.js";
+export { ConsentBanner, ConsentDefaults, type ConsentBannerProps, type ConsentVariant } from "./site/consent-banner.js";
+export { ContactDock, type ContactDockProps, type ContactDockVariant, type DockAction, type MessagingProvider } from "./site/contact-dock.js";
+export { EmbedFacade, type EmbedFacadeProps } from "./site/embed-facade.js";
+export { Footer, type FooterProps, type FooterVariant } from "./site/footer.js";
+export { NotFound, type NotFoundProps, type NotFoundVariant, type NotFoundKind } from "./site/not-found.js";
+export { isOpenAt, hoursStatus, hoursOn, weekRows, summarizeHours, orderedWeek, weekStartOf, weekdayName, formatTime, formatRange, zonedMoment, openingHoursJsonLd, describeStatus, type OpenStatus, type OpenState, type WeekRow, type DayHours, type ZonedMoment, type Weekday, type TimeRange } from "./site/shared/opening-hours.js";
+export { OpenNow, type OpenNowProps } from "./site/shared/open-now.js";
+export { ConsentGate, type ConsentGateProps } from "./site/shared/consent-gate.js";
+export { ConsentSettingsButton } from "./site/shared/consent-island.js";
+export { getConsent, onConsent, readConsent, writeConsent, parseConsent, openConsentPreferences, consentDefaultsScript, consentModeSignals, CONSENT_COOKIE, CONSENT_EVENT, CONSENT_OPEN_EVENT, CONSENT_CATEGORIES, type ConsentCategory, type ConsentRecord, type ConsentChoices } from "./site/shared/consent.js";
+export { validateContactForm, isSpam, contactFieldLabel, HONEYPOT_FIELD, type ContactFieldConfig, type ContactFieldName, type SiteFormState, type SiteFormAction, type ContactValidation } from "./site/shared/site-form.js";
+export { BrandIcon, BRAND_NAMES, type BrandName, type BrandIconProps } from "./site/shared/brand-icons.js";
+export { site2Labels, site2LabelsTr, type Site2Labels, type Site2BlockLabels } from "./site/shared/labels-2.js";
+export { SiteShell, SiteShellPage, SiteShellLocale, SiteShellLink, useSiteShell, type SiteShellProps, type SiteShellPageProps, type SiteShellLocaleProps, type SiteShellLinkProps, type SiteShellContextValue } from "./site/site-shell.js";
+export { siteAccent, siteAccentCss, siteAccentKey, isBuiltInAccent, BUILT_IN_SITE_ACCENTS, SITE_TEXT_CONTRAST, type SiteAccentPalette, type SiteAccentOptions } from "./site/shared/site-accent.js";
+export { sitePageHref, siteLocaleHref, parseSiteHref, readSiteLocation, writeSiteLocation, type SiteRouting, type SiteLocation, type SiteRouteParams } from "./site/shared/site-routing.js";

package/dist/blocks/index.js

@@ -0,0 +1,59 @@
+// Public API of @vamos-ui/react/blocks — layer 1 (plain components, server-compatible, no zod).
+// Schema: @vamos-ui/react/blocks/schema · Renderer: @vamos-ui/react/render.
+export { Section, Container, SkipLink, sectionThemeAttributes, accentForeground } from "./section.js";
+export { SectionHeader } from "./section-header.js";
+export { BlockHeading, renderEmphasis } from "./block-heading.js";
+export { BlockImage } from "./block-image.js";
+export { BlockLink } from "./block-link.js";
+export { RichText, renderInline, renderRichBlocks } from "./rich-text.js";
+export { JsonLd, mergeJsonLd, serializeJsonLd } from "./json-ld.js";
+export { createBlocks, fieldAttrs } from "./create-blocks.js";
+export { blockLabels, blockLabelsTr, blockText } from "./labels.js";
+// Pure helpers (no zod) re-exported for components
+export { parseEmphasis, stripEmphasis } from "./schema/emphasis.js";
+export { sanitizeHref, isExternalUrl, linkKindOf } from "./schema/safety.js";
+export { pickLocale } from "./schema/localized.js";
+export { richToText, richFromText, countWords } from "./schema/rich-doc.js";
+// Site blocks · registry 1 (definitions with zod live in ./site/registry-1.ts — server/admin only)
+export { AnnouncementBar } from "./site/announcement-bar.js";
+export { Navbar, formatSitePhone } from "./site/navbar.js";
+export { Hero } from "./site/hero.js";
+export { FeatureGrid } from "./site/feature-grid.js";
+export { LogoStrip } from "./site/logo-strip.js";
+export { StatsBand } from "./site/stats-band.js";
+export { PageIntro, breadcrumbJsonLd } from "./site/page-intro.js";
+export { RichTextSection } from "./site/rich-text-section.js";
+export { MediaText, videoEmbedUrl } from "./site/media-text.js";
+export { Cta, waLink } from "./site/cta.js";
+export { Faq, faqJsonLd } from "./site/faq.js";
+export { Steps } from "./site/process.js";
+export { site1Labels, site1LabelsTr } from "./site/_kit-1.js";
+// Site blocks · registry 2 (definitions with zod live in ./site/registry-2.ts — server/admin only)
+export { PricingTable } from "./site/pricing-table.js";
+export { ComparisonTable } from "./site/comparison-table.js";
+export { Testimonials, RatingStars, REVIEW_SOURCE_NAMES } from "./site/testimonials.js";
+export { Team } from "./site/team.js";
+export { BlogList, BlogListSkeleton } from "./site/blog-list.js";
+export { ArticleLayout, shareUrl } from "./site/article-layout.js";
+export { ContactForm } from "./site/contact-form.js";
+export { MapHours, HoursTable, directionsUrl, mapEmbedUrl, localBusinessJsonLd } from "./site/map-hours.js";
+export { MenuList, menuJsonLd, ALLERGENS } from "./site/menu-list.js";
+export { GallerySection } from "./site/gallery-section.js";
+export { ConsentBanner, ConsentDefaults } from "./site/consent-banner.js";
+export { ContactDock } from "./site/contact-dock.js";
+export { EmbedFacade } from "./site/embed-facade.js";
+export { Footer } from "./site/footer.js";
+export { NotFound } from "./site/not-found.js";
+// Shared modules: opening hours, consent, form contract, brand marks, labels
+export { isOpenAt, hoursStatus, hoursOn, weekRows, summarizeHours, orderedWeek, weekStartOf, weekdayName, formatTime, formatRange, zonedMoment, openingHoursJsonLd, describeStatus } from "./site/shared/opening-hours.js";
+export { OpenNow } from "./site/shared/open-now.js";
+export { ConsentGate } from "./site/shared/consent-gate.js";
+export { ConsentSettingsButton } from "./site/shared/consent-island.js";
+export { getConsent, onConsent, readConsent, writeConsent, parseConsent, openConsentPreferences, consentDefaultsScript, consentModeSignals, CONSENT_COOKIE, CONSENT_EVENT, CONSENT_OPEN_EVENT, CONSENT_CATEGORIES } from "./site/shared/consent.js";
+export { validateContactForm, isSpam, contactFieldLabel, HONEYPOT_FIELD } from "./site/shared/site-form.js";
+export { BrandIcon, BRAND_NAMES } from "./site/shared/brand-icons.js";
+export { site2Labels, site2LabelsTr } from "./site/shared/labels-2.js";
+// Site shell: locale switch, inner pages and a scoped accent for whole-site blocks
+export { SiteShell, SiteShellPage, SiteShellLocale, SiteShellLink, useSiteShell } from "./site/site-shell.js";
+export { siteAccent, siteAccentCss, siteAccentKey, isBuiltInAccent, BUILT_IN_SITE_ACCENTS, SITE_TEXT_CONTRAST } from "./site/shared/site-accent.js";
+export { sitePageHref, siteLocaleHref, parseSiteHref, readSiteLocation, writeSiteLocation } from "./site/shared/site-routing.js";

package/dist/blocks/json-ld.d.ts

@@ -0,0 +1,18 @@
+import * as React from "react";
+export type JsonLdNode = Record<string, unknown>;
+/** Serialises JSON-LD safely for a `<script>` (no `</script>` break-out, no U+2028/9 surprises). */
+export declare function serializeJsonLd(data: unknown): string;
+/** Merges nodes into one `{ "@context", "@graph" }` document; nodes with the same `@id` are merged. */
+export declare function mergeJsonLd(nodes: readonly (JsonLdNode | null | undefined)[]): JsonLdNode | null;
+export interface JsonLdProps {
+    /** One node, a list of nodes (merged into an @graph), or a complete JSON-LD document. */
+    data: JsonLdNode | readonly JsonLdNode[] | null | undefined;
+}
+/**
+ * Structured data for search engines. Server component.
+ *
+ * ```tsx
+ * <JsonLd data={{ "@type": "Restaurant", name: "Kıyı Meyhane", servesCuisine: "Aegean" }} />
+ * ```
+ */
+export declare function JsonLd({ data }: JsonLdProps): React.JSX.Element | null;

package/dist/blocks/json-ld.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/** Serialises JSON-LD safely for a `<script>` (no `</script>` break-out, no U+2028/9 surprises). */
+export function serializeJsonLd(data) {
+    return JSON.stringify(data)
+        .replace(/</g, "\\u003c")
+        .replace(/>/g, "\\u003e")
+        .replace(/&/g, "\\u0026")
+        .replace(/\u2028/g, "\\u2028")
+        .replace(/\u2029/g, "\\u2029");
+}
+/** Merges nodes into one `{ "@context", "@graph" }` document; nodes with the same `@id` are merged. */
+export function mergeJsonLd(nodes) {
+    const byId = new Map();
+    const graph = [];
+    for (const n of nodes) {
+        if (!n)
+            continue;
+        const { "@context": _ctx, ...rest } = n;
+        const id = typeof rest["@id"] === "string" ? rest["@id"] : undefined;
+        if (id && byId.has(id))
+            Object.assign(byId.get(id), rest);
+        else {
+            graph.push(rest);
+            if (id)
+                byId.set(id, rest);
+        }
+    }
+    return graph.length ? { "@context": "https://schema.org", "@graph": graph } : null;
+}
+/**
+ * Structured data for search engines. Server component.
+ *
+ * ```tsx
+ * <JsonLd data={{ "@type": "Restaurant", name: "Kıyı Meyhane", servesCuisine: "Aegean" }} />
+ * ```
+ */
+export function JsonLd({ data }) {
+    if (!data)
+        return null;
+    const doc = Array.isArray(data) ? mergeJsonLd(data) : "@context" in data ? data : { "@context": "https://schema.org", ...data };
+    if (!doc)
+        return null;
+    return _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: serializeJsonLd(doc) } });
+}

package/dist/blocks/labels.d.ts

@@ -0,0 +1,20 @@
+/** English defaults. Keys are shared by every site block; wave-3 blocks add theirs here. */
+export declare const blockLabels: {
+    opensInNewTab: string;
+    skipToContent: string;
+    addTitle: string;
+    addText: string;
+    addImage: string;
+    unknownBlock: string;
+    unknownBlockHint: string;
+    invalidBlock: string;
+    invalidBlockHint: string;
+    newerBlock: string;
+    emptyImage: string;
+    codeSample: string;
+};
+export type BlockLabels = typeof blockLabels;
+/** Turkish dictionary for site blocks. */
+export declare const blockLabelsTr: BlockLabels;
+/** Label lookup for server components: `labels` prop → English. */
+export declare function blockText(labels?: Partial<BlockLabels>, locale?: string): (key: keyof BlockLabels, vars?: Record<string, unknown>) => string;