@vamos-ui/react 0.0.0-stage → 0.2.0

package/dist/blocks/site/shared/labels-2.js

@@ -0,0 +1,427 @@
+// Built-in strings for the registry-2 site blocks (pricing, menu, map & hours, consent, footer…).
+// Server-safe: no context. Blocks take `labels`; `createBlocks({ labels })` binds them once.
+import { formatMessage } from "../../../lib/message-format.js";
+import { blockLabels } from "../../labels.js";
+/** English defaults. */
+export const site2Labels = {
+    // Pricing / comparison
+    billingPeriod: "Billing period",
+    monthly: "Monthly",
+    yearly: "Yearly",
+    perMonth: "/mo",
+    perYear: "/yr",
+    oneOff: "one-off",
+    priceFrom: "from",
+    priceFree: "Free",
+    included: "Included",
+    notIncluded: "Not included",
+    yes: "Yes",
+    no: "No",
+    comparePlans: "Compare plans",
+    showPlan: "Show plan",
+    feature: "Feature",
+    // Testimonials
+    quoteOpen: "“",
+    quoteClose: "”",
+    ratingOutOf: "{rating} out of 5",
+    ratingSummary: "{rating} on {source}",
+    ratingSummaryDirect: "Rated {rating} out of 5",
+    reviewCount: "{count, plural, one {# review} other {# reviews}}",
+    readAllReviews: "Read all reviews",
+    previous: "Previous",
+    next: "Next",
+    slideCounter: "{index} / {total}",
+    slideLabel: "{index} of {total}",
+    carousel: "carousel",
+    slide: "slide",
+    // Team
+    profileOf: "{name} on {network}",
+    // Blog
+    minRead: "{count} min read",
+    noPosts: "No posts here yet",
+    noPostsHint: "New articles land here first. Check back soon.",
+    categories: "Categories",
+    allPosts: "All posts",
+    pagination: "Pagination",
+    previousPage: "Previous page",
+    nextPage: "Next page",
+    pageOf: "Page {page} of {total}",
+    by: "By {name}",
+    // Article
+    onThisPage: "On this page",
+    breadcrumb: "Breadcrumb",
+    tags: "Tags",
+    share: "Share",
+    copyLink: "Copy link",
+    linkCopied: "Link copied",
+    shareOn: "Share on {network}",
+    shareByEmail: "Share by email",
+    updated: "Updated {date}",
+    published: "Published {date}",
+    preview: "Preview",
+    previewNotice: "Draft preview — not visible to visitors.",
+    writtenBy: "Written by",
+    relatedPosts: "Related reading",
+    // Contact form
+    fieldName: "Full name",
+    fieldEmail: "Email",
+    fieldPhone: "Phone",
+    fieldCompany: "Company",
+    fieldSubject: "Subject",
+    fieldBudget: "Budget",
+    fieldMessage: "Message",
+    fieldDate: "Preferred date",
+    choose: "Choose…",
+    send: "Send message",
+    sending: "Sending…",
+    sent: "Thanks — your message is in. We usually reply within one working day.",
+    required: "Required",
+    optional: "(optional)",
+    errorRequired: "Please fill in {field}.",
+    errorEmail: "Enter an email address like name@company.com.",
+    errorPhone: "Enter a phone number with country code, e.g. +90 216 000 00 00.",
+    errorTooLong: "Keep {field} under {max} characters.",
+    errorSummary: "{count, plural, one {Fix # field to send the form:} other {Fix # fields to send the form:}}",
+    errorServer: "We couldn’t send your message.",
+    errorServerCall: "Please try again, or call us on {phone}.",
+    privacyRead: "I have read the {link}.",
+    privacyLink: "privacy notice",
+    privacyRequired: "Please confirm you have read the privacy notice.",
+    marketingConsent: "Send me occasional news and offers. I can unsubscribe at any time.",
+    honeypot: "Leave this field empty",
+    contactDetails: "Contact details",
+    address: "Address",
+    phone: "Phone",
+    email: "Email",
+    hours: "Hours",
+    // Map & hours
+    openNow: "Open now",
+    closesAt: "closes at {time}",
+    closingSoon: "Closing soon",
+    closed: "Closed",
+    closedToday: "Closed today",
+    opensAt: "opens {day} at {time}",
+    opensTodayAt: "opens at {time}",
+    open24h: "Open 24 hours",
+    openingHours: "Opening hours",
+    openingHoursOf: "Opening hours, {name}",
+    today: "Today",
+    closedDay: "Closed",
+    loadMap: "Load map",
+    mapOf: "Map of {name}",
+    mapNotice: "The map loads from {provider}, which may set cookies.",
+    rememberChoice: "Always load maps",
+    directions: "Directions",
+    directionsVia: "Directions in {provider}",
+    branches: "Locations",
+    chooseBranch: "Choose a location",
+    call: "Call",
+    callNumber: "Call {phone}",
+    // Menu
+    menuCategories: "Menu sections",
+    unavailable: "Not today",
+    marketPrice: "Market price",
+    allergens: "Allergens",
+    book: "Book",
+    bookService: "Book {service}",
+    tagVegetarian: "Vegetarian",
+    tagVegan: "Vegan",
+    tagGlutenFree: "Gluten-free",
+    tagSpicy: "Spicy",
+    tagNew: "New",
+    tagChefPick: "Chef’s pick",
+    allergen_gluten: "Gluten",
+    allergen_crustaceans: "Crustaceans",
+    allergen_eggs: "Eggs",
+    allergen_fish: "Fish",
+    allergen_peanuts: "Peanuts",
+    allergen_soybeans: "Soy",
+    allergen_milk: "Milk",
+    allergen_nuts: "Tree nuts",
+    allergen_celery: "Celery",
+    allergen_mustard: "Mustard",
+    allergen_sesame: "Sesame",
+    allergen_sulphites: "Sulphites",
+    allergen_lupin: "Lupin",
+    allergen_molluscs: "Molluscs",
+    // Gallery
+    openImage: "Open image {index} of {total}",
+    imageCounter: "{index} / {total}",
+    galleryImages: "{count, plural, one {# photo} other {# photos}}",
+    // Consent
+    cookies: "Cookies",
+    cookieConsent: "Cookie consent",
+    acceptAll: "Accept all",
+    rejectAll: "Reject all",
+    preferences: "Preferences",
+    savePreferences: "Save choices",
+    cookiePreferences: "Cookie preferences",
+    cookiePreferencesLead: "Choose which cookies we may use. Necessary cookies keep the site working and can’t be switched off.",
+    cookiePolicy: "Cookie policy",
+    catNecessary: "Necessary",
+    catNecessaryHint: "Security, load balancing and remembering this choice.",
+    catFunctional: "Functional",
+    catFunctionalHint: "Maps, video players and chat that remember your settings.",
+    catAnalytics: "Analytics",
+    catAnalyticsHint: "Anonymous visit statistics that help us improve pages.",
+    catMarketing: "Marketing",
+    catMarketingHint: "Ad measurement and personalised ads on other sites.",
+    alwaysOn: "Always on",
+    cookieText: "We use necessary cookies to run this site. With your permission we’d also use analytics and marketing cookies. You can change this any time under Cookie settings.",
+    cookieSettings: "Cookie settings",
+    loadContent: "Load {provider}",
+    contentNotice: "This content is hosted by {provider}, which may set cookies.",
+    // Contact dock
+    messageUs: "Message us",
+    messageUsOn: "Message us on {network}",
+    contactActions: "Quick contact",
+    directionsShort: "Directions",
+    booking: "Book",
+    emailShort: "Email",
+    offHours: "We’re closed now — leave a message and we’ll reply in the morning.",
+    // Footer
+    footer: "Footer",
+    footerNav: "Footer",
+    social: "Social media",
+    legal: "Legal",
+    copyright: "© {year} {name}",
+    madeBy: "Site by {name}",
+    newsletter: "Newsletter",
+    newsletterHint: "One email a month. No spam.",
+    emailAddress: "Email address",
+    subscribe: "Subscribe",
+    subscribed: "Thanks — check your inbox to confirm.",
+    // 404
+    notFoundCode: "Error 404",
+    notFoundTitle: "This page moved, or never *existed*.",
+    notFoundText: "The link may be old or mistyped. Try the pages below, or search the site.",
+    serverErrorCode: "Error 500",
+    serverErrorTitle: "Something went *wrong* on our side.",
+    serverErrorText: "The page didn’t load. It’s usually temporary — try again in a moment.",
+    maintenanceCode: "Maintenance",
+    maintenanceTitle: "We’ll be *back* shortly.",
+    maintenanceText: "We’re updating the site. Bookings by phone work as usual.",
+    backHome: "Back to home",
+    tryAgain: "Try again",
+    search: "Search",
+    searchSite: "Search the site",
+    searchPlaceholder: "What were you looking for?",
+    popularPages: "Popular pages",
+    stillStuck: "Still stuck? Call {phone}.",
+};
+/** Turkish dictionary. Legal-flavoured texts are neutral templates — review with counsel. */
+export const site2LabelsTr = {
+    billingPeriod: "Ödeme dönemi",
+    monthly: "Aylık",
+    yearly: "Yıllık",
+    perMonth: "/ay",
+    perYear: "/yıl",
+    oneOff: "tek sefer",
+    priceFrom: "başlayan",
+    priceFree: "Ücretsiz",
+    included: "Dahil",
+    notIncluded: "Dahil değil",
+    yes: "Evet",
+    no: "Hayır",
+    comparePlans: "Paketleri karşılaştırın",
+    showPlan: "Paketi göster",
+    feature: "Özellik",
+    quoteOpen: "“",
+    quoteClose: "”",
+    ratingOutOf: "5 üzerinden {rating}",
+    ratingSummary: "{source} puanı {rating}",
+    ratingSummaryDirect: "5 üzerinden {rating} puan",
+    reviewCount: "{count} yorum",
+    readAllReviews: "Tüm yorumları okuyun",
+    previous: "Önceki",
+    next: "Sonraki",
+    slideCounter: "{index} / {total}",
+    slideLabel: "{index} / {total}",
+    carousel: "kaydırmalı liste",
+    slide: "slayt",
+    profileOf: "{name}, {network}",
+    minRead: "{count} dk okuma",
+    noPosts: "Henüz yazı yok",
+    noPostsHint: "Yeni yazılar ilk burada yayımlanır. Yakında tekrar bakın.",
+    categories: "Kategoriler",
+    allPosts: "Tüm yazılar",
+    pagination: "Sayfalama",
+    previousPage: "Önceki sayfa",
+    nextPage: "Sonraki sayfa",
+    pageOf: "Sayfa {page} / {total}",
+    by: "Yazan: {name}",
+    onThisPage: "Bu sayfada",
+    breadcrumb: "Sayfa yolu",
+    tags: "Etiketler",
+    share: "Paylaş",
+    copyLink: "Bağlantıyı kopyala",
+    linkCopied: "Bağlantı kopyalandı",
+    shareOn: "{network} üzerinde paylaş",
+    shareByEmail: "E-postayla paylaş",
+    updated: "Güncellendi: {date}",
+    published: "Yayımlandı: {date}",
+    preview: "Önizleme",
+    previewNotice: "Taslak önizlemesi — ziyaretçiler göremez.",
+    writtenBy: "Yazar",
+    relatedPosts: "İlgili yazılar",
+    fieldName: "Ad soyad",
+    fieldEmail: "E-posta",
+    fieldPhone: "Telefon",
+    fieldCompany: "Şirket",
+    fieldSubject: "Konu",
+    fieldBudget: "Bütçe",
+    fieldMessage: "Mesaj",
+    fieldDate: "Tercih edilen tarih",
+    choose: "Seçin…",
+    send: "Mesajı gönder",
+    sending: "Gönderiliyor…",
+    sent: "Teşekkürler — mesajınız bize ulaştı. Genellikle bir iş günü içinde dönüyoruz.",
+    required: "Zorunlu",
+    optional: "(isteğe bağlı)",
+    errorRequired: "Lütfen {field} alanını doldurun.",
+    errorEmail: "ad@sirket.com gibi bir e-posta adresi girin.",
+    errorPhone: "Ülke koduyla bir telefon girin, ör. +90 216 000 00 00.",
+    errorTooLong: "{field} en fazla {max} karakter olabilir.",
+    errorSummary: "Formu göndermek için {count} alanı düzeltin:",
+    errorServer: "Mesajınız gönderilemedi.",
+    errorServerCall: "Lütfen tekrar deneyin ya da {phone} numarasından bizi arayın.",
+    privacyRead: "{link} metnini okudum.",
+    privacyLink: "KVKK aydınlatma",
+    privacyRequired: "Lütfen aydınlatma metnini okuduğunuzu onaylayın.",
+    marketingConsent: "Ara sıra haber ve kampanya e-postası almak istiyorum. İstediğim zaman ayrılabilirim.",
+    honeypot: "Bu alanı boş bırakın",
+    contactDetails: "İletişim bilgileri",
+    address: "Adres",
+    phone: "Telefon",
+    email: "E-posta",
+    hours: "Çalışma saatleri",
+    openNow: "Şu an açık",
+    closesAt: "{time}’de kapanıyor",
+    closingSoon: "Birazdan kapanıyor",
+    closed: "Kapalı",
+    closedToday: "Bugün kapalı",
+    opensAt: "{day} {time}’de açılıyor",
+    opensTodayAt: "{time}’de açılıyor",
+    open24h: "24 saat açık",
+    openingHours: "Çalışma saatleri",
+    openingHoursOf: "Çalışma saatleri, {name}",
+    today: "Bugün",
+    closedDay: "Kapalı",
+    loadMap: "Haritayı yükle",
+    mapOf: "{name} haritası",
+    mapNotice: "Harita {provider} üzerinden yüklenir ve çerez bırakabilir.",
+    rememberChoice: "Haritaları her zaman yükle",
+    directions: "Yol tarifi",
+    directionsVia: "{provider} ile yol tarifi",
+    branches: "Şubeler",
+    chooseBranch: "Şube seçin",
+    call: "Ara",
+    callNumber: "Ara: {phone}",
+    menuCategories: "Menü bölümleri",
+    unavailable: "Bugün yok",
+    marketPrice: "Güncel fiyat",
+    allergens: "Alerjenler",
+    book: "Randevu",
+    bookService: "{service} için randevu",
+    tagVegetarian: "Vejetaryen",
+    tagVegan: "Vegan",
+    tagGlutenFree: "Glutensiz",
+    tagSpicy: "Acılı",
+    tagNew: "Yeni",
+    tagChefPick: "Şefin seçimi",
+    allergen_gluten: "Gluten",
+    allergen_crustaceans: "Kabuklular",
+    allergen_eggs: "Yumurta",
+    allergen_fish: "Balık",
+    allergen_peanuts: "Yer fıstığı",
+    allergen_soybeans: "Soya",
+    allergen_milk: "Süt",
+    allergen_nuts: "Sert kabuklu yemişler",
+    allergen_celery: "Kereviz",
+    allergen_mustard: "Hardal",
+    allergen_sesame: "Susam",
+    allergen_sulphites: "Sülfitler",
+    allergen_lupin: "Acı bakla",
+    allergen_molluscs: "Yumuşakçalar",
+    openImage: "Görsel {index} / {total} aç",
+    imageCounter: "{index} / {total}",
+    galleryImages: "{count} fotoğraf",
+    cookies: "Çerezler",
+    cookieConsent: "Çerez izni",
+    acceptAll: "Tümünü kabul et",
+    rejectAll: "Tümünü reddet",
+    preferences: "Tercihler",
+    savePreferences: "Seçimleri kaydet",
+    cookiePreferences: "Çerez tercihleri",
+    cookiePreferencesLead: "Hangi çerezleri kullanabileceğimizi seçin. Zorunlu çerezler sitenin çalışması için gereklidir ve kapatılamaz.",
+    cookiePolicy: "Çerez politikası",
+    catNecessary: "Zorunlu",
+    catNecessaryHint: "Güvenlik, yük dengeleme ve bu tercihin hatırlanması.",
+    catFunctional: "İşlevsel",
+    catFunctionalHint: "Ayarlarınızı hatırlayan harita, video ve sohbet araçları.",
+    catAnalytics: "Analitik",
+    catAnalyticsHint: "Sayfaları iyileştirmemize yardım eden anonim ziyaret istatistikleri.",
+    catMarketing: "Pazarlama",
+    catMarketingHint: "Reklam ölçümü ve başka sitelerde kişiselleştirilmiş reklamlar.",
+    alwaysOn: "Her zaman açık",
+    cookieText: "Sitenin çalışması için zorunlu çerezler kullanıyoruz. İzin verirseniz analitik ve pazarlama çerezleri de kullanırız. Tercihinizi Çerez ayarları’ndan dilediğiniz zaman değiştirebilirsiniz.",
+    cookieSettings: "Çerez ayarları",
+    loadContent: "{provider} içeriğini yükle",
+    contentNotice: "Bu içerik {provider} tarafından sunulur ve çerez bırakabilir.",
+    messageUs: "Bize yazın",
+    messageUsOn: "{network} üzerinden bize yazın",
+    contactActions: "Hızlı iletişim",
+    directionsShort: "Yol tarifi",
+    booking: "Rezervasyon",
+    emailShort: "E-posta",
+    offHours: "Şu an kapalıyız — mesaj bırakın, sabah dönelim.",
+    footer: "Alt bilgi",
+    footerNav: "Alt menü",
+    social: "Sosyal medya",
+    legal: "Yasal",
+    copyright: "© {year} {name}",
+    madeBy: "Site: {name}",
+    newsletter: "Bülten",
+    newsletterHint: "Ayda bir e-posta. Spam yok.",
+    emailAddress: "E-posta adresi",
+    subscribe: "Abone ol",
+    subscribed: "Teşekkürler — onay için gelen kutunuza bakın.",
+    notFoundCode: "Hata 404",
+    notFoundTitle: "Bu sayfa taşındı ya da hiç *olmadı*.",
+    notFoundText: "Bağlantı eski ya da hatalı yazılmış olabilir. Aşağıdaki sayfalara bakın veya sitede arayın.",
+    serverErrorCode: "Hata 500",
+    serverErrorTitle: "Bizim tarafta bir şeyler *ters* gitti.",
+    serverErrorText: "Sayfa yüklenemedi. Genellikle geçicidir — birazdan tekrar deneyin.",
+    maintenanceCode: "Bakım",
+    maintenanceTitle: "Birazdan *döneceğiz*.",
+    maintenanceText: "Siteyi güncelliyoruz. Telefonla rezervasyon her zamanki gibi çalışıyor.",
+    backHome: "Ana sayfaya dön",
+    tryAgain: "Tekrar dene",
+    search: "Ara",
+    searchSite: "Sitede ara",
+    searchPlaceholder: "Ne arıyordunuz?",
+    popularPages: "Sık ziyaret edilenler",
+    stillStuck: "Hâlâ bulamadınız mı? {phone} numarasını arayın.",
+};
+/** Label lookup for server components: `labels` prop → English. */
+export function site2Text(labels, locale = "en-US") {
+    const merged = { ...blockLabels, ...site2Labels };
+    if (labels)
+        for (const [k, v] of Object.entries(labels))
+            if (typeof v === "string")
+                merged[k] = v;
+    return (key, vars) => formatMessage(merged[key] ?? String(key), vars, locale);
+}
+/**
+ * The raw (unformatted) templates for some keys, with overrides applied — plain strings that can
+ * cross the RSC boundary into a client island, which formats them with `formatMessage`.
+ */
+export function labelTemplates(labels, keys) {
+    const base = { ...blockLabels, ...site2Labels };
+    const out = {};
+    for (const k of keys) {
+        const v = labels ? labels[k] : undefined;
+        out[k] = typeof v === "string" ? v : (base[k] ?? String(k));
+    }
+    return out;
+}

