@lupinum/ginko 0.4.0 → 0.5.0

package/dist/shared/{ginko.D-fNojn9.d.mts → ginko.DrkUeYFP.d.mts}

@@ -4,6 +4,7 @@ import { ComarkPlugin } from 'comark';
 declare namespace issues {
     let unknownBrick: string;
     let markdown: string;
+    let markdownAt: string;
     let notObject: string;
     let unknownField: string;
     let fieldMissing: string;
@@ -25,6 +26,8 @@ declare namespace issues {
     let badTime: string;
     let badDateRange: string;
     let dateRangeOrder: string;
+    let timeOrder: string;
+    let notWeekStart: string;
     let badChoice: string;
     let badChoices: string;
     let duplicateValues: string;
@@ -41,6 +44,9 @@ declare namespace issues {
     let duplicateRowId: string;
     let notImage: string;
     let altMissing: string;
+    let fileRefMissing: string;
+    let fileRefPdf: string;
+    let markdownImageAltMissing: string;
     let altTooLong: string;
     let notFile: string;
 }
@@ -61,6 +67,8 @@ declare namespace markdown_1 {
     let unsafeLink: string;
     let oneParagraph: string;
     let tooComplex: string;
+    let componentNotClosed: string;
+    let bracketText: string;
 }
 
 declare namespace component {
@@ -248,6 +256,7 @@ declare const coreCatalogs: {
         issues: {
             unknownBrick: string;
             markdown: string;
+            markdownAt: string;
             notObject: string;
             unknownField: string;
             fieldMissing: string;
@@ -269,6 +278,8 @@ declare const coreCatalogs: {
             badTime: string;
             badDateRange: string;
             dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
             badChoice: string;
             badChoices: string;
             duplicateValues: string;
@@ -285,6 +296,9 @@ declare const coreCatalogs: {
             duplicateRowId: string;
             notImage: string;
             altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
             altTooLong: string;
             notFile: string;
         };
@@ -305,6 +319,8 @@ declare const coreCatalogs: {
             unsafeLink: string;
             oneParagraph: string;
             tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
         };
         component: {
             or: string;
@@ -452,6 +468,7 @@ declare const coreCatalogs: {
         issues: {
             unknownBrick: string;
             markdown: string;
+            markdownAt: string;
             notObject: string;
             unknownField: string;
             fieldMissing: string;
@@ -473,6 +490,8 @@ declare const coreCatalogs: {
             badTime: string;
             badDateRange: string;
             dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
             badChoice: string;
             badChoices: string;
             duplicateValues: string;
@@ -489,6 +508,9 @@ declare const coreCatalogs: {
             duplicateRowId: string;
             notImage: string;
             altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
             altTooLong: string;
             notFile: string;
         };
@@ -509,6 +531,8 @@ declare const coreCatalogs: {
             unsafeLink: string;
             oneParagraph: string;
             tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
         };
         component: {
             or: string;
@@ -656,6 +680,7 @@ declare const coreCatalogs: {
         issues: {
             unknownBrick: string;
             markdown: string;
+            markdownAt: string;
             notObject: string;
             unknownField: string;
             fieldMissing: string;
@@ -677,6 +702,8 @@ declare const coreCatalogs: {
             badTime: string;
             badDateRange: string;
             dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
             badChoice: string;
             badChoices: string;
             duplicateValues: string;
@@ -693,6 +720,9 @@ declare const coreCatalogs: {
             duplicateRowId: string;
             notImage: string;
             altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
             altTooLong: string;
             notFile: string;
         };
@@ -713,6 +743,644 @@ declare const coreCatalogs: {
             unsafeLink: string;
             oneParagraph: string;
             tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
+        };
+        component: {
+            or: string;
+            and: string;
+            quoted: string;
+            unknown: string;
+            propUnknown: string;
+            propInvalid: string;
+            propMissing: string;
+            propEmpty: string;
+            blockInParagraph: string;
+            parentOnly: string;
+            slotUnknown: string;
+            noSlots: string;
+            childNotAllowed: string;
+            prop: {
+                notBoolean: string;
+                notNumber: string;
+                outOfRange: string;
+                badStep: string;
+                notText: string;
+                tooLong: string;
+                badChoice: string;
+                badChoices: string;
+                duplicateValues: string;
+                tooManyChosen: string;
+                badImage: string;
+                notId: string;
+                badType: string;
+            };
+        };
+        links: {
+            snippetMissing: string;
+            linkBroken: string;
+            linkRedirected: string;
+            pathUnknown: string;
+            anchorMissing: string;
+            externalBroken: string;
+        };
+        editor: {
+            component: {
+                unknown: string;
+                more: string;
+            };
+            prop: {
+                missing: string;
+                empty: string;
+                invalid: string;
+            };
+            problem: {
+                imageNoDescription: string;
+            };
+            source: {
+                unstable: string;
+                lossy: string;
+                failed: string;
+            };
+        };
+        diff: {
+            freshSetting: string;
+            freshLocales: string;
+            siteRenamed: string;
+            currencyChanged: string;
+            mainLocaleChanged: string;
+            localeRemoved: string;
+            localeOrder: string;
+            localeAdded: string;
+            timezoneChanged: string;
+            valueChanged: string;
+            pagesChanged: string;
+            agentsChanged: string;
+            tasksChanged: string;
+            retiredBack: string;
+            unretired: string;
+            retiredRuleChanged: string;
+            retiredNow: string;
+            migrationChanged: string;
+            migrationFillsExisting: string;
+            migrationAdded: string;
+            migrationDropped: string;
+            brickRemoved: string;
+            brickAdded: string;
+            singleWithoutDefault: string;
+            unknownChange: string;
+            kindChanged: string;
+            textChanged: string;
+            maxLowered: string;
+            maxRaised: string;
+            routeAdded: string;
+            routeAddedLocale: string;
+            routeChanged: string;
+            fieldRemoved: string;
+            fieldAdded: string;
+            fieldAddedDefault: string;
+            fieldAddedMigration: string;
+            requiredWithoutDefault: string;
+            typeChanged: string;
+            retiredFieldChanged: string;
+            madeRequired: string;
+            madeOptional: string;
+            translationChanged: string;
+            defaultChanged: string;
+            minRaised: string;
+            minLowered: string;
+            minOffGrid: string;
+            propChanged: string;
+            optionRemoved: string;
+            optionRenamed: string;
+            optionAdded: string;
+            uniqueChanged: string;
+            uniqueDropped: string;
+            fix: {
+                newField: string;
+                newFieldOnly: string;
+                newSite: string;
+                moneyFields: string;
+                planMigration: string;
+                keepLocale: string;
+                keepLocaleOrder: string;
+                keepTimezone: string;
+                keepRule: string;
+                newMigrationId: string;
+                fillNewFieldsOnly: string;
+                retireBrick: string;
+                defaultOrOptional: string;
+                keepProperty: string;
+                keepMax: string;
+                keepRoute: string;
+                defaultMigrationOrOptional: string;
+                keepDefinition: string;
+                keepDefault: string;
+                keepMin: string;
+                minOnGrid: string;
+                keepOption: string;
+                newList: string;
+            };
+        };
+        preview: {
+            notFound: string;
+            failed: string;
+            loading: string;
+        };
+    };
+    readonly fr: {
+        issues: {
+            unknownBrick: string;
+            markdown: string;
+            markdownAt: string;
+            notObject: string;
+            unknownField: string;
+            fieldMissing: string;
+            notLocalized: string;
+            unknownLocale: string;
+            fieldEmpty: string;
+            notText: string;
+            tooLong: string;
+            controlChars: string;
+            badFormat: string;
+            badSlug: string;
+            notNumber: string;
+            outOfRange: string;
+            badStep: string;
+            notMoney: string;
+            moneyOutOfRange: string;
+            notBoolean: string;
+            badDate: string;
+            badTime: string;
+            badDateRange: string;
+            dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
+            badChoice: string;
+            badChoices: string;
+            duplicateValues: string;
+            tooManyChosen: string;
+            notIdList: string;
+            notId: string;
+            duplicateEntries: string;
+            refGone: string;
+            notList: string;
+            tooManyRows: string;
+            tooFewRows: string;
+            duplicateRowValue: string;
+            badRowId: string;
+            duplicateRowId: string;
+            notImage: string;
+            altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
+            altTooLong: string;
+            notFile: string;
+        };
+        file: {
+            typeNotAllowed: string;
+            tooBig: string;
+        };
+        markdown: {
+            profile: {
+                inline: string;
+                basic: string;
+                rich: string;
+                page: string;
+            };
+            tagBlocked: string;
+            tagNotInProfile: string;
+            propBlocked: string;
+            unsafeLink: string;
+            oneParagraph: string;
+            tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
+        };
+        component: {
+            or: string;
+            and: string;
+            quoted: string;
+            unknown: string;
+            propUnknown: string;
+            propInvalid: string;
+            propMissing: string;
+            propEmpty: string;
+            blockInParagraph: string;
+            parentOnly: string;
+            slotUnknown: string;
+            noSlots: string;
+            childNotAllowed: string;
+            prop: {
+                notBoolean: string;
+                notNumber: string;
+                outOfRange: string;
+                badStep: string;
+                notText: string;
+                tooLong: string;
+                badChoice: string;
+                badChoices: string;
+                duplicateValues: string;
+                tooManyChosen: string;
+                badImage: string;
+                notId: string;
+                badType: string;
+            };
+        };
+        links: {
+            snippetMissing: string;
+            linkBroken: string;
+            linkRedirected: string;
+            pathUnknown: string;
+            anchorMissing: string;
+            externalBroken: string;
+        };
+        editor: {
+            component: {
+                unknown: string;
+                more: string;
+            };
+            prop: {
+                missing: string;
+                empty: string;
+                invalid: string;
+            };
+            problem: {
+                imageNoDescription: string;
+            };
+            source: {
+                unstable: string;
+                lossy: string;
+                failed: string;
+            };
+        };
+        diff: {
+            freshSetting: string;
+            freshLocales: string;
+            siteRenamed: string;
+            currencyChanged: string;
+            mainLocaleChanged: string;
+            localeRemoved: string;
+            localeOrder: string;
+            localeAdded: string;
+            timezoneChanged: string;
+            valueChanged: string;
+            pagesChanged: string;
+            agentsChanged: string;
+            tasksChanged: string;
+            retiredBack: string;
+            unretired: string;
+            retiredRuleChanged: string;
+            retiredNow: string;
+            migrationChanged: string;
+            migrationFillsExisting: string;
+            migrationAdded: string;
+            migrationDropped: string;
+            brickRemoved: string;
+            brickAdded: string;
+            singleWithoutDefault: string;
+            unknownChange: string;
+            kindChanged: string;
+            textChanged: string;
+            maxLowered: string;
+            maxRaised: string;
+            routeAdded: string;
+            routeAddedLocale: string;
+            routeChanged: string;
+            fieldRemoved: string;
+            fieldAdded: string;
+            fieldAddedDefault: string;
+            fieldAddedMigration: string;
+            requiredWithoutDefault: string;
+            typeChanged: string;
+            retiredFieldChanged: string;
+            madeRequired: string;
+            madeOptional: string;
+            translationChanged: string;
+            defaultChanged: string;
+            minRaised: string;
+            minLowered: string;
+            minOffGrid: string;
+            propChanged: string;
+            optionRemoved: string;
+            optionRenamed: string;
+            optionAdded: string;
+            uniqueChanged: string;
+            uniqueDropped: string;
+            fix: {
+                newField: string;
+                newFieldOnly: string;
+                newSite: string;
+                moneyFields: string;
+                planMigration: string;
+                keepLocale: string;
+                keepLocaleOrder: string;
+                keepTimezone: string;
+                keepRule: string;
+                newMigrationId: string;
+                fillNewFieldsOnly: string;
+                retireBrick: string;
+                defaultOrOptional: string;
+                keepProperty: string;
+                keepMax: string;
+                keepRoute: string;
+                defaultMigrationOrOptional: string;
+                keepDefinition: string;
+                keepDefault: string;
+                keepMin: string;
+                minOnGrid: string;
+                keepOption: string;
+                newList: string;
+            };
+        };
+        preview: {
+            notFound: string;
+            failed: string;
+            loading: string;
+        };
+    };
+    readonly it: {
+        issues: {
+            unknownBrick: string;
+            markdown: string;
+            markdownAt: string;
+            notObject: string;
+            unknownField: string;
+            fieldMissing: string;
+            notLocalized: string;
+            unknownLocale: string;
+            fieldEmpty: string;
+            notText: string;
+            tooLong: string;
+            controlChars: string;
+            badFormat: string;
+            badSlug: string;
+            notNumber: string;
+            outOfRange: string;
+            badStep: string;
+            notMoney: string;
+            moneyOutOfRange: string;
+            notBoolean: string;
+            badDate: string;
+            badTime: string;
+            badDateRange: string;
+            dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
+            badChoice: string;
+            badChoices: string;
+            duplicateValues: string;
+            tooManyChosen: string;
+            notIdList: string;
+            notId: string;
+            duplicateEntries: string;
+            refGone: string;
+            notList: string;
+            tooManyRows: string;
+            tooFewRows: string;
+            duplicateRowValue: string;
+            badRowId: string;
+            duplicateRowId: string;
+            notImage: string;
+            altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
+            altTooLong: string;
+            notFile: string;
+        };
+        file: {
+            typeNotAllowed: string;
+            tooBig: string;
+        };
+        markdown: {
+            profile: {
+                inline: string;
+                basic: string;
+                rich: string;
+                page: string;
+            };
+            tagBlocked: string;
+            tagNotInProfile: string;
+            propBlocked: string;
+            unsafeLink: string;
+            oneParagraph: string;
+            tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
+        };
+        component: {
+            or: string;
+            and: string;
+            quoted: string;
+            unknown: string;
+            propUnknown: string;
+            propInvalid: string;
+            propMissing: string;
+            propEmpty: string;
+            blockInParagraph: string;
+            parentOnly: string;
+            slotUnknown: string;
+            noSlots: string;
+            childNotAllowed: string;
+            prop: {
+                notBoolean: string;
+                notNumber: string;
+                outOfRange: string;
+                badStep: string;
+                notText: string;
+                tooLong: string;
+                badChoice: string;
+                badChoices: string;
+                duplicateValues: string;
+                tooManyChosen: string;
+                badImage: string;
+                notId: string;
+                badType: string;
+            };
+        };
+        links: {
+            snippetMissing: string;
+            linkBroken: string;
+            linkRedirected: string;
+            pathUnknown: string;
+            anchorMissing: string;
+            externalBroken: string;
+        };
+        editor: {
+            component: {
+                unknown: string;
+                more: string;
+            };
+            prop: {
+                missing: string;
+                empty: string;
+                invalid: string;
+            };
+            problem: {
+                imageNoDescription: string;
+            };
+            source: {
+                unstable: string;
+                lossy: string;
+                failed: string;
+            };
+        };
+        diff: {
+            freshSetting: string;
+            freshLocales: string;
+            siteRenamed: string;
+            currencyChanged: string;
+            mainLocaleChanged: string;
+            localeRemoved: string;
+            localeOrder: string;
+            localeAdded: string;
+            timezoneChanged: string;
+            valueChanged: string;
+            pagesChanged: string;
+            agentsChanged: string;
+            tasksChanged: string;
+            retiredBack: string;
+            unretired: string;
+            retiredRuleChanged: string;
+            retiredNow: string;
+            migrationChanged: string;
+            migrationFillsExisting: string;
+            migrationAdded: string;
+            migrationDropped: string;
+            brickRemoved: string;
+            brickAdded: string;
+            singleWithoutDefault: string;
+            unknownChange: string;
+            kindChanged: string;
+            textChanged: string;
+            maxLowered: string;
+            maxRaised: string;
+            routeAdded: string;
+            routeAddedLocale: string;
+            routeChanged: string;
+            fieldRemoved: string;
+            fieldAdded: string;
+            fieldAddedDefault: string;
+            fieldAddedMigration: string;
+            requiredWithoutDefault: string;
+            typeChanged: string;
+            retiredFieldChanged: string;
+            madeRequired: string;
+            madeOptional: string;
+            translationChanged: string;
+            defaultChanged: string;
+            minRaised: string;
+            minLowered: string;
+            minOffGrid: string;
+            propChanged: string;
+            optionRemoved: string;
+            optionRenamed: string;
+            optionAdded: string;
+            uniqueChanged: string;
+            uniqueDropped: string;
+            fix: {
+                newField: string;
+                newFieldOnly: string;
+                newSite: string;
+                moneyFields: string;
+                planMigration: string;
+                keepLocale: string;
+                keepLocaleOrder: string;
+                keepTimezone: string;
+                keepRule: string;
+                newMigrationId: string;
+                fillNewFieldsOnly: string;
+                retireBrick: string;
+                defaultOrOptional: string;
+                keepProperty: string;
+                keepMax: string;
+                keepRoute: string;
+                defaultMigrationOrOptional: string;
+                keepDefinition: string;
+                keepDefault: string;
+                keepMin: string;
+                minOnGrid: string;
+                keepOption: string;
+                newList: string;
+            };
+        };
+        preview: {
+            notFound: string;
+            failed: string;
+            loading: string;
+        };
+    };
+    readonly ar: {
+        issues: {
+            unknownBrick: string;
+            markdown: string;
+            markdownAt: string;
+            notObject: string;
+            unknownField: string;
+            fieldMissing: string;
+            notLocalized: string;
+            unknownLocale: string;
+            fieldEmpty: string;
+            notText: string;
+            tooLong: string;
+            controlChars: string;
+            badFormat: string;
+            badSlug: string;
+            notNumber: string;
+            outOfRange: string;
+            badStep: string;
+            notMoney: string;
+            moneyOutOfRange: string;
+            notBoolean: string;
+            badDate: string;
+            badTime: string;
+            badDateRange: string;
+            dateRangeOrder: string;
+            timeOrder: string;
+            notWeekStart: string;
+            badChoice: string;
+            badChoices: string;
+            duplicateValues: string;
+            tooManyChosen: string;
+            notIdList: string;
+            notId: string;
+            duplicateEntries: string;
+            refGone: string;
+            notList: string;
+            tooManyRows: string;
+            tooFewRows: string;
+            duplicateRowValue: string;
+            badRowId: string;
+            duplicateRowId: string;
+            notImage: string;
+            altMissing: string;
+            fileRefMissing: string;
+            fileRefPdf: string;
+            markdownImageAltMissing: string;
+            altTooLong: string;
+            notFile: string;
+        };
+        file: {
+            typeNotAllowed: string;
+            tooBig: string;
+        };
+        markdown: {
+            profile: {
+                inline: string;
+                basic: string;
+                rich: string;
+                page: string;
+            };
+            tagBlocked: string;
+            tagNotInProfile: string;
+            propBlocked: string;
+            unsafeLink: string;
+            oneParagraph: string;
+            tooComplex: string;
+            componentNotClosed: string;
+            bracketText: string;
         };
         component: {
             or: string;
@@ -863,12 +1531,15 @@ declare function coreMessage(locale: string | undefined, key: string, params?: M
 declare function msg(key: CoreKey, params?: Msg['params']): Described;
 
 /**
- * In page state the tree is replaced by `ref`, the site path that serves it, so a page's payload
- * carries only the texts it shows (CONTENT.md, Phase 14). `toc` stays for lists and navigation.
+ * In page state the tree is replaced by `ref`, the site path that serves it (withMarkdownRefs), so a page's
+ * payload carries only the texts it shows (CONTENT.md, Phase 14). The toc comes with the loaded tree; page
+ * state no longer carries it, `toc` stays optional here so the type does not change. `words` is the tree's word
+ * count (`wordsOf`), so a list page can show a reading time without loading every text.
  */
 type MarkdownValue = MarkdownTree | {
     ref: string;
     toc?: MarkdownToc;
+    words?: number;
 };
 /**
  * The parsed tree: comark nodes (`[tag, props, ...children]` or a string). `summary` holds the nodes
@@ -902,6 +1573,12 @@ declare const MARKDOWN_PROFILES: readonly ["inline", "basic", "rich", "page"];
 type MarkdownProfile = (typeof MARKDOWN_PROFILES)[number];
 /** Attributes that hold an address; their value must pass `isSafeHref` (`srcset`: each address in it). */
 declare const URL_PROPS: ReadonlySet<string>;
+/** What `attributeProblem` reads of the component registry: the declared props and their types. A full `ComponentRegistry` fits. */
+type AttributeRegistry = Record<string, {
+    props: Record<string, {
+        type: string;
+    }>;
+}>;
 declare const UNSAFE_LINK: string;
 /** A short description of what the profile allows, for agent tools and editor hints. */
 declare function describeProfile(profile: MarkdownProfile, locale?: string): string;
@@ -926,8 +1603,17 @@ interface ParsedMarkdown {
     /** What the profile does not allow, as sentences. Empty when the text is fine. */
     problems: string[];
     /** The same problems with catalog key and parameters (`coreMessage(locale, key, params)`), in the same order. */
-    problemMessages: Described[];
+    problemMessages: MarkdownProblem[];
+    /**
+     * True when the text has parts the tree does not show: link reference definitions (`[g]: https://…`, resolved into
+     * their links and images) and HTML comments (`<!-- … -->`). A text written from the tree would lose them.
+     */
+    hidden?: true;
 }
+/** A problem of a text; `line` (1-based, in the parsed text, frontmatter included) when it belongs to one line. */
+type MarkdownProblem = Described & {
+    line?: number;
+};
 /** Parses Markdown with comark, checks it against the profile, adds heading anchors and the toc (h2, h3). */
 declare function parseMarkdown(text: string, options?: ParseOptions): Promise<ParsedMarkdown>;
 /** One top-level block of a text: its text, and for an h2 or h3 also its level and anchor. Code blocks (`pre`) are not blocks. */
@@ -942,6 +1628,11 @@ interface TextBlock {
 declare function textBlocks(tree: MarkdownTree | readonly Json[]): TextBlock[];
 /** All text of a tree (or of a node list), for excerpts and search. Blocks are separated by a line break; code blocks are left out. */
 declare function plainText(tree: MarkdownTree | readonly Json[]): string;
+/**
+ * The number of words of a text, e.g. for a reading time: of the tree's `plainText`, or the count a `{ ref }` carries
+ * in page state. `undefined` for a ref without a count or no value.
+ */
+declare function wordsOf(value: MarkdownValue | null | undefined): number | undefined;
 
 /**
  * Provide/inject key of the app-wide tag → component map that `<GinkoMarkdown>` merges under its `components`
@@ -966,7 +1657,11 @@ interface ComponentDef<P extends Fields = Fields> {
     children?: readonly string[];
     /** This component may only appear directly inside one of these. */
     parents?: readonly string[];
-    /** Slash menu: `group` is the heading the entry is listed under, per language like `label`. */
+    /**
+     * Slash menu: `group` is the heading the entry is listed under, per language like `label`. `example` is the Markdown
+     * the menu inserts; its sample text shows as a placeholder. Without one the menu inserts the bare tag with no text
+     * line, so a component that takes text should have an example with one.
+     */
     editor?: {
         icon?: string;
         group?: Label;
@@ -1028,8 +1723,11 @@ type ValueOf<F extends Field> = F extends RefField ? (F['multiple'] extends true
     from: string;
     to: string;
 } : F extends NumberField ? number : F extends BooleanField ? boolean : F extends TextField | LongTextField | SlugField | DateField | TimeField ? string : unknown;
+/** Optional fields, and fields with `showWhen`: those are required only while shown, so a value can be absent. */
 type OptionalKeys<F extends Fields> = {
-    [K in keyof F]: F[K]['optional'] extends true ? K : never;
+    [K in keyof F]: F[K]['optional'] extends true ? K : F[K] extends {
+        showWhen: object;
+    } ? K : never;
 }[keyof F];
 type RetiredKeys<F extends Fields> = {
     [K in keyof F]: F[K]['retired'] extends true ? K : never;
@@ -1225,6 +1923,11 @@ declare function isTranslatable(field: {
 }): boolean;
 /** The longest alt text, own or library. */
 declare const ALT_MAX = 300;
+/**
+ * What an image description must not hold: control characters (as text fields, `controlChars`) and bidi overrides,
+ * which turn the words around when a screen reader reads them out.
+ */
+declare const ALT_INVISIBLE: RegExp;
 /**
  * The description an image use shows in one language: the field's own trimmed text when it has
  * some, else the Files library text of that language, else ''. Validation, the missing-alt
@@ -1234,6 +1937,14 @@ declare function effectiveAlt(own: unknown, library: Record<string, string> | un
 
 /** `YYYY-MM-DD` of `now` in `timeZone`. */
 declare function todayIn(timeZone: string, now?: Date): string;
+/** How far `timeZone` is ahead of UTC at the instant `ms`, in ms (+1 h for Vienna in winter, +2 h in summer). */
+declare function zoneOffset(timeZone: string, ms: number): number;
+/**
+ * A wall-clock time in `timeZone` as ISO 8601 with its offset: `2026-12-03` `19:30` in Europe/Vienna →
+ * `2026-12-03T19:30:00+01:00` (`+02:00` in summer). In the hour a clock change skips or repeats, the offset is one of
+ * the two (no event is planned for a time that does not exist).
+ */
+declare function zonedDateTime(date: string, time: string, timeZone: string): string;
 declare function addDays(date: string, days: number): string;
 /** First day of the week and weekend days, ISO numbering (1 = Monday, 7 = Sunday). */
 interface WeekInfo {
@@ -1255,8 +1966,40 @@ declare function startOfWeek(date: string, week: WeekInfo): string;
  * Monday-first with Sat+Sun off: Saturday and Sunday. Sunday-first with Sat+Sun off: only Saturday.
  */
 declare function workWeekOf(date: string, week: WeekInfo): string;
+/**
+ * The first day on which `weekStart` is the work week (`workWeekOf`): the day a week planned ahead starts to show.
+ * Monday-first with Saturday and Sunday off: the Saturday before.
+ */
+declare function firstDayShown(weekStart: string, week: WeekInfo): string;
 declare function resolveToken(token: string, timeZone: string, week: WeekInfo, now?: Date): string | undefined;
 
+/** One public holiday with its name for guests in German and English. */
+interface Holiday {
+    date: string;
+    de: string;
+    en: string;
+}
+/** A site's own holidays: all holidays of `year`. */
+type HolidayCalendar = (year: number) => Holiday[];
+/** The built-in calendars. `DE` has the nationwide holidays only. */
+type HolidayCalendarName = 'AT' | 'DE' | 'SG' | 'none';
+/** The `calendar` option of a site: a built-in calendar or the site's own function. */
+type HolidaysOption = HolidayCalendarName | HolidayCalendar;
+/** `schema.holidays`: the resolved calendar; `custom` is a function in the site's code that only the site can run. */
+type StoredHolidays = HolidayCalendarName | 'custom';
+declare const CALENDAR_NAMES: readonly HolidayCalendarName[];
+declare const STORED_HOLIDAYS: readonly StoredHolidays[];
+/** The calendar a country has, or `undefined` when Ginko has none for it. */
+declare function calendarOfCountry(country: string): HolidayCalendarName | undefined;
+/**
+ * The stored calendar of a site: an explicit `calendar` wins (a function is `custom`), else the calendar of `country`
+ * (`none` for a country without one), else `undefined` (unset: each caller keeps its own default, Austria in the gastro preset).
+ */
+declare function holidaysOf(site: {
+    country?: string;
+    calendar?: HolidaysOption;
+}): StoredHolidays | undefined;
+
 /**
  * A locale code: a canonical BCP-47 tag such as `de`, `es`, `pt-BR` or `zh-Hant`, the key of every translated
  * value and the URL segment (not the `languages` tag used for `lang` and formats). Open; `isLocale` is the runtime check.
@@ -1341,6 +2084,8 @@ interface DateField extends FieldBase {
 }
 interface TimeField extends FieldBase {
     type: 'time';
+    /** Another time field of the brick that this one must be later than (an end after its start), checked when both are set. */
+    after?: string;
 }
 interface DateRangeField extends FieldBase {
     type: 'daterange';
@@ -1359,6 +2104,12 @@ interface ChoicesField<V extends string = string> extends FieldBase {
         label: Label;
     }[];
     max?: number;
+    /**
+     * A text field next to this one (a field of the same brick, or a column of the same list row) that this choice answers
+     * for, such as the dish of its allergens. When that text changes in the main language and this choice does not, the
+     * Studio asks whether it is still right and Save waits for the answer.
+     */
+    askAgainWhen?: string;
 }
 interface ListField<F extends Fields = Fields> extends FieldBase {
     type: 'list';
@@ -1403,7 +2154,10 @@ declare const isPrefillToken: (value: unknown) => value is PrefillToken;
  * A quick task of a brick. `needsApproval: true`: what staff does with this task goes live only after an owner or
  * admin approves it (SPEC 17). `F` is the fields of the brick: in `single()` and `collection()` a task names only
  * fields the brick has, and a prefill is written like that field's value (see `ValueInput`). The release check
- * reports a token on a field that is not a `date`.
+ * reports a token on a field that is not a `date`. A `create` task may list `fields`: it then asks for and writes only
+ * those (besides its prefill and the fields' defaults), like an `edit` task. Without `fields` it asks for every field
+ * but the slug and the plan of a planned change. The release check wants every required field without a default
+ * (and not a slug) in `fields` or in the prefill.
  */
 type Task<F extends Fields = Fields> = {
     id: string;
@@ -1417,6 +2171,7 @@ type Task<F extends Fields = Fields> = {
     id: string;
     label: Label;
     kind: 'create';
+    fields?: readonly (keyof F & string)[];
     prefill?: Prefill<F>;
     needsApproval?: boolean;
 } | {
@@ -1445,6 +2200,35 @@ type Visibility<K extends string = string> = {
     days?: number;
     deleteExpired?: boolean;
 };
+/**
+ * The one-line status of a collection on the Studio's Today page, computed on the server from the live entries:
+ * `next` the first entry whose date (a `date`, or a `daterange` that has not ended) is today or later; `count` how many
+ * entries end within 7 days (needs `visible: { mode: 'until' }`); `missing` how many entries leave an optional field
+ * without a default empty; `age` the newest entry by a date field and how long ago that is. A status also says when a
+ * section is due: entries end within 7 days, entries miss the field, or the next entry is within 7 days and misses a
+ * required text. Changing it changes no stored data.
+ */
+type CollectionStatus<D extends string = string, K extends string = string> = {
+    next: D;
+} | {
+    count: true;
+} | {
+    missing: K;
+} | {
+    age: D;
+};
+/**
+ * The status of a single brick on the Studio's Today page: `hours` shows today's opening hours ("Open today
+ * 11:30–14:30", "Closed today") from the brick's `week`, `exceptions`, `closedOn` and `holidays` fields.
+ * `{ hours: { plans: 'hourPlans' } }` also reads the site's hour plans (a collection of `hourPlans()`, by its key): the
+ * line follows the plan that applies today.
+ */
+type SingleStatus = {
+    hours: true | {
+        plans: string;
+    };
+};
+type BrickStatus = CollectionStatus | SingleStatus;
 /** Where a brick's content comes from: the platform (default) or Markdown files in the site's repo (CONTENT.md). */
 type BrickSource = 'files';
 interface SingleBrick<F extends Fields = Fields> {
@@ -1459,6 +2243,19 @@ interface SingleBrick<F extends Fields = Fields> {
     /** How the Studio shows field groups: headings one below the other, or tabs on wide screens (phones always show headings). */
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task[];
+    /**
+     * A planned change of one field: from the date in `from` on, the value in `next` replaces `field`, e.g. a price that
+     * goes up on the 1st. `next` (the type of `field`) and `from` (a date) are optional fields that are set together, and
+     * every edit task that changes `field` shows them too. The site applies the plan; the platform checks it and opens a
+     * task on the value in effect.
+     */
+    planned?: {
+        field: string;
+        next: string;
+        from: string;
+    };
+    /** The status line on the Studio's Today page (see `SingleStatus`). */
+    status?: SingleStatus;
     /** @internal Platform-managed: set when the brick is listed in `retired`. Do not set it. */
     retired?: true;
 }
@@ -1475,6 +2272,17 @@ interface CollectionBrick<F extends Fields = Fields, R extends Partial<Record<Lo
     /** How the Studio shows field groups: headings one below the other, or tabs on wide screens (phones always show headings). */
     layout?: 'sections' | 'tabs';
     tasks?: readonly Task[];
+    /**
+     * A planned change of one field: from the date in `from` on, the value in `next` replaces `field`, e.g. a price that
+     * goes up on the 1st. `next` (the type of `field`) and `from` (a date) are optional fields that are set together, and
+     * every edit task that changes `field` shows them too. The site applies the plan; the platform checks it and opens a
+     * task on the value in effect.
+     */
+    planned?: {
+        field: string;
+        next: string;
+        from: string;
+    };
     max: number;
     /** `manual`: the owner sorts the entries. Else by a field, ascending unless `dir: 'desc'`. */
     order: 'manual' | {
@@ -1484,8 +2292,10 @@ interface CollectionBrick<F extends Fields = Fields, R extends Partial<Record<Lo
     route?: R;
     visible?: Visibility;
     /**
-     * What an entry does in a language where a translatable required field is missing or outdated: `'fallback'`
-     * (default) shows the main language there, `'hide'` leaves the entry out of that language.
+     * What an entry does in a language where a translatable required field is missing (an outdated translation still
+     * counts): `'hide'` leaves it out of that language (no page, not in lists, sitemap or hreflang); `'fallback'` shows
+     * the main language there and, with a `route`, links to the main-language page. Default: `'hide'` with a `route`,
+     * else `'fallback'` (`untranslatedMode`).
      */
     untranslated?: 'fallback' | 'hide';
     /** Entries of this collection plan weeks of the single brick `brick`; `field` (a date field here) holds the first day of the week (`week.firstDay`). A planned week counts as entered for the weekly upkeep rule. */
@@ -1495,6 +2305,8 @@ interface CollectionBrick<F extends Fields = Fields, R extends Partial<Record<Lo
     };
     /** Entries can be saved as drafts and are shown only once published. */
     drafts?: boolean;
+    /** The status line on the Studio's Today page (see `CollectionStatus`). Without one, a collection with drafts shows its drafts and scheduled entries. */
+    status?: CollectionStatus;
     /** @internal Platform-managed: set when the brick is listed in `retired`. Do not set it. */
     retired?: true;
 }
@@ -1527,6 +2339,8 @@ interface Schema {
     currency: Currency;
     /** First day of the week and weekend days of the site (computed once from the main language or `firstDayOfWeek`). */
     week: WeekInfo;
+    /** The public-holiday calendar of the site (`calendar`, else from `country`); absent when the config sets neither. */
+    holidays?: StoredHolidays;
     /** Static pages by key, each with its path per locale (the home page is the one whose main-locale path is `/`). */
     pages: Record<string, Partial<Record<Locale, string>>>;
     bricks: Record<string, Brick>;
@@ -1550,5 +2364,5 @@ interface Issue {
     message: string;
 }
 
-export { ALT_MAX as A, GINKO_COMPONENTS_KEY as G, MARKDOWN_PROFILES as N, PREFILL_TOKENS as a0, UNSAFE_LINK as a9, weekInfoOf as aA, workWeekOf as aB, URL_PROPS as aa, addDays as ad, componentProblems as ae, componentPropMessage as af, componentPropProblem as ag, coreCatalogs as ah, coreMessage as ai, defineComponents as aj, describeProfile as ak, effectiveAlt as al, effectiveMax as am, effectiveProfile as an, f as ao, isPrefillToken as ap, isShown as aq, isTranslatable as ar, msg as as, parseMarkdown as at, plainText as au, profileCovers as av, resolveToken as aw, startOfWeek as ax, textBlocks as ay, todayIn as az, DEFAULT_WEEK as p, GINKO_TOC_KEY as w };
-export type { NumberField as $, Brick as B, Currency as C, Described as D, ListField as E, Fields as F, Localized as H, Issue as I, Json as J, LongTextField as K, Locale as L, MarkdownTree as M, MarkdownField as O, ParseOptions as P, MarkdownProfile as Q, RetiredRule as R, Schema as S, Task as T, MarkdownToc as U, Visibility as V, WeekInfo as W, MarkdownValue as X, MigrationDescriptor as Y, Money as Z, MoneyField as _, ComponentRegistry as a, ParsedMarkdown as a1, PrefillToken as a2, RefField as a3, SlugField as a4, TextBlock as a5, TextField as a6, TimeField as a7, TocLink as a8, UnknownChoice as ab, ValueOf as ac, Msg as b, Label as c, BrickSource as d, CollectionBrick as e, SingleBrick as f, FileField as g, BooleanField as h, BrickValue as i, ChoiceField as j, ChoiceOption as k, ChoicesField as l, ComponentDef as m, ComponentSlot as n, CoreKey as o, DataOf as q, DateField as r, DateRangeField as s, Field as t, FieldType as u, FileValue as v, ImageField as x, ImageValue as y, ItemOf as z };
+export { ALT_INVISIBLE as K, ALT_MAX as O, CALENDAR_NAMES as X, DEFAULT_WEEK as a1, GINKO_COMPONENTS_KEY as a5, GINKO_TOC_KEY as a6, effectiveProfile as aA, f as aB, firstDayShown as aC, holidaysOf as aD, isPrefillToken as aE, isShown as aF, isTranslatable as aG, msg as aH, parseMarkdown as aI, plainText as aJ, profileCovers as aK, resolveToken as aL, startOfWeek as aM, textBlocks as aN, todayIn as aO, weekInfoOf as aP, wordsOf as aQ, workWeekOf as aR, zoneOffset as aS, zonedDateTime as aT, MARKDOWN_PROFILES as aa, PREFILL_TOKENS as ag, STORED_HOLIDAYS as aj, UNSAFE_LINK as am, URL_PROPS as an, addDays as aq, componentProblems as ar, componentPropMessage as as, componentPropProblem as at, coreCatalogs as au, coreMessage as av, defineComponents as aw, describeProfile as ax, effectiveAlt as ay, effectiveMax as az, calendarOfCountry as z };
+export type { ComponentSlot as $, AttributeRegistry as A, Brick as B, Currency as C, DateField as D, Issue as E, Fields as F, Described as G, HolidaysOption as H, ImageField as I, Json as J, Locale as L, MarkdownTree as M, NumberField as N, ParseOptions as P, BrickStatus as Q, RetiredRule as R, Schema as S, Task as T, BrickValue as U, Visibility as V, WeekInfo as W, ChoiceOption as Y, ChoicesField as Z, ComponentDef as _, Msg as a, CoreKey as a0, DataOf as a2, FieldType as a3, FileValue as a4, ImageValue as a7, ItemOf as a8, Localized as a9, MarkdownProfile as ab, MarkdownToc as ac, MarkdownValue as ad, MigrationDescriptor as ae, Money as af, ParsedMarkdown as ah, PrefillToken as ai, TextBlock as ak, TocLink as al, UnknownChoice as ao, ValueOf as ap, ComponentRegistry as b, Label as c, BrickSource as d, CollectionStatus as e, CollectionBrick as f, SingleStatus as g, SingleBrick as h, TextField as i, SlugField as j, DateRangeField as k, TimeField as l, MarkdownField as m, MoneyField as n, BooleanField as o, Field as p, RefField as q, ChoiceField as r, Holiday as s, HolidayCalendar as t, StoredHolidays as u, ListField as v, LongTextField as w, FileField as x, HolidayCalendarName as y };