@lupinum/ginko 0.4.0 → 0.5.0

package/dist/shared/ginko.plW4dLmm.d.mts

@@ -0,0 +1,1622 @@
+import { d as BrickSource, c as Label, f as CollectionBrick, i as TextField, D as DateField, T as Task, M as MarkdownTree, L as Locale, j as SlugField, k as DateRangeField, l as TimeField, m as MarkdownField, n as MoneyField, I as ImageField, o as BooleanField, p as Field, q as RefField, r as ChoiceField, F as Fields, s as Holiday, H as HolidaysOption, t as HolidayCalendar, u as StoredHolidays, v as ListField, h as SingleBrick, N as NumberField } from './ginko.DrkUeYFP.mjs';
+import { R as RouteTemplate } from './ginko.DvPtlHIz.mjs';
+
+/** Options every basics factory takes. */
+interface BasicsOptions {
+    /** Where the content comes from: absent means the Ginko platform (the owner edits it), `'files'` means files in `content/`. */
+    source?: BrickSource;
+    /** Replaces the brick's label in the Studio: a text, or one text per language. */
+    label?: Label;
+}
+
+/** An amount in minor units; `currency` (ISO 4217) defaults to the site's. */
+interface Money {
+    amount: number;
+    currency?: string;
+}
+/** Street, postal code and city as the owner typed them. The postal code is left out of the output when not given. */
+interface PostalAddressInput {
+    street: string;
+    postalCode?: string;
+    city: string;
+    /** ISO country code such as AT or SG. Default: the site's `country`; left out when neither is given. */
+    country?: string;
+}
+declare function postalAddress(a: PostalAddressInput, siteCountry?: string): {
+    addressCountry?: string | undefined;
+    addressLocality: string;
+    postalCode?: string | undefined;
+    '@type': string;
+    streetAddress: string;
+};
+/** schema.org `price` and `priceCurrency`: the amount in major units of its currency (2 decimals for EUR, 0 for JPY). */
+declare function offerPrice(m: Money, siteCurrency: string | undefined): {
+    price: string;
+    priceCurrency: string;
+};
+/**
+ * schema.org Offer for a price of the site's own JSON-LD (a service, a product): `price` and `priceCurrency` as
+ * `offerPrice`. `valueAddedTaxIncluded` (false for net prices) adds a PriceSpecification that says so, so search
+ * engines do not read a net price as the full one; left out, the Offer says nothing about VAT. `unitCode` (UN/CEFACT:
+ * `MON` per month, `ANN` per year) makes it a recurring price: a UnitPriceSpecification for one such unit, so a
+ * subscription's price per month is not read as a one-off price.
+ */
+declare function offerJsonLd(m: Money, siteCurrency: string | undefined, o?: {
+    valueAddedTaxIncluded?: boolean;
+    unitCode?: 'MON' | 'ANN' | (string & {});
+}): {
+    priceSpecification?: {
+        referenceQuantity: {
+            '@type': string;
+            value: number;
+            unitCode: "MON" | "ANN" | (string & {});
+        };
+        valueAddedTaxIncluded?: undefined;
+        price: string;
+        priceCurrency: string;
+        '@type': string;
+    } | {
+        referenceQuantity: {
+            '@type': string;
+            value: number;
+            unitCode: "MON" | "ANN" | (string & {});
+        };
+        valueAddedTaxIncluded: boolean;
+        price: string;
+        priceCurrency: string;
+        '@type': string;
+    } | {
+        valueAddedTaxIncluded?: undefined;
+        price: string;
+        priceCurrency: string;
+        '@type': string;
+    } | {
+        valueAddedTaxIncluded: boolean;
+        price: string;
+        priceCurrency: string;
+        '@type': string;
+    } | undefined;
+    price: string;
+    priceCurrency: string;
+    '@type': string;
+};
+
+declare const noticeFields: () => {
+    text: TextField & {
+        readonly max: 140;
+    };
+    until: DateField & {
+        readonly optional: true;
+        readonly hint: {
+            de: string;
+            en: string;
+        };
+    };
+};
+/** A task of the notices brick; a preset adds its own quick tasks first (the gastro preset: "Fully booked today"). */
+type NoticeTask = Task<ReturnType<typeof noticeFields>>;
+/** @internal The notices with a preset's tasks before the standard ones; sites use `notices()`. */
+declare function noticesBrick(opts: BasicsOptions, first: readonly NoticeTask[]): CollectionBrick<{
+    text: TextField & {
+        readonly max: 140;
+    };
+    until: DateField & {
+        readonly optional: true;
+        readonly hint: {
+            de: string;
+            en: string;
+        };
+    };
+}, undefined>;
+/** At most 5 notices in the owner's order; a notice with `until` leaves the site after that day and is then deleted. */
+declare function notices(opts?: BasicsOptions): CollectionBrick<{
+    text: TextField & {
+        readonly max: 140;
+    };
+    until: DateField & {
+        readonly optional: true;
+        readonly hint: {
+            de: string;
+            en: string;
+        };
+    };
+}, undefined>;
+
+/** Options of `events()`: the detail page per locale. Without `route` the events have no pages (no links, no
+ *  sitemap entries); a site can still list them, and the Studio's Today page still shows the next one. */
+interface EventsOptions extends BasicsOptions {
+    route?: Record<Locale, RouteTemplate>;
+}
+/**
+ * @internal The events collection with a preset's booking label and the fields it adds after `start`; sites use
+ * `events()`. The gastro preset adds none, so its stored schema stays as it was.
+ */
+declare function eventsBrick<const E extends Fields, const B extends Fields = Record<never, never>>(opts: EventsOptions, booking: Label, extra: E, afterBooking?: B): CollectionBrick<{
+    title: TextField & {
+        readonly max: 120;
+    };
+    slug: SlugField & {
+        readonly from: "title";
+    };
+    when: DateRangeField;
+    start: TimeField & {
+        readonly optional: true;
+    };
+} & E & {
+    description: MarkdownField & {
+        readonly profile: "basic";
+        readonly max: 5000;
+    };
+    price: MoneyField & {
+        readonly optional: true;
+    };
+    booking: TextField & {
+        readonly format: "url";
+        readonly optional: true;
+    };
+} & B & {
+    image: ImageField & {
+        readonly optional: true;
+    };
+    soldOut: BooleanField & {
+        readonly optional: true;
+    };
+}, Record<string, `/${string}[slug]${string}`>>;
+/**
+ * Events with a detail page: dates, start and end time (site time zone), a place and/or an online address, price,
+ * booking link and "fully booked". An event leaves the site after its last day.
+ */
+declare function events(opts: EventsOptions): CollectionBrick<{
+    title: TextField & {
+        readonly max: 120;
+    };
+    slug: SlugField & {
+        readonly from: "title";
+    };
+    when: DateRangeField;
+    start: TimeField & {
+        readonly optional: true;
+    };
+} & {
+    readonly end: TimeField & {
+        readonly optional: true;
+    };
+    readonly location: TextField & {
+        readonly max: 200;
+        readonly optional: true;
+    };
+    readonly online: TextField & {
+        readonly format: "url";
+        readonly optional: true;
+    };
+} & {
+    description: MarkdownField & {
+        readonly profile: "basic";
+        readonly max: 5000;
+    };
+    price: MoneyField & {
+        readonly optional: true;
+    };
+    booking: TextField & {
+        readonly format: "url";
+        readonly optional: true;
+    };
+} & {
+    readonly bookingUntil: DateField & {
+        readonly optional: true;
+        readonly hint: {
+            de: string;
+            en: string;
+        };
+    };
+} & {
+    image: ImageField & {
+        readonly optional: true;
+    };
+    soldOut: BooleanField & {
+        readonly optional: true;
+    };
+}, Record<string, `/${string}[slug]${string}`>>;
+/** A session's state: it takes place, it is fully booked, or it is cancelled. */
+type SessionStatus = 'open' | 'soldOut' | 'cancelled';
+declare function sessionsBrick<S extends Field>(opts: BasicsOptions & {
+    events?: string;
+}, speakers: S): CollectionBrick<{
+    readonly event: RefField & {
+        multiple?: false;
+    } & {
+        readonly to: string;
+    };
+    readonly date: DateField & Omit<DateField, "default" | "type" | "label" | "pos" | "retired"> & {
+        default?: string | undefined;
+    };
+    readonly from: TimeField & Omit<TimeField, "default" | "type" | "label" | "pos" | "retired"> & {
+        default?: string | undefined;
+    };
+    readonly to: TimeField & {
+        readonly after: "from";
+    };
+    readonly title: TextField & {
+        readonly max: 120;
+    };
+    readonly summary: TextField & {
+        readonly max: 200;
+        readonly optional: true;
+    };
+    readonly room: TextField & {
+        readonly max: 80;
+        readonly optional: true;
+    };
+    readonly speakers: S;
+    readonly status: ChoiceField<"soldOut" | "open" | "cancelled"> & Omit<{
+        readonly options: readonly [{
+            readonly value: "open";
+            readonly label: {
+                de: string;
+                en: string;
+            };
+        }, {
+            readonly value: "soldOut";
+            readonly label: {
+                de: string;
+                en: string;
+            };
+        }, {
+            readonly value: "cancelled";
+            readonly label: {
+                de: string;
+                en: string;
+            };
+        }];
+        readonly default: "open";
+    }, "options">;
+}, undefined>;
+/**
+ * The programme of events: one entry per session, with its event (`events`: the key of the events brick, default
+ * `events`), date, start and end time (site time zone; the end after the start), room, speakers and status. Speakers
+ * are entries of the people collection named by `people`, or a text without it. A session leaves the site after its day.
+ * The bundle orders sessions by date only: a page that lists them (a programme, "now" and "next") sorts them with
+ * `sessionsInOrder`.
+ */
+declare function sessions(opts: BasicsOptions & {
+    events?: string;
+    people: string;
+}): ReturnType<typeof sessionsBrick<ReturnType<typeof speakerRefs>>>;
+declare function sessions(opts?: BasicsOptions & {
+    events?: string;
+    people?: undefined;
+}): ReturnType<typeof sessionsBrick<ReturnType<typeof speakerText>>>;
+declare const speakerRefs: (people: string) => RefField & {
+    multiple: true;
+} & {
+    readonly to: string;
+    readonly max: 10;
+    readonly optional: true;
+};
+declare const speakerText: () => TextField & {
+    readonly max: 200;
+    readonly optional: true;
+};
+/** Sessions by date, then start time, then title: the order of a programme. */
+declare function sessionsInOrder<S extends {
+    data: {
+        date: string;
+        from: string;
+        title?: unknown;
+    };
+}>(items: readonly S[]): S[];
+/** One session for `eventJsonLd`. */
+interface SessionJsonLdInput {
+    title: string;
+    date: string;
+    from: string;
+    to: string;
+    room?: string;
+    /** Names of the speakers. */
+    speakers?: string[];
+    status?: SessionStatus;
+}
+interface EventJsonLdInput {
+    title: string;
+    /** Absolute URL of the event page. */
+    url: string;
+    /** The days of the event (YYYY-MM-DD). */
+    when: {
+        from: string;
+        to: string;
+    };
+    /** Start time of the first day (`HH:MM`, site time zone). */
+    start?: string;
+    /** End time of the last day (`HH:MM`, site time zone). */
+    end?: string;
+    /** The site's IANA time zone: times are written with its offset on that day (`+01:00` in winter in Vienna). */
+    timeZone: string;
+    /** Where it takes place. With `online` too, the event is mixed. */
+    location?: {
+        name: string;
+        address?: PostalAddressInput;
+    };
+    /** Address where people join online. */
+    online?: string;
+    /** The site's country, the address's country when it has none. */
+    country?: string;
+    description?: MarkdownTree;
+    /** Absolute URL of the image. */
+    image?: string;
+    price?: Money;
+    /** The site’s currency (ISO 4217), used for a price that carries none. There is no default. */
+    currency?: string;
+    /** Absolute URL where visitors book. Left out when the event is fully booked. */
+    booking?: string;
+    /** Fully booked: the offer says `SoldOut` and has no booking link. */
+    soldOut?: boolean;
+    /** The programme: each session becomes a `subEvent`. */
+    sessions?: SessionJsonLdInput[];
+}
+/** schema.org Event for one event. Offers are given with a price, or to say it is fully booked. */
+declare function eventJsonLd(input: EventJsonLdInput): Record<string, unknown>;
+
+declare const weekdayKeys: readonly ["mo", "tu", "we", "th", "fr", "sa", "su"];
+type Weekday = (typeof weekdayKeys)[number];
+/** Weekday key of a YYYY-MM-DD date. */
+declare function weekdayOf(date: string): Weekday;
+
+interface HolidayNames {
+    de: string;
+    en: string;
+}
+declare function austrianHolidays(year: number): Holiday[];
+/**
+ * German nationwide public holidays only (9 days). Regional ones are NOT included: Heilige Drei Könige,
+ * Fronleichnam, Mariä Himmelfahrt, Reformationstag, Allerheiligen, Buß- und Bettag, Frauentag and others.
+ * Pass your own calendar function as `calendar` when the state has more.
+ */
+declare function germanHolidays(year: number): Holiday[];
+declare function singaporeHolidays(year: number): Holiday[];
+/** The calendar function for a name or a custom function. */
+declare function calendarOf(option: HolidaysOption): HolidayCalendar;
+
+interface Times {
+    from1?: string;
+    to1?: string;
+    from2?: string;
+    to2?: string;
+}
+interface DayHours extends Times {
+    day: string;
+    closed: boolean;
+}
+/** An exception without times is a closure; with times and `closed: false` it is special hours. */
+interface Exception extends Times {
+    _id: string;
+    when: {
+        from: string;
+        to: string;
+    };
+    reason: string;
+    closed: boolean;
+}
+/** A public holiday on which the house is closed, listed with the closures (see `upcomingClosures`). Guests read its name in their language from `holiday`. */
+interface HolidayClosure {
+    _id: string;
+    when: {
+        from: string;
+        to: string;
+    };
+    closed: true;
+    holiday: HolidayNames;
+}
+/** A date range with its own week: a season ("yearly") or "new hours from a date". */
+interface HourPlan {
+    _id?: string;
+    id?: string;
+    label?: string;
+    from: string;
+    to?: string;
+    yearly?: boolean;
+    week: DayHours[];
+}
+type HolidaySetting = 'sunday' | 'closed' | 'normal';
+interface HoursData {
+    week: DayHours[];
+    exceptions: Exception[];
+    closedOn?: string;
+    closedNote?: string;
+    holidays?: HolidaySetting;
+}
+interface Span {
+    from: string;
+    to: string;
+}
+declare function spansOf(t: Times): Span[];
+declare function spansText(spans: Span[], and: string): string;
+/** The opening times of one weekday as text: `11:30–14:00 and 17:30–22:00` with `and` = "and". Empty when closed. */
+declare function timesOf(day: DayHours | undefined, and: string): string;
+/** The public holiday on `date` in `calendar`. */
+declare function holidayOn(date: string, calendar: HolidaysOption): Holiday | undefined;
+type HoursSource = 'today' | 'exception' | 'holiday' | 'plan' | 'week';
+interface DayRule {
+    closed: boolean;
+    times: Span[];
+    /** The owner's text: the "closed today" note or the exception's reason. */
+    reason?: string;
+    source: HoursSource;
+    /** Bundle path of the reason's text, so the page can set its language (closedNote, exception reason). */
+    field?: string;
+    /** Set when a public holiday decided the result: its name in German and English. */
+    holiday?: HolidayNames;
+}
+interface HoursContext {
+    hours: HoursData;
+    plans?: HourPlan[];
+    /** Which public holidays count. Code-level config of the site, not an owner setting; wins over `country`. */
+    calendar?: HolidaysOption;
+    /**
+     * The site's country (`useRuntimeConfig().public.ginko.country`): its calendar counts when `calendar` is not given.
+     * Neither given (or a country without a calendar): no public holidays.
+     */
+    country?: string;
+}
+/** The calendar of a context: `calendar`, else the one of `country`, else none. */
+declare function calendarIn(ctx: Pick<HoursContext, 'calendar' | 'country'>): HolidaysOption;
+/** The plan that applies on `date`: the one with the latest `from` wins. */
+declare function planOn(plans: HourPlan[] | undefined, date: string): HourPlan | undefined;
+/** The 7-day plan that applies on `date`: a covering plan, else the standard week. */
+declare function weekFor(ctx: HoursContext, date: string): {
+    week: DayHours[];
+    plan?: HourPlan;
+};
+/**
+ * What applies on `date`. Order: the owner's "closed today" switch, an exception that covers the
+ * date (closed, or its own times), a public holiday (by the holiday setting), a plan that covers
+ * the date, the standard week.
+ */
+declare function hoursOn(ctx: HoursContext, date: string): DayRule;
+/** The 7 days from `monday`, each with what applies. */
+declare function weekOf(ctx: HoursContext, monday: string): Array<DayRule & {
+    date: string;
+    weekday: Weekday;
+}>;
+/**
+ * `times` are the opening spans; join them with `spansText(times, and)` in the page's language. `field` is the bundle
+ * path of the owner's reason, for its language (closedNote or an exception's reason).
+ */
+type TodayState = {
+    kind: 'open';
+    times: Span[];
+    reason?: string;
+    field?: string;
+} | {
+    kind: 'closed';
+    reason?: string;
+    field: string;
+}
+/** Closed for a public holiday; `holiday` has its name in German and English. */
+ | {
+    kind: 'holiday';
+    holiday: HolidayNames;
+} | {
+    kind: 'restDay';
+};
+/** Whether the house is open on `today`, by `hoursOn`. */
+declare function todayState(ctx: HoursContext, today: string): TodayState;
+/**
+ * The notices to show on `today`. A notice that ends today (`until` is today) is about today, so a closure today wins
+ * over it: on a day the owner closed ("Heute geschlossen" or a closing exception), such a notice ("Heute sind wir
+ * ausgebucht.") is left out. Rest days and public holidays do not hide notices, and notices that end later stay.
+ */
+declare function noticesOn<N extends {
+    data: {
+        until?: string | null;
+    };
+}>(notices: readonly N[], ctx: HoursContext, today: string): N[];
+/**
+ * Public holidays on which the house is closed, starting after `today` and within `days` days. A holiday on a day the
+ * week (or the running plan) closes anyway is left out: it closes nothing the visitor could have come on.
+ */
+declare function upcomingHolidayClosures(ctx: HoursContext, today: string, days: number): HolidayClosure[];
+/**
+ * The day set in "closed on" (`closedOn`) as a closure, when it is after `today`: `_id` `'closedOn'`, its note as
+ * `reason`, `field` `'closedNote'`. A closure today is today's state (`todayState`); a past day no longer counts.
+ */
+declare function closedOnClosure(hours: Pick<HoursData, 'closedOn' | 'closedNote'>, today: string): (Exception & {
+    field: string;
+}) | undefined;
+/**
+ * Closures that start after `today` and within `days` days: the owner's closing exceptions, the day set in "closed
+ * on" (`closedOnClosure`), and the public holidays that close the house (by `calendarIn(ctx)`). A holiday entry has
+ * `holiday` instead of `reason`. An owner's closure has `field`, the bundle path of its reason, so the page can set the
+ * reason's language.
+ */
+declare function upcomingClosures(ctx: HoursContext, today: string, days: number): Array<(Exception & {
+    field: string;
+}) | HolidayClosure>;
+/**
+ * Plans that start after `today` and within `days` days, with their start date (yearly: next occurrence) and, when the
+ * plan has an end, its last day `ends` (yearly: the end of that occurrence).
+ */
+declare function upcomingPlans(plans: HourPlan[], today: string, days: number): Array<{
+    plan: HourPlan;
+    starts: string;
+    ends?: string;
+}>;
+/**
+ * Today's line of the hours (the Studio's status, SPEC templates 7.1): the opening ranges, closed (with the owner's
+ * text in `reason`, or the public holiday in `holiday`), or unknown. Unknown: the data is not hours (no week row for
+ * today), an open day has no times, a site calendar in code (`holidays: 'custom'`) could decide the day and only the
+ * site can run it, or the schema stores no calendar and today is an Austrian public holiday (see `HoursLineContext`).
+ * `calendar`: the hours of today are entered and only a holiday calendar the line cannot run is in the way, so nothing
+ * is missing for the owner to enter.
+ */
+type HoursLine = {
+    state: 'open';
+    ranges: Array<[from: string, to: string]>;
+} | {
+    state: 'closed';
+    reason?: string | Record<string, string>;
+    holiday?: HolidayNames;
+} | {
+    state: 'unknown';
+    calendar?: true;
+};
+interface HoursLineContext {
+    /** The site's IANA time zone: "today" is the date there. */
+    timeZone: string;
+    /** Default: the current time. */
+    now?: Date;
+    /** Entries of the hour plans (`hourPlans()`), if the site has them. */
+    plans?: HourPlan[];
+    /**
+     * `schema.holidays`. Absent: a schema released before `country` existed. Its site may close on Austrian holidays
+     * (the gastro preset's 0.4 default) or on none (the neutral basics), and the schema cannot tell which; on a day where
+     * the two differ the line is unknown rather than wrong.
+     */
+    holidays?: StoredHolidays;
+}
+/** `hours` (the single of `hours()`) today in the site's time zone; see `HoursLine`. */
+declare function hoursLine(data: unknown, ctx: HoursLineContext): HoursLine;
+
+/** Options of `hours()`. */
+interface HoursOptions extends BasicsOptions {
+    /**
+     * The key of the site's hour plans (`hourPlans()`), for example `'hourPlans'`. The Studio's line for today then follows
+     * the plan that applies today. The release check refuses a key that is not a collection of hour plans.
+     */
+    plans?: string;
+}
+declare const weekdays: readonly [{
+    readonly value: "mo";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "tu";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "we";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "th";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "fr";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "sa";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}, {
+    readonly value: "su";
+    readonly label: {
+        de: string;
+        en: string;
+    };
+}];
+/** One row of the default week. Row IDs are fixed so every fresh site starts with the same, stable rows. */
+interface WeekRow {
+    _id: string;
+    day: (typeof weekdays)[number]['value'];
+    closed: boolean;
+    from1?: string;
+    to1?: string;
+    from2?: string;
+    to2?: string;
+}
+/** Every text of the two hours bricks. A preset pins its own (the gastro preset keeps its restaurant wording). */
+interface HoursTexts {
+    hours: Label;
+    week: Label;
+    day: Label;
+    closed: Label;
+    opens: Label;
+    closes: Label;
+    opensAgain: Label;
+    opensAgainHint: Label;
+    closesAgain: Label;
+    exceptions: Label;
+    exception: Label;
+    dates: Label;
+    reason: Label;
+    reasonHint: Label;
+    exceptionClosed: Label;
+    closedOn: Label;
+    closedOnHint: Label;
+    closedNote: Label;
+    closedNoteHint: Label;
+    noticeDays: Label;
+    noticeDaysHint: Label;
+    holidays: Label;
+    holidaySunday: Label;
+    holidayClosed: Label;
+    holidayNormal: Label;
+    holidaysHint: Label;
+    closedToday: Label;
+    holidaySetting: Label;
+    plans: Label;
+    planName: Label;
+    planFrom: Label;
+    planTo: Label;
+    yearly: Label;
+    planAdd: Label;
+    planEdit: Label;
+    planRemove: Label;
+}
+/** @internal The hours single with a preset's texts and default week; sites use `hours()`. */
+declare function hoursBrick(t: HoursTexts, week: readonly WeekRow[], opts: HoursOptions): SingleBrick<{
+    readonly week: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+            readonly options: readonly [{
+                readonly value: "mo";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "tu";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "we";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "th";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "fr";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "sa";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "su";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }];
+        }, "options">;
+        readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: boolean | undefined;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+                readonly options: readonly [{
+                    readonly value: "mo";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "tu";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "we";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "th";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "fr";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "sa";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "su";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }];
+            }, "options">;
+            readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: boolean | undefined;
+            };
+        };
+        readonly min: 7;
+        readonly max: 7;
+        readonly unique: "day";
+        readonly default: readonly WeekRow[];
+    }, "fields">;
+    readonly exceptions: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly when: DateRangeField & Omit<DateRangeField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: {
+                from: string;
+                to: string;
+            } | undefined;
+        };
+        readonly reason: TextField & {
+            readonly max: 140;
+            readonly hint: Label;
+        };
+        readonly closed: BooleanField & {
+            readonly default: true;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly when: DateRangeField & Omit<DateRangeField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: {
+                    from: string;
+                    to: string;
+                } | undefined;
+            };
+            readonly reason: TextField & {
+                readonly max: 140;
+                readonly hint: Label;
+            };
+            readonly closed: BooleanField & {
+                readonly default: true;
+            };
+        };
+        readonly max: 20;
+        readonly default: readonly [];
+    }, "fields">;
+    readonly closedOn: DateField & {
+        readonly optional: true;
+        readonly hint: Label;
+    };
+    readonly closedNote: TextField & {
+        readonly max: 140;
+        readonly optional: true;
+        readonly hint: Label;
+    };
+    readonly holidayNoticeDays: NumberField & {
+        readonly min: 0;
+        readonly max: 60;
+        readonly step: 1;
+        readonly default: 14;
+        readonly hint: Label;
+    };
+    readonly holidays: ChoiceField<"closed" | "sunday" | "normal"> & Omit<{
+        readonly options: readonly [{
+            readonly value: "sunday";
+            readonly label: Label;
+        }, {
+            readonly value: "closed";
+            readonly label: Label;
+        }, {
+            readonly value: "normal";
+            readonly label: Label;
+        }];
+        readonly optional: true;
+        readonly default: "sunday";
+        readonly hint: Label;
+    }, "options">;
+}>;
+/** @internal The hour plans with a preset's texts; sites use `hourPlans()`. */
+declare function hourPlansBrick(t: HoursTexts, week: readonly WeekRow[], opts: BasicsOptions): CollectionBrick<{
+    readonly label: TextField & {
+        readonly max: 80;
+    };
+    readonly from: DateField & Omit<DateField, "default" | "type" | "label" | "pos" | "retired"> & {
+        default?: string | undefined;
+    };
+    readonly to: DateField & {
+        readonly optional: true;
+    };
+    readonly yearly: BooleanField & {
+        readonly default: false;
+    };
+    readonly week: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+            readonly options: readonly [{
+                readonly value: "mo";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "tu";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "we";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "th";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "fr";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "sa";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "su";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }];
+        }, "options">;
+        readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: boolean | undefined;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+                readonly options: readonly [{
+                    readonly value: "mo";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "tu";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "we";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "th";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "fr";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "sa";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "su";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }];
+            }, "options">;
+            readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: boolean | undefined;
+            };
+        };
+        readonly min: 7;
+        readonly max: 7;
+        readonly unique: "day";
+        readonly default: readonly WeekRow[];
+    }, "fields">;
+}, undefined>;
+/**
+ * Weekly hours (two periods a day), closures, a closed day and the owner's choice for public holidays. Which holidays
+ * count is the site's `country` or `calendar`; pass it to the rules (`hoursOn`, `todayState`) as `ctx.country` or `ctx.calendar`.
+ */
+declare function hours(opts?: HoursOptions): SingleBrick<{
+    readonly week: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+            readonly options: readonly [{
+                readonly value: "mo";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "tu";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "we";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "th";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "fr";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "sa";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "su";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }];
+        }, "options">;
+        readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: boolean | undefined;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+                readonly options: readonly [{
+                    readonly value: "mo";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "tu";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "we";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "th";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "fr";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "sa";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "su";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }];
+            }, "options">;
+            readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: boolean | undefined;
+            };
+        };
+        readonly min: 7;
+        readonly max: 7;
+        readonly unique: "day";
+        readonly default: readonly WeekRow[];
+    }, "fields">;
+    readonly exceptions: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly when: DateRangeField & Omit<DateRangeField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: {
+                from: string;
+                to: string;
+            } | undefined;
+        };
+        readonly reason: TextField & {
+            readonly max: 140;
+            readonly hint: Label;
+        };
+        readonly closed: BooleanField & {
+            readonly default: true;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly when: DateRangeField & Omit<DateRangeField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: {
+                    from: string;
+                    to: string;
+                } | undefined;
+            };
+            readonly reason: TextField & {
+                readonly max: 140;
+                readonly hint: Label;
+            };
+            readonly closed: BooleanField & {
+                readonly default: true;
+            };
+        };
+        readonly max: 20;
+        readonly default: readonly [];
+    }, "fields">;
+    readonly closedOn: DateField & {
+        readonly optional: true;
+        readonly hint: Label;
+    };
+    readonly closedNote: TextField & {
+        readonly max: 140;
+        readonly optional: true;
+        readonly hint: Label;
+    };
+    readonly holidayNoticeDays: NumberField & {
+        readonly min: 0;
+        readonly max: 60;
+        readonly step: 1;
+        readonly default: 14;
+        readonly hint: Label;
+    };
+    readonly holidays: ChoiceField<"closed" | "sunday" | "normal"> & Omit<{
+        readonly options: readonly [{
+            readonly value: "sunday";
+            readonly label: Label;
+        }, {
+            readonly value: "closed";
+            readonly label: Label;
+        }, {
+            readonly value: "normal";
+            readonly label: Label;
+        }];
+        readonly optional: true;
+        readonly default: "sunday";
+        readonly hint: Label;
+    }, "options">;
+}>;
+/** Own weekly hours for a date range: a season (yearly) or "new hours from a date" (open end). */
+declare function hourPlans(opts?: BasicsOptions): CollectionBrick<{
+    readonly label: TextField & {
+        readonly max: 80;
+    };
+    readonly from: DateField & Omit<DateField, "default" | "type" | "label" | "pos" | "retired"> & {
+        default?: string | undefined;
+    };
+    readonly to: DateField & {
+        readonly optional: true;
+    };
+    readonly yearly: BooleanField & {
+        readonly default: false;
+    };
+    readonly week: ListField<{
+        readonly from1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly to1: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly from2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+            readonly hint: Label;
+        };
+        readonly to2: TimeField & {
+            readonly optional: true;
+            readonly showWhen: {
+                readonly field: "closed";
+                readonly not: true;
+            };
+        };
+        readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+            readonly options: readonly [{
+                readonly value: "mo";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "tu";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "we";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "th";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "fr";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "sa";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }, {
+                readonly value: "su";
+                readonly label: {
+                    de: string;
+                    en: string;
+                };
+            }];
+        }, "options">;
+        readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+            default?: boolean | undefined;
+        };
+    }> & Omit<{
+        readonly itemLabel: Label;
+        readonly fields: {
+            readonly from1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly to1: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly from2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+                readonly hint: Label;
+            };
+            readonly to2: TimeField & {
+                readonly optional: true;
+                readonly showWhen: {
+                    readonly field: "closed";
+                    readonly not: true;
+                };
+            };
+            readonly day: ChoiceField<"fr" | "th" | "mo" | "tu" | "we" | "sa" | "su"> & Omit<{
+                readonly options: readonly [{
+                    readonly value: "mo";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "tu";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "we";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "th";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "fr";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "sa";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }, {
+                    readonly value: "su";
+                    readonly label: {
+                        de: string;
+                        en: string;
+                    };
+                }];
+            }, "options">;
+            readonly closed: BooleanField & Omit<BooleanField, "default" | "type" | "label" | "pos" | "retired"> & {
+                default?: boolean | undefined;
+            };
+        };
+        readonly min: 7;
+        readonly max: 7;
+        readonly unique: "day";
+        readonly default: readonly WeekRow[];
+    }, "fields">;
+}, undefined>;
+
+export { hoursOn as A, notices as C, noticesOn as F, offerJsonLd as G, planOn as I, sessions as J, sessionsInOrder as K, singaporeHolidays as L, spansOf as M, spansText as N, timesOf as O, todayState as P, upcomingClosures as Q, upcomingHolidayClosures as R, upcomingPlans as U, weekFor as V, weekOf as X, weekdayOf as Y, eventsBrick as a1, hourPlansBrick as a2, hoursBrick as a3, noticesBrick as a4, offerPrice as a5, postalAddress as a6, weekdays as a7, austrianHolidays as p, calendarIn as q, calendarOf as r, closedOnClosure as s, eventJsonLd as t, events as u, germanHolidays as v, holidayOn as w, hourPlans as x, hours as y, hoursLine as z };
+export type { PostalAddressInput as $, BasicsOptions as B, DayHours as D, EventJsonLdInput as E, HoursContext as H, SessionJsonLdInput as S, Times as T, Weekday as W, HoursTexts as Z, NoticeTask as _, DayRule as a, WeekRow as a0, EventsOptions as b, Exception as c, HolidayClosure as d, HolidayNames as e, HolidaySetting as f, HourPlan as g, HoursData as h, HoursLine as i, HoursLineContext as j, HoursOptions as k, HoursSource as l, SessionStatus as m, Span as n, TodayState as o };