package/dist/blocks/site/shared/open-now.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import { type OpeningHours } from "./opening-hours.js";
+import type { OpenNowLabels } from "./island-keys.js";
+export type { OpenNowLabels };
+export interface OpenNowProps {
+    hours: OpeningHours;
+    labels: OpenNowLabels;
+    locale?: string;
+    /** "Closing soon" threshold. Default 60 minutes. */
+    soonMinutes?: number;
+    /** Fixed "now" (tests, previews, screenshots). Without it the status follows the clock. */
+    now?: string | number;
+    /** `badge`: dot + text. `text`: text only. Default `"badge"`. */
+    appearance?: "badge" | "text";
+    className?: string;
+}
+/**
+ * "Open now · closes at 22:00" — computed in the business's time zone on the client, refreshed
+ * every minute. Renders nothing on the server and without JS: a cached page never shows a stale
+ * status. ~1 KB.
+ */
+export declare function OpenNow({ hours, labels, locale, soonMinutes, now, appearance, className }: OpenNowProps): React.JSX.Element | null;

package/dist/blocks/site/shared/open-now.js

@@ -0,0 +1,27 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as React from "react";
+import { cn2 as cn } from "./kit-2.js";
+import { describeStatus, hoursStatus } from "./opening-hours.js";
+/**
+ * "Open now · closes at 22:00" — computed in the business's time zone on the client, refreshed
+ * every minute. Renders nothing on the server and without JS: a cached page never shows a stale
+ * status. ~1 KB.
+ */
+export function OpenNow({ hours, labels, locale = "en-US", soonMinutes, now, appearance = "badge", className }) {
+    const [at, setAt] = React.useState(null);
+    React.useEffect(() => {
+        if (now !== undefined) {
+            setAt(new Date(now).getTime());
+            return;
+        }
+        setAt(Date.now());
+        const id = window.setInterval(() => setAt(Date.now()), 60_000);
+        return () => window.clearInterval(id);
+    }, [now]);
+    if (at === null)
+        return null;
+    const status = hoursStatus(hours, at, { soonMinutes });
+    const { head, tail } = describeStatus(status, labels, locale);
+    return (_jsxs("span", { "data-open-state": status.state, className: cn("vb-open-now inline-flex items-center gap-2 text-small", className), children: [appearance === "badge" ? _jsx("span", { "aria-hidden": true, className: "vb-open-dot size-2 shrink-0 rounded-full" }) : null, _jsxs("span", { children: [_jsx("span", { className: "font-medium text-fg", children: head }), tail ? _jsxs("span", { className: "text-fg-muted", children: [" \u00B7 ", tail] }) : null] })] }));
+}

