@lupinum/ginko 0.4.0 → 0.5.0

package/dist/shared/{ginko.akHewCGt.d.mts → ginko.DvPtlHIz.d.mts}

@@ -1,5 +1,5 @@
-import { b as Msg, S as Schema, F as Fields, J as Json, L as Locale, C as Currency, B as Brick, a as ComponentRegistry, R as RetiredRule, c as Label, d as BrickSource, T as Task, V as Visibility, e as CollectionBrick, f as SingleBrick } from './ginko.D-fNojn9.mjs';
-import { B as Bundle } from './ginko.Bwan3BB-.mjs';
+import { a as Msg, S as Schema, F as Fields, J as Json, L as Locale, C as Currency, H as HolidaysOption, B as Brick, b as ComponentRegistry, R as RetiredRule, c as Label, d as BrickSource, T as Task, V as Visibility, e as CollectionStatus, f as CollectionBrick, g as SingleStatus, h as SingleBrick } from './ginko.DrkUeYFP.mjs';
+import { B as Bundle } from './ginko.6cI8KXZP.mjs';
 
 interface Redirect {
     from: string;
@@ -59,10 +59,12 @@ type Pages = Pick<Schema, 'pages' | 'bricks'>;
 /**
  * The bundle with `$…` links turned into paths and `::snippet` components replaced by their text.
  * `$page.<key>` is a page of `schema.pages`; `$<brick>.<slug-or-id>` is an entry's URL; a `#anchor` is kept.
+ * `main` is the main-language bundle (from `buildBundle`, links unresolved): an entry left out of this locale because
+ * it is not translated (`untranslated: 'hide'`) is found there, and the link goes to its main-language page.
  * What cannot be resolved stays as it is and gets `data-broken: true`. A snippet is the `body` of the entry
  * `snippets/<name>` of the collection `snippets`; a snippet inside a snippet stays as it is. No mutation.
  */
-declare function resolveRouteLinks(bundle: Bundle, schema: Pages): Bundle;
+declare function resolveRouteLinks(bundle: Bundle, schema: Pages, main?: Bundle): Bundle;
 /**
  * Link check over bundles (one per locale) before any HTML exists. Errors: route links and snippets that
  * `resolveRouteLinks` could not resolve, and `/…` paths that match no entry URL, no page and no public file.
@@ -117,6 +119,16 @@ interface SiteInput {
      */
     firstDayOfWeek?: 1 | 2 | 3 | 4 | 5 | 6 | 7;
     currency: Currency;
+    /**
+     * The country of the site (ISO 3166-1 alpha-2, e.g. `AT`). It picks the public-holiday calendar (`calendar`) and is
+     * the default `addressCountry` of JSON-LD. A country Ginko has no calendar for keeps no public holidays (`ginko check` warns).
+     */
+    country?: string;
+    /**
+     * Which public holidays count for opening hours: `AT`, `DE` (nationwide only), `SG`, `none`, or your own function
+     * `(year) => Holiday[]`. Default: the calendar of `country`. Stored in the schema as `holidays` (a function as `custom`).
+     */
+    calendar?: HolidaysOption;
     /**
      * Static pages by key: `{ menu: { de: '/speisekarte', en: '/en/menu' } }`. A plain path is the page in
      * the main locale only. The home page is the page whose main-locale path is `/`. The sitemap pairs a page's locales by key.
@@ -136,6 +148,7 @@ interface SiteInput {
         image?: string;
         /** The brand colour, `#rrggbb` or `#rgb`: the background of generated share cards (nuxt-og-image). */
         color?: string;
+        /** The home page's Organization JSON-LD. A page with its own (`siteJsonLd` of `@lupinum/ginko/basics`) gets none from here. */
         organization?: {
             logo?: string;
             sameAs?: string[];
@@ -170,12 +183,34 @@ type RetiredInput<S extends SiteInput> = {
 declare function defineSite<const S extends SiteInput>(site: S & {
     retired?: RetiredInput<S>;
 }): S;
+/**
+ * `site` as it runs on the platform: every brick without `source`, so the owner edits it in the Studio. A template
+ * that reads its content from files and this twin must both pass `checkSite`; tools and tests use it to prove that a
+ * files site can move to the platform without changing its bricks.
+ */
+declare function withoutFiles<const S extends SiteInput>(site: S): WithoutFiles<S>;
+/** `S` with no `source` on any brick. */
+type WithoutFiles<S extends SiteInput> = Omit<S, 'bricks'> & {
+    bricks: {
+        [K in keyof S['bricks']]: Omit<S['bricks'][K], 'source'>;
+    };
+};
 /** The names of the fields in `F` whose type is one of `T`. */
 type FieldsOfType<F, T extends string> = {
     [K in keyof F]: F[K] extends {
         type: T;
     } ? K : never;
 }[keyof F] & string;
+/**
+ * A planned change of one field (`planned`): from the date in the date field `from` on, `next` replaces `field`. `next`
+ * and `from` are optional and set together; every edit task that changes `field` lists them too. Field names only:
+ * a factory with generic fields could not name its date field otherwise, so `ginko check` reports the other rules.
+ */
+type Planned<F> = {
+    field: keyof F & string;
+    next: keyof F & string;
+    from: keyof F & string;
+};
 /** A collection's detail page per locale: a path with `[slug]` where the entry's slug goes, e.g. `/blog/[slug]`. */
 type RouteTemplate = `/${string}[slug]${string}`;
 declare function single<const F extends Fields>(input: {
@@ -185,6 +220,8 @@ declare function single<const F extends Fields>(input: {
     fields: F;
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task<F>[];
+    planned?: Planned<F>;
+    status?: SingleStatus;
 }): SingleBrick<F>;
 declare function collection<const F extends Fields, const R extends Record<Locale, RouteTemplate> | undefined = undefined>(input: {
     label: Label;
@@ -193,6 +230,8 @@ declare function collection<const F extends Fields, const R extends Record<Local
     fields: F;
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task<F>[];
+    /** A planned change of one field: from the date in `from` on, `next` replaces `field`. */
+    planned?: Planned<F>;
     max: number;
     order: 'manual' | {
         field: keyof F & string;
@@ -200,6 +239,10 @@ declare function collection<const F extends Fields, const R extends Record<Local
     };
     route?: R;
     visible?: Visibility<FieldsOfType<F, 'date' | 'daterange'>>;
+    /**
+     * A required translatable field is missing in a language: `'hide'` (default with a `route`) leaves the entry out
+     * there; `'fallback'` (default without) shows the main language and links to the main-language page.
+     */
     untranslated?: 'fallback' | 'hide';
     /** Entries plan weeks of the single brick `brick`; `field` (a date field of this collection) holds the first day of the week (`firstDayOfWeek`). */
     plans?: {
@@ -207,7 +250,9 @@ declare function collection<const F extends Fields, const R extends Record<Local
         field: FieldsOfType<F, 'date'>;
     };
     drafts?: boolean;
+    /** The status line on the Studio's Today page (see `CollectionStatus`). */
+    status?: CollectionStatus<FieldsOfType<F, 'date' | 'daterange'>, keyof F & string>;
 }): CollectionBrick<F, R>;
 
-export { checkLinks as d, collection as e, defineSite as f, entryRedirects as g, externalLinks as h, findRedirect as i, resolveRouteLinks as j, linkTargets as l, matchRedirect as m, redirectProblems as r, single as s };
-export type { CheckLinksOptions as C, ExternalLink as E, LinkConfig as L, Migration as M, Redirect as R, SiteInput as S, LinkIssue as a, MigrationContext as b, RouteTemplate as c };
+export { checkLinks as d, collection as e, defineSite as f, entryRedirects as g, externalLinks as h, findRedirect as i, resolveRouteLinks as j, linkTargets as l, matchRedirect as m, redirectProblems as r, single as s, withoutFiles as w };
+export type { CheckLinksOptions as C, ExternalLink as E, LinkConfig as L, Migration as M, RouteTemplate as R, SiteInput as S, WithoutFiles as W, LinkIssue as a, MigrationContext as b, Redirect as c };

package/dist/shared/{ginko.BDF3bW0C.d.ts → ginko.EelR5dt9.d.ts}

@@ -1,5 +1,5 @@
-import { b as Msg, S as Schema, F as Fields, J as Json, L as Locale, C as Currency, B as Brick, a as ComponentRegistry, R as RetiredRule, c as Label, d as BrickSource, T as Task, V as Visibility, e as CollectionBrick, f as SingleBrick } from './ginko.D-fNojn9.js';
-import { B as Bundle } from './ginko.BBkZW2nW.js';
+import { a as Msg, S as Schema, F as Fields, J as Json, L as Locale, C as Currency, H as HolidaysOption, B as Brick, b as ComponentRegistry, R as RetiredRule, c as Label, d as BrickSource, T as Task, V as Visibility, e as CollectionStatus, f as CollectionBrick, g as SingleStatus, h as SingleBrick } from './ginko.DrkUeYFP.js';
+import { B as Bundle } from './ginko.B_pACpVU.js';
 
 interface Redirect {
     from: string;
@@ -59,10 +59,12 @@ type Pages = Pick<Schema, 'pages' | 'bricks'>;
 /**
  * The bundle with `$…` links turned into paths and `::snippet` components replaced by their text.
  * `$page.<key>` is a page of `schema.pages`; `$<brick>.<slug-or-id>` is an entry's URL; a `#anchor` is kept.
+ * `main` is the main-language bundle (from `buildBundle`, links unresolved): an entry left out of this locale because
+ * it is not translated (`untranslated: 'hide'`) is found there, and the link goes to its main-language page.
  * What cannot be resolved stays as it is and gets `data-broken: true`. A snippet is the `body` of the entry
  * `snippets/<name>` of the collection `snippets`; a snippet inside a snippet stays as it is. No mutation.
  */
-declare function resolveRouteLinks(bundle: Bundle, schema: Pages): Bundle;
+declare function resolveRouteLinks(bundle: Bundle, schema: Pages, main?: Bundle): Bundle;
 /**
  * Link check over bundles (one per locale) before any HTML exists. Errors: route links and snippets that
  * `resolveRouteLinks` could not resolve, and `/…` paths that match no entry URL, no page and no public file.
@@ -117,6 +119,16 @@ interface SiteInput {
      */
     firstDayOfWeek?: 1 | 2 | 3 | 4 | 5 | 6 | 7;
     currency: Currency;
+    /**
+     * The country of the site (ISO 3166-1 alpha-2, e.g. `AT`). It picks the public-holiday calendar (`calendar`) and is
+     * the default `addressCountry` of JSON-LD. A country Ginko has no calendar for keeps no public holidays (`ginko check` warns).
+     */
+    country?: string;
+    /**
+     * Which public holidays count for opening hours: `AT`, `DE` (nationwide only), `SG`, `none`, or your own function
+     * `(year) => Holiday[]`. Default: the calendar of `country`. Stored in the schema as `holidays` (a function as `custom`).
+     */
+    calendar?: HolidaysOption;
     /**
      * Static pages by key: `{ menu: { de: '/speisekarte', en: '/en/menu' } }`. A plain path is the page in
      * the main locale only. The home page is the page whose main-locale path is `/`. The sitemap pairs a page's locales by key.
@@ -136,6 +148,7 @@ interface SiteInput {
         image?: string;
         /** The brand colour, `#rrggbb` or `#rgb`: the background of generated share cards (nuxt-og-image). */
         color?: string;
+        /** The home page's Organization JSON-LD. A page with its own (`siteJsonLd` of `@lupinum/ginko/basics`) gets none from here. */
         organization?: {
             logo?: string;
             sameAs?: string[];
@@ -170,12 +183,34 @@ type RetiredInput<S extends SiteInput> = {
 declare function defineSite<const S extends SiteInput>(site: S & {
     retired?: RetiredInput<S>;
 }): S;
+/**
+ * `site` as it runs on the platform: every brick without `source`, so the owner edits it in the Studio. A template
+ * that reads its content from files and this twin must both pass `checkSite`; tools and tests use it to prove that a
+ * files site can move to the platform without changing its bricks.
+ */
+declare function withoutFiles<const S extends SiteInput>(site: S): WithoutFiles<S>;
+/** `S` with no `source` on any brick. */
+type WithoutFiles<S extends SiteInput> = Omit<S, 'bricks'> & {
+    bricks: {
+        [K in keyof S['bricks']]: Omit<S['bricks'][K], 'source'>;
+    };
+};
 /** The names of the fields in `F` whose type is one of `T`. */
 type FieldsOfType<F, T extends string> = {
     [K in keyof F]: F[K] extends {
         type: T;
     } ? K : never;
 }[keyof F] & string;
+/**
+ * A planned change of one field (`planned`): from the date in the date field `from` on, `next` replaces `field`. `next`
+ * and `from` are optional and set together; every edit task that changes `field` lists them too. Field names only:
+ * a factory with generic fields could not name its date field otherwise, so `ginko check` reports the other rules.
+ */
+type Planned<F> = {
+    field: keyof F & string;
+    next: keyof F & string;
+    from: keyof F & string;
+};
 /** A collection's detail page per locale: a path with `[slug]` where the entry's slug goes, e.g. `/blog/[slug]`. */
 type RouteTemplate = `/${string}[slug]${string}`;
 declare function single<const F extends Fields>(input: {
@@ -185,6 +220,8 @@ declare function single<const F extends Fields>(input: {
     fields: F;
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task<F>[];
+    planned?: Planned<F>;
+    status?: SingleStatus;
 }): SingleBrick<F>;
 declare function collection<const F extends Fields, const R extends Record<Locale, RouteTemplate> | undefined = undefined>(input: {
     label: Label;
@@ -193,6 +230,8 @@ declare function collection<const F extends Fields, const R extends Record<Local
     fields: F;
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task<F>[];
+    /** A planned change of one field: from the date in `from` on, `next` replaces `field`. */
+    planned?: Planned<F>;
     max: number;
     order: 'manual' | {
         field: keyof F & string;
@@ -200,6 +239,10 @@ declare function collection<const F extends Fields, const R extends Record<Local
     };
     route?: R;
     visible?: Visibility<FieldsOfType<F, 'date' | 'daterange'>>;
+    /**
+     * A required translatable field is missing in a language: `'hide'` (default with a `route`) leaves the entry out
+     * there; `'fallback'` (default without) shows the main language and links to the main-language page.
+     */
     untranslated?: 'fallback' | 'hide';
     /** Entries plan weeks of the single brick `brick`; `field` (a date field of this collection) holds the first day of the week (`firstDayOfWeek`). */
     plans?: {
@@ -207,7 +250,9 @@ declare function collection<const F extends Fields, const R extends Record<Local
         field: FieldsOfType<F, 'date'>;
     };
     drafts?: boolean;
+    /** The status line on the Studio's Today page (see `CollectionStatus`). */
+    status?: CollectionStatus<FieldsOfType<F, 'date' | 'daterange'>, keyof F & string>;
 }): CollectionBrick<F, R>;
 
-export { checkLinks as d, collection as e, defineSite as f, entryRedirects as g, externalLinks as h, findRedirect as i, resolveRouteLinks as j, linkTargets as l, matchRedirect as m, redirectProblems as r, single as s };
-export type { CheckLinksOptions as C, ExternalLink as E, LinkConfig as L, Migration as M, Redirect as R, SiteInput as S, LinkIssue as a, MigrationContext as b, RouteTemplate as c };
+export { checkLinks as d, collection as e, defineSite as f, entryRedirects as g, externalLinks as h, findRedirect as i, resolveRouteLinks as j, linkTargets as l, matchRedirect as m, redirectProblems as r, single as s, withoutFiles as w };
+export type { CheckLinksOptions as C, ExternalLink as E, LinkConfig as L, Migration as M, RouteTemplate as R, SiteInput as S, WithoutFiles as W, LinkIssue as a, MigrationContext as b, Redirect as c };

package/dist/shared/ginko.ULKQnAWd.d.ts

@@ -0,0 +1,91 @@
+import './ginko.EelR5dt9.js';
+import { af as Money, F as Fields } from './ginko.DrkUeYFP.js';
+import './ginko.CjWB8N7f.js';
+import { a as BundleItem, B as Bundle } from './ginko.B_pACpVU.js';
+
+/** http(s), mailto, tel, a same-site path or fragment, or a `$` route link. Everything else (javascript:, data:, //host) is unsafe. */
+declare function isSafeHref(href: string): boolean;
+/** The link or image URL when it is safe (see `isSafeHref`), else undefined: for `href`/`src` from content. */
+declare function safeHref(href: string | undefined): string | undefined;
+
+/**
+ * Money is stored as an integer count of the currency's minor units (cents for EUR, whole yen for JPY).
+ * `minorDigits` says how many decimals one unit has: 2 for EUR, 0 for JPY, 3 for KWD.
+ */
+declare function minorDigits(currency: string): number;
+/** Options of `formatMoney`. */
+interface FormatMoneyOptions {
+    /** A whole amount without its minor units: `€390` instead of `€390.00`; `€12.50` stays as it is. Default false. */
+    wholeWithoutMinor?: boolean;
+}
+/**
+ * The amount in the notation of `language`, a BCP 47 tag such as `de-AT` (use `useI18n().language`, not the URL
+ * code): `12,50 €` in de, `€ 12,50` in de-AT, `€12.50` in en, `¥1,250` for JPY.
+ * Every space is a no-break space: Node and browsers ship different ICU data (one uses a plain
+ * space), so a server-rendered price would otherwise differ from the hydrated one, and a price never breaks in two.
+ */
+declare function formatMoney(money: Money, language: string, options?: FormatMoneyOptions): string;
+
+type Data = Record<string, unknown>;
+/** What a condition compares a value with: one element of a list value, money by `amount`, a daterange by its start date. */
+type Comparable<V> = V extends readonly (infer E)[] ? E : V extends Money ? Pick<Money, 'amount'> : V extends {
+    from: string;
+} ? string : V;
+/**
+ * A test on one field. `eq`/`ne`: equal or not (for a list value: one element is). `gt`, `gte`, `lt`, `lte`: compare.
+ * `in`: equal to one of these. `contains`: a text contains this text (case-insensitive), a list contains this element.
+ */
+interface Condition<V = unknown> {
+    eq?: Comparable<V> | null;
+    ne?: Comparable<V> | null;
+    gt?: Comparable<V>;
+    gte?: Comparable<V>;
+    lt?: Comparable<V>;
+    lte?: Comparable<V>;
+    in?: readonly Comparable<V>[];
+    contains?: Comparable<V>;
+}
+/** A sort order: the text `'price desc, name'` (`asc` is the default) or `{ field, dir? }` like a brick's `order`. */
+type QueryOrder<D = Data> = string | {
+    field: keyof D & string;
+    dir?: 'asc' | 'desc';
+};
+/** `D` is the data of the brick's entries; `useGinkoQuery` sets it, so field names and values are checked. */
+interface Query<D = Data> {
+    /** Per field a value (equal to it) or a `Condition`; every field must match. */
+    where?: {
+        [K in keyof D]?: Comparable<D[K]> | null | Condition<D[K]>;
+    };
+    /** Default: the bundle's item order. */
+    order?: QueryOrder<D>;
+    /** At least 1; without it, every matching entry. */
+    limit?: number;
+    /** 1-based. */
+    page?: number;
+    fields?: (keyof D & string)[];
+    facets?: (keyof D & string)[];
+    include?: (keyof D & string)[];
+}
+interface QueryResult {
+    items: BundleItem[];
+    total: number;
+    page: number;
+    pages: number;
+    facets?: Record<string, Record<string, number>>;
+}
+/** What `query` reads of the schema: the fields of each brick (a full `Schema` fits). */
+interface QuerySchema {
+    bricks: Record<string, {
+        fields: Fields;
+    }>;
+}
+/** Filter, order, page, project and enrich the items of one collection brick. Pure; throws on a field the brick does not have. */
+declare function query(bundle: Bundle, brick: string, q?: Query, schema?: QuerySchema): QueryResult;
+/** The items before and after `id` in the given (or default) order. Both are missing for an unknown id. */
+declare function neighbors(bundle: Bundle, brick: string, id: string, order?: QueryOrder): {
+    prev?: BundleItem;
+    next?: BundleItem;
+};
+
+export { formatMoney as f, isSafeHref as i, minorDigits as m, neighbors as n, query as q, safeHref as s };
+export type { Condition as C, FormatMoneyOptions as F, Query as Q, QueryOrder as a, QueryResult as b, QuerySchema as c };

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

@@ -0,0 +1,91 @@
+import './ginko.DvPtlHIz.mjs';
+import { af as Money, F as Fields } from './ginko.DrkUeYFP.mjs';
+import './ginko.o1yIKlgj.mjs';
+import { a as BundleItem, B as Bundle } from './ginko.6cI8KXZP.mjs';
+
+/** http(s), mailto, tel, a same-site path or fragment, or a `$` route link. Everything else (javascript:, data:, //host) is unsafe. */
+declare function isSafeHref(href: string): boolean;
+/** The link or image URL when it is safe (see `isSafeHref`), else undefined: for `href`/`src` from content. */
+declare function safeHref(href: string | undefined): string | undefined;
+
+/**
+ * Money is stored as an integer count of the currency's minor units (cents for EUR, whole yen for JPY).
+ * `minorDigits` says how many decimals one unit has: 2 for EUR, 0 for JPY, 3 for KWD.
+ */
+declare function minorDigits(currency: string): number;
+/** Options of `formatMoney`. */
+interface FormatMoneyOptions {
+    /** A whole amount without its minor units: `€390` instead of `€390.00`; `€12.50` stays as it is. Default false. */
+    wholeWithoutMinor?: boolean;
+}
+/**
+ * The amount in the notation of `language`, a BCP 47 tag such as `de-AT` (use `useI18n().language`, not the URL
+ * code): `12,50 €` in de, `€ 12,50` in de-AT, `€12.50` in en, `¥1,250` for JPY.
+ * Every space is a no-break space: Node and browsers ship different ICU data (one uses a plain
+ * space), so a server-rendered price would otherwise differ from the hydrated one, and a price never breaks in two.
+ */
+declare function formatMoney(money: Money, language: string, options?: FormatMoneyOptions): string;
+
+type Data = Record<string, unknown>;
+/** What a condition compares a value with: one element of a list value, money by `amount`, a daterange by its start date. */
+type Comparable<V> = V extends readonly (infer E)[] ? E : V extends Money ? Pick<Money, 'amount'> : V extends {
+    from: string;
+} ? string : V;
+/**
+ * A test on one field. `eq`/`ne`: equal or not (for a list value: one element is). `gt`, `gte`, `lt`, `lte`: compare.
+ * `in`: equal to one of these. `contains`: a text contains this text (case-insensitive), a list contains this element.
+ */
+interface Condition<V = unknown> {
+    eq?: Comparable<V> | null;
+    ne?: Comparable<V> | null;
+    gt?: Comparable<V>;
+    gte?: Comparable<V>;
+    lt?: Comparable<V>;
+    lte?: Comparable<V>;
+    in?: readonly Comparable<V>[];
+    contains?: Comparable<V>;
+}
+/** A sort order: the text `'price desc, name'` (`asc` is the default) or `{ field, dir? }` like a brick's `order`. */
+type QueryOrder<D = Data> = string | {
+    field: keyof D & string;
+    dir?: 'asc' | 'desc';
+};
+/** `D` is the data of the brick's entries; `useGinkoQuery` sets it, so field names and values are checked. */
+interface Query<D = Data> {
+    /** Per field a value (equal to it) or a `Condition`; every field must match. */
+    where?: {
+        [K in keyof D]?: Comparable<D[K]> | null | Condition<D[K]>;
+    };
+    /** Default: the bundle's item order. */
+    order?: QueryOrder<D>;
+    /** At least 1; without it, every matching entry. */
+    limit?: number;
+    /** 1-based. */
+    page?: number;
+    fields?: (keyof D & string)[];
+    facets?: (keyof D & string)[];
+    include?: (keyof D & string)[];
+}
+interface QueryResult {
+    items: BundleItem[];
+    total: number;
+    page: number;
+    pages: number;
+    facets?: Record<string, Record<string, number>>;
+}
+/** What `query` reads of the schema: the fields of each brick (a full `Schema` fits). */
+interface QuerySchema {
+    bricks: Record<string, {
+        fields: Fields;
+    }>;
+}
+/** Filter, order, page, project and enrich the items of one collection brick. Pure; throws on a field the brick does not have. */
+declare function query(bundle: Bundle, brick: string, q?: Query, schema?: QuerySchema): QueryResult;
+/** The items before and after `id` in the given (or default) order. Both are missing for an unknown id. */
+declare function neighbors(bundle: Bundle, brick: string, id: string, order?: QueryOrder): {
+    prev?: BundleItem;
+    next?: BundleItem;
+};
+
+export { formatMoney as f, isSafeHref as i, minorDigits as m, neighbors as n, query as q, safeHref as s };
+export type { Condition as C, FormatMoneyOptions as F, Query as Q, QueryOrder as a, QueryResult as b, QuerySchema as c };

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

@@ -0,0 +1,128 @@
+import { B as Bundle } from './ginko.6cI8KXZP.mjs';
+import { L as Locale } from './ginko.DrkUeYFP.mjs';
+
+interface NavNode {
+    title: string;
+    path: string;
+    id?: string;
+    brick?: string;
+    children: NavNode[];
+}
+/**
+ * Navigation tree of the collections `bricks` in `locale`, built from item URLs. An item is a child of the
+ * node at its nearest existing path prefix, else a root node. A string `parent` field (item id) overrides that.
+ * Siblings keep the item order of the bundle (bricks in the given order).
+ */
+declare function navTree(bundle: Bundle, bricks: string[], locale: Locale): NavNode[];
+/** Nodes from the root down to the node at `path`; empty when the path is not in the tree. */
+declare function breadcrumbs(tree: NavNode[], path: string): NavNode[];
+
+interface SeoImage {
+    url: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+}
+interface SeoInput {
+    siteName: string;
+    /** `%s` is replaced by the page title; default '%s · <siteName>'. A page without title gets siteName alone. */
+    titleTemplate?: string;
+    title?: string;
+    description?: string;
+    image?: SeoImage;
+    type?: 'website' | 'article';
+    noindex?: boolean;
+}
+interface SeoHead {
+    title: string;
+    meta: (({
+        name: string;
+    } | {
+        property: string;
+    }) & {
+        content: string;
+    })[];
+}
+declare function seoHead(input: SeoInput): SeoHead;
+/** True when a request for `host` (with port, as in the Host header) is not for the site's own address: preview deployments, staging, localhost. Those must never be indexed. */
+declare function isPreviewHost(host: string | undefined, siteUrl: string): boolean;
+declare function robotsTxt(options: {
+    sitemap?: string;
+    noindex?: boolean;
+    disallow?: string[];
+}): string;
+declare function websiteLd(o: {
+    name: string;
+    url: string;
+    lang: string;
+}): Record<string, unknown>;
+/**
+ * `node` with the site's `country` (ISO 3166 code) where a builder left it out: `addressCountry` of every PostalAddress,
+ * and where remote applicants of a remote JobPosting must live. The Nuxt module applies it to a page's JSON-LD, so
+ * `siteJsonLd` and `jobJsonLd` need no `country` (an explicit one wins). An empty `country` changes nothing.
+ */
+declare function withCountry<T>(node: T, country: string): T;
+/** The schema.org types `organizationLd` writes. A page whose JSON-LD has a node of one of them is the site's organisation node. */
+declare const ORGANIZATION_TYPES: readonly ["Organization", "LocalBusiness", "NGO"];
+interface OrganizationLdInput {
+    name: string;
+    url: string;
+    /** `Organization` (default), `LocalBusiness` for a shop or practice, `NGO` for a nonprofit. */
+    type?: (typeof ORGANIZATION_TYPES)[number];
+    legalName?: string;
+    /** Absolute URL of the logo. */
+    logo?: string;
+    email?: string;
+    telephone?: string;
+    address?: {
+        street?: string;
+        postalCode?: string;
+        city?: string;
+        country?: string;
+    };
+    vatID?: string;
+    /** Absolute URLs of the organisation's profiles elsewhere. */
+    sameAs?: string[];
+}
+declare function organizationLd(o: OrganizationLdInput): Record<string, unknown>;
+/**
+ * A schema.org BreadcrumbList from the first step (usually the home page) to the page itself. Each step has a `title`
+ * and a `path` of the site, as the nodes of `useGinkoBreadcrumbs` do; `siteUrl` (`useGinkoSite().url`) makes the
+ * paths absolute.
+ */
+declare function breadcrumbJsonLd(steps: readonly Pick<NavNode, 'title' | 'path'>[], siteUrl: string): Record<string, unknown>;
+interface ArticleLdInput {
+    /** `Article` (default) or `BlogPosting` for a post of a blog. */
+    type?: 'Article' | 'BlogPosting';
+    title: string;
+    url: string;
+    description?: string;
+    image?: string;
+    published?: string;
+    modified?: string;
+    /** One author by name, or a list of authors with an optional website each. */
+    author?: string | readonly {
+        name: string;
+        url?: string;
+    }[];
+    keywords?: readonly string[];
+    lang: string;
+}
+declare function articleLd(o: ArticleLdInput): Record<string, unknown>;
+declare function faqLd(pairs: {
+    question: string;
+    answer: string;
+}[]): Record<string, unknown>;
+/**
+ * Headers every response of a Ginko site carries. Only the platform may frame `/__ginko` (the preview); nothing
+ * else is framed. `nosniff` stops a browser from reading user text (`.md`, `llms.txt`, JSON) as HTML, and the
+ * referrer policy keeps full URLs from leaving the site.
+ */
+declare function siteHeaders(input: {
+    preview: boolean;
+    platformOrigin: string;
+    noindex: boolean;
+}): Record<string, string>;
+
+export { ORGANIZATION_TYPES as a, articleLd as d, breadcrumbJsonLd as e, breadcrumbs as f, faqLd as g, siteHeaders as h, isPreviewHost as i, withCountry as j, navTree as n, organizationLd as o, robotsTxt as r, seoHead as s, websiteLd as w };
+export type { ArticleLdInput as A, NavNode as N, OrganizationLdInput as O, SeoHead as S, SeoImage as b, SeoInput as c };