package/dist/blocks/site/shared/opening-hours.d.ts

@@ -0,0 +1,117 @@
+import type { OpeningHours, TimeRange, Weekday } from "../../schema/types.js";
+export type { OpeningHours, TimeRange, Weekday };
+/** Monday-first, the ISO order. */
+export declare const WEEKDAYS: readonly Weekday[];
+/** Wall-clock parts of an instant in a time zone. */
+export interface ZonedMoment {
+    /** `YYYY-MM-DD` in the business's zone. */
+    date: string;
+    weekday: Weekday;
+    /** Minutes since local midnight. */
+    minutes: number;
+}
+/** The wall-clock date, weekday and minute of `at` in `timeZone`. */
+export declare function zonedMoment(at: Date | number | string, timeZone: string): ZonedMoment;
+/** "09:30" → 570; "24:00" → 1440. */
+export declare const toMinutes: (hhmm: string) => number;
+/** Calendar arithmetic on `YYYY-MM-DD` strings (UTC-anchored, never shifts a day). */
+export declare function addDays(date: string, n: number): string;
+/** The weekday of a `YYYY-MM-DD` date. */
+export declare function weekdayOf(date: string): Weekday;
+/** What applies on one calendar day: the special-day override, or the weekly ranges. */
+export interface DayHours {
+    date: string;
+    weekday: Weekday;
+    ranges: TimeRange[];
+    closed: boolean;
+    /** The special-day entry that replaced the weekly hours. */
+    special?: {
+        note?: string;
+    };
+}
+/** Hours for one date (special days win over the weekly schedule). */
+export declare function hoursOn(hours: OpeningHours, date: string): DayHours;
+/** True when the business is open at `at` (default now). Handles past-midnight and special days. */
+export declare function isOpenAt(hours: OpeningHours, at?: Date | number | string): boolean;
+export type OpenState = "open" | "closing-soon" | "closed";
+export interface OpenStatus {
+    state: OpenState;
+    /** When open: local closing time `HH:mm` (absent when open around the clock). */
+    closesAt?: string;
+    /** Minutes until closing / opening. */
+    minutesLeft?: number;
+    /** When closed: the next opening — `dayOffset` 0 = later today, 1 = tomorrow… */
+    opensAt?: {
+        time: string;
+        weekday: Weekday;
+        dayOffset: number;
+        date: string;
+    };
+    /** Open without a break for the next 24 h. */
+    allDay?: boolean;
+    /** Today is a special day (holiday, event). */
+    special?: {
+        closed: boolean;
+        note?: string;
+    };
+    /** The business's local date and weekday. */
+    today: {
+        date: string;
+        weekday: Weekday;
+    };
+}
+/**
+ * Open / closing soon / closed at `at`, with the closing or next opening time.
+ *
+ * ```ts
+ * hoursStatus(hours, new Date()) // { state: "open", closesAt: "22:00", minutesLeft: 95, … }
+ * ```
+ */
+export declare function hoursStatus(hours: OpeningHours, at?: Date | number | string, opts?: {
+    soonMinutes?: number;
+}): OpenStatus;
+/** Weekday name from the locale ("Monday" / "Pazartesi"). */
+export declare function weekdayName(day: Weekday, locale?: string, style?: "long" | "short" | "narrow"): string;
+/** Local `HH:mm` → "9:00 AM" (en-US) / "09:00" (tr). Whole hours drop ":00" in 12-hour locales. */
+export declare function formatTime(hhmm: string, locale?: string): string;
+/** "09:00–22:00" / "9 AM–10 PM". */
+export declare const formatRange: (r: TimeRange, locale?: string) => string;
+/** First day of the week for a locale: 1 = Monday … 7 = Sunday. */
+export declare function weekStartOf(locale?: string): number;
+/** The week in the locale's order (Sunday first for en-US, Monday first for tr). */
+export declare function orderedWeek(locale?: string): Weekday[];
+export interface WeekRow {
+    weekday: Weekday;
+    label: string;
+    ranges: TimeRange[];
+    /** "09:00–22:00, 23:00–02:00", or empty when closed. */
+    text: string;
+    closed: boolean;
+    allDay: boolean;
+    today: boolean;
+    /** The date in this week (when `at` is given) and a special-day note. */
+    date?: string;
+    note?: string;
+}
+/**
+ * The 7 rows of an hours table in locale order. With `at`, rows carry this week's dates, so
+ * special days (holidays) replace the weekly hours, and `today` is marked.
+ */
+export declare function weekRows(hours: OpeningHours, opts?: {
+    locale?: string;
+    at?: Date | number | string;
+    style?: "long" | "short";
+}): WeekRow[];
+/** Consecutive days with identical hours collapsed: [{ days: "Mon–Fri", text: "09:00–18:00" }]. */
+export declare function summarizeHours(hours: OpeningHours, locale?: string): {
+    days: string;
+    text: string;
+    closed: boolean;
+}[];
+/** schema.org `OpeningHoursSpecification[]` for JSON-LD (weekly + special days). */
+export declare function openingHoursJsonLd(hours: OpeningHours): Record<string, unknown>[];
+/** The status sentence: "Open now · closes at 22:00", "Closed · opens Thu at 12:00". */
+export declare function describeStatus(s: OpenStatus, labels: Record<"openNow" | "closesAt" | "closingSoon" | "closed" | "closedToday" | "opensAt" | "opensTodayAt" | "open24h", string>, locale?: string): {
+    head: string;
+    tail?: string;
+};