@eifi1/ui-kit 0.17.0 → 0.19.0

package/dist/{kit-labels-C4uB_zmg.d.ts → kit-labels-D1J2_jyD.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { AnchorHTMLAttributes, Ref, ReactElement, ButtonHTMLAttributes, ReactNode, SelectHTMLAttributes, InputHTMLAttributes, ComponentPropsWithoutRef, TextareaHTMLAttributes } from 'react';
+import { AnchorHTMLAttributes, Ref, ReactElement, ButtonHTMLAttributes, ReactNode, SelectHTMLAttributes, ComponentPropsWithoutRef, InputHTMLAttributes, TextareaHTMLAttributes } from 'react';
 import { DataTableLabels } from './components/data-table-labels.js';
 import { MiniCalendarLabels, WeekDay } from './components/mini-calendar.js';
 import { CalendarHeatmapLabels } from './components/calendar-heatmap.js';
@@ -22,7 +22,7 @@ import { PasswordStrengthLabels } from './components/password-strength.js';
 import { DangerConfirmLabels } from './components/danger-confirm.js';
 import { SwatchPickerLabels } from './components/swatch-picker.js';
 import { IconPickerLabels } from './components/icon-picker.js';
-import { DialogFrameLabels } from './components/dialog-frame.js';
+import { DialogFrameProps, DialogFrameLabels } from './components/dialog-frame.js';
 import { MeasuredGridLabels } from './components/measured-grid.js';
 import { f as FeedbackAttachmentFieldLabels, q as FeedbackDialogTextLabels } from './feedback-attachment-WFiXJ8We.js';
 import { FeedbackThreadLabels, FeedbackComposerLabels } from './feedback/feedback-thread.js';
@@ -42,6 +42,12 @@ import { ErrorBoundaryLabels } from './components/error-boundary.js';
 import { AuthedImageLabels } from './components/authed-image.js';
 import { ImageGridLabels } from './components/image-grid.js';
 import { LightboxLabels } from './components/lightbox.js';
+import { WriteLockLabels } from './components/write-lock.js';
+import { LegalLabels } from './components/legal.js';
+import { RoleDefinition, AccountStateLabels } from './components/account-chips.js';
+import { ReauthDialogLabels } from './components/reauth-dialog.js';
+import { ServerWakeLabels } from './components/server-wake.js';
+import { TranslationReviewLabels } from './components/translation-review-labels.js';
 
 type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "brand" | "link";
 type ButtonSize = "sm" | "md";
@@ -145,6 +151,13 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
      * DangerConfirm keeps its own.
      */
     disabledReason?: ReactNode;
+    /**
+     * This button COMMITS — it saves, creates, deletes. Under a locked
+     * {@link WriteLockProvider} it is disabled the `disabledReason` way, with the lock's
+     * reason (which wins over a `disabledReason` of its own). No provider, or an
+     * unlocked one: no effect. See {@link WriteLockProvider}.
+     */
+    commit?: boolean;
     /**
      * Busy — the save is in flight: a spinner, `aria-busy`, and no second submit.
      *
@@ -219,6 +232,7 @@ interface ButtonLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>,
     pending?: never;
     pressed?: never;
     disabledReason?: never;
+    commit?: never;
 }
 declare function Button(props: ButtonLinkProps): ReactElement;
 declare function Button(props: ButtonProps): ReactElement;
@@ -427,6 +441,10 @@ interface IconButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
      * reason nobody can see is not one. Wins over `disabled`, as on Button.
      */
     disabledReason?: ReactNode;
+    /** This action COMMITS — {@link Button}'s `commit`: under a locked
+     *  {@link WriteLockProvider} it takes the `disabledReason` path with the lock's
+     *  reason. No effect without a lock. */
+    commit?: boolean;
     /** The `<button>` element — a prop in React 19, as on {@link Button}. */
     ref?: Ref<HTMLButtonElement>;
     /** Only on the link form — see {@link IconButtonLinkProps}. */
@@ -470,6 +488,7 @@ interface IconButtonLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElemen
     form?: never;
     pressed?: never;
     disabledReason?: never;
+    commit?: never;
     disabledStyle?: never;
     pending?: never;
 }
@@ -1446,7 +1465,8 @@ type FormActionsPlacement = "inline" | "sticky" | "dialog";
  * md 768, lg 1024, xl 1280px), as `BulkActionBar`'s `variant` breakpoints are, and
  * resolved the same way, in JS: the sticky row is positioned by inline style, which a
  * `md:` class cannot reach. keksdose switched `placement` on its own media query at
- * every long form for want of this.
+ * every long form for want of this. The breakpoints are the VIEWPORT's, not the
+ * container's: a form in a narrow pane on a wide screen resolves to `md`.
  */
 interface ResponsiveFormActionsPlacement {
     base: FormActionsPlacement;
@@ -1468,7 +1488,7 @@ type FormActionsStickyWithin = "viewport" | "container";
  * analytics, an `aria-describedby`. The props FormActions drives itself (type, click,
  * disabled, variant, form, children, the busy state) are not among them.
  */
-type FormActionsSubmitProps = Omit<ButtonProps, "type" | "onClick" | "disabled" | "disabledReason" | "variant" | "form" | "children" | "aria-busy"> & {
+type FormActionsSubmitProps = Omit<ButtonProps, "type" | "onClick" | "disabled" | "disabledReason" | "variant" | "form" | "children" | "aria-busy" | "commit"> & {
     [key: `data-${string}`]: string | number | boolean | undefined;
 };
 /** The start-side action of {@link FormActionsProps.destructive}, as data. */
@@ -1515,6 +1535,18 @@ interface FormActionsProps extends Omit<ComponentPropsWithoutRef<"div">, "childr
     submitDisabled?: boolean;
     /** Why save is disabled — see Button's `disabledReason`. Keeps it focusable. */
     submitDisabledReason?: ReactNode;
+    /**
+     * Save is a commit: under a locked {@link WriteLockProvider} it is disabled with the
+     * lock's reason (over `submitDisabledReason`), focusable, the reason in its tooltip —
+     * Button's `commit`. The `{ label, onClick }` form of {@link destructive} is a
+     * commit too and is locked with it; Cancel and `children` are not (closing a form
+     * writes nothing). No provider, or an unlocked one: no effect. Default `false`.
+     *
+     * keksdose wrote `submitDisabled={lock.locked || …}` and
+     * `submitDisabledReason={lock.locked ? lock.reason : undefined}` at each form; this is
+     * that pair, read from the provider.
+     */
+    commit?: boolean;
     /** The save button's variant. Default `brand`; `danger` for a save that destroys
      *  (kastlan's `destructive` flag on its own FormActions). */
     submitVariant?: ButtonVariant;
@@ -1545,7 +1577,8 @@ interface FormActionsProps extends Omit<ComponentPropsWithoutRef<"div">, "childr
      * from both sides, with the content scrolling past it in the gutters (keksdose wrote
      * `@max-md:-mx-3 @max-md:px-3` by hand). Pass the container's padding (`"0.75rem"`,
      * `12`, `"var(--pane-px)"`). Applied only while the resolved placement is sticky, so
-     * `placement={{ base: "sticky", md: "inline" }}` bleeds on the phone alone.
+     * `placement={{ base: "sticky", md: "inline" }}` bleeds on the phone alone. The margin
+     * is `calc(-1 * X)`; jsdom folds that to `calc(-X)`, so match it loosely in tests.
      */
     bleed?: string | number;
     /**
@@ -1591,7 +1624,187 @@ interface FormActionsProps extends Omit<ComponentPropsWithoutRef<"div">, "childr
  * The spinner is the kit's {@link Spinner}, drawn inside the button with `label={null}`
  * so the button's name stays its text; `aria-busy` is what says it is working.
  */
-declare function FormActions({ onCancel, onSubmit, submitLabel, cancelLabel, pendingLabel, submitIcon: SubmitIcon, submitProps, pending, submitDisabled, submitDisabledReason, submitVariant, destructive, start: startSlot, align, placement: placementProp, stickyWithin, bleed, form, children, className, style, ...rest }: FormActionsProps): react.JSX.Element;
+declare function FormActions({ onCancel, onSubmit, submitLabel, cancelLabel, pendingLabel, submitIcon: SubmitIcon, submitProps, pending, submitDisabled, submitDisabledReason, commit, submitVariant, destructive, start: startSlot, align, placement: placementProp, stickyWithin, bleed, form, children, className, style, ...rest }: FormActionsProps): react.JSX.Element;
+
+/**
+ * Who holds one record, and the owner's every way of changing that — Kurvenschmiede's
+ * `features/sharing/share-dialog.tsx` and keksdose's `features/budgets/budget-share-card.tsx`,
+ * which are the same component twice (Kurvenschmiede's own doc comment says so).
+ *
+ * Presentational: the kit draws the rows, asks before a removal (the kit's
+ * {@link useConfirm}), keeps the field and the busy state, and checks only that an
+ * address is SHAPED like one. Everything that is policy stays with the app — who may
+ * share, whether an address has an account (that is what makes a grant pending), what
+ * a role permits, every request — through the callbacks, which may return a promise.
+ */
+interface ShareCardLabels {
+    /** ShareDialog's heading. */
+    dialogTitle: string;
+    /** ShareDialog's close button. */
+    close: string;
+    /** The add field's label. */
+    email: string;
+    /** The add field's label when `addWithoutEmail` lets it stay empty. */
+    emailOptional: string;
+    emailPlaceholder: string;
+    /** Under the field when what was typed is not an address. */
+    invalidEmail: string;
+    /** Accessible name of the role choice beside the field. */
+    role: string;
+    /** Accessible name of one grantee's role choice. */
+    roleOf: (name: string) => string;
+    /** The add button. */
+    add: string;
+    /** Heading over the list. */
+    whoHasAccess: string;
+    /** The list is empty. */
+    nobodyYet: string;
+    /** Chip on a grant whose address has no account yet. */
+    pending: string;
+    /** A pending grant with no address — a link anybody holding it can redeem. */
+    openInvite: string;
+    copyLink: string;
+    /** A candidate that is a team (its sublabel, and the line under a team row). */
+    team: string;
+    /** Under the field while a team is the one named. */
+    teamHint: (name: string) => string;
+    /** The remove button on a grantee. */
+    remove: string;
+    removeConfirm: (name: string) => string;
+    /** The remove button on a pending grant. */
+    revokePending: string;
+    revokePendingConfirm: (name: string) => string;
+    /** A callback rejected and no `formatError` says better. */
+    failed: string;
+    /** Shown while `loading`. */
+    loading: string;
+}
+declare const DEFAULT_SHARE_CARD_LABELS: ShareCardLabels;
+/**
+ * One role of the app's vocabulary: Kurvenschmiede's viewer/editor, keksdose's guest.
+ *
+ * The admin roster's {@link RoleDefinition} (label, tone, icon) plus the key it is
+ * filed under — an ARRAY here rather than the keyed `RoleVocabulary` record,
+ * because the order is the order of the role choice's segments.
+ */
+type ShareRole = RoleDefinition & {
+    key: string;
+    /** What the role allows — under the role choice once chosen, and the chip's tooltip. */
+    description?: string;
+};
+/** Somebody (or a team) who holds the record now. */
+interface ShareGrantee {
+    id: string | number;
+    name: string;
+    /** The second line. A team row says {@link ShareCardLabels.team} instead. */
+    email?: string | null;
+    /** A {@link ShareRole.key}. */
+    role: string;
+    /** `team`: the grant reaches everybody in it (Kurvenschmiede). Default `person`. */
+    kind?: "person" | "team";
+    /** Shown, but neither its role nor its access can be changed here (an owner row). */
+    locked?: boolean;
+    /** The app's own line under the row — keksdose's per-guest key delivery. */
+    extra?: ReactNode;
+}
+/** A grant waiting for its address to have an account — or, with no address, an
+ *  open invite link (keksdose). */
+interface SharePendingGrant {
+    id: string | number;
+    email?: string | null;
+    /** A {@link ShareRole.key}; left out when the app has only one role. */
+    role?: string;
+    /** The invite link, offered with a copy button. */
+    link?: string;
+}
+/** A completion offered while typing: a past grantee, or one of the sharer's teams. */
+interface ShareCandidate {
+    id: string | number;
+    name: string;
+    /** A person's address: taking the row fills the field with it, and the grant is
+     *  then an ordinary address grant. */
+    email?: string | null;
+    /** `team` (or a person with no address): taking the row names THIS candidate, and
+     *  `onAdd` receives it instead of an address. */
+    kind?: "person" | "team";
+    icon?: ReactNode;
+}
+/** What the add button asks for. Exactly one of `email` / `candidate` is set, except
+ *  under `addWithoutEmail`, where both may be null (an open invite). */
+interface ShareAddRequest {
+    email: string | null;
+    candidate: ShareCandidate | null;
+    /** A {@link ShareRole.key}. */
+    role: string;
+}
+type MaybePromise = void | Promise<unknown>;
+interface SharePanelProps {
+    grantees: ShareGrantee[];
+    /** The role vocabulary, in display order. One role: no choice is offered and each
+     *  row shows its chip. */
+    roles: ShareRole[];
+    pending?: SharePendingGrant[];
+    /** Completions for the field. Left out: the field is a plain address field. */
+    candidates?: ShareCandidate[];
+    /** The role a new grant starts with. Default: the first of `roles`. */
+    defaultRole?: string;
+    /** Resolve to clear the field; reject to keep it and show the error. Left out (or
+     *  `readOnly`): no add form. */
+    onAdd?: (request: ShareAddRequest) => MaybePromise;
+    /** Left out: roles are shown as chips. */
+    onRoleChange?: (grantee: ShareGrantee, role: string) => MaybePromise;
+    /** Called after the kit's confirm. Left out: no remove button. */
+    onRemove?: (grantee: ShareGrantee) => MaybePromise;
+    /** Called after the kit's confirm. Left out: no withdraw button. */
+    onRevokePending?: (grant: SharePendingGrant) => MaybePromise;
+    /** keksdose: an empty field is a request too — an invite link with no address. */
+    addWithoutEmail?: boolean;
+    /** Under the add field: whatever the app needs said there (Kurvenschmiede's "your
+     *  pending grant does not let anybody register"). A function receives the taken
+     *  candidate, so it can say something else while a team is named. */
+    caption?: ReactNode | ((candidate: ShareCandidate | null) => ReactNode);
+    /** Above everything — what sharing means here (keksdose's guest explanation). */
+    intro?: ReactNode;
+    /** The list is being fetched: a spinner instead of the rows. */
+    loading?: boolean;
+    /** The app's own error, shown in the error box (wins over a caught rejection). */
+    error?: ReactNode;
+    /** Turns a callback's rejection into words. Default {@link ShareCardLabels.failed}. */
+    formatError?: (error: unknown) => ReactNode;
+    /** Look, do not touch: no form, chips for roles, no remove buttons. Copying an
+     *  invite link still works. */
+    readOnly?: boolean;
+    /** Focus the field on mount — a dialog that exists to add somebody. */
+    autoFocus?: boolean;
+    labels?: Partial<ShareCardLabels>;
+}
+/**
+ * The body both forms share: the add form, then the list. Exported for an app that
+ * frames it itself (a settings section, a sheet).
+ */
+declare function SharePanel({ grantees, roles, pending, candidates, defaultRole, onAdd, onRoleChange, onRemove, onRevokePending, addWithoutEmail, caption, intro, loading, error, formatError, readOnly, autoFocus, labels: labelsProp, }: SharePanelProps): react.JSX.Element;
+interface ShareCardProps extends SharePanelProps {
+    /** A heading over the card. */
+    title?: ReactNode;
+    /** The Card's variant. Default `outline` — a block inside a section, as keksdose's
+     *  card under a budget row is. */
+    variant?: CardProps["variant"];
+    className?: string;
+}
+/** {@link SharePanel} in a card — keksdose's inline form, under the row it shares. */
+declare function ShareCard({ title, variant, className, ...panel }: ShareCardProps): react.JSX.Element;
+interface ShareDialogProps extends SharePanelProps, Pick<DialogFrameProps, "open" | "onClose" | "size" | "className"> {
+    /** The heading. Default {@link ShareCardLabels.dialogTitle}. */
+    title?: ReactNode;
+    /** Under the heading — what is being shared (Kurvenschmiede passes its name). */
+    description?: ReactNode;
+}
+/**
+ * {@link SharePanel} in the kit's {@link DialogFrame} with a Close button —
+ * Kurvenschmiede's form. Sharing commits as it goes, so there is nothing to save or
+ * cancel: Close is the only action.
+ */
+declare function ShareDialog({ open, onClose, size, className, title, description, ...panel }: ShareDialogProps): react.JSX.Element;
 
 /**
  * EVERY string the kit renders, as one typed tree — and an optional provider that
@@ -1806,6 +2019,19 @@ interface UiKitLabels {
     authedImage: AuthedImageLabels;
     imageGrid: ImageGridLabels;
     lightbox: LightboxLabels;
+    /** 0.18.0: `WriteLockProvider`'s fallback reason, `AccountStateChip`, `SharePanel` /
+     *  `ShareCard` / `ShareDialog`, `ReauthDialog`. */
+    writeLock: WriteLockLabels;
+    accountState: AccountStateLabels;
+    shareCard: ShareCardLabels;
+    reauthDialog: ReauthDialogLabels;
+    /** 0.18.0: `ServerWakeNotice` — keksdose's cold-start notice, for every app. */
+    serverWake: ServerWakeLabels;
+    /** 0.19.0: the translation-review parts (`TranslationReviewPanel`, its editor, chip,
+     *  progress, locale tabs and export) — keksdose's /translations, for every app. */
+    translationReview: TranslationReviewLabels;
+    /** 0.19.0: `LegalLinks`' navigation name — the legal pages' shell, for every app. */
+    legal: LegalLabels;
 }
 /**
  * A label override, as deep as the labels go: an object of labels (a namespace, or a
@@ -1939,13 +2165,14 @@ declare function useKitFileLabels(prop?: Partial<FileLabels>): FileLabels;
  * The dot paths of every key `labels` does NOT supply — the ones a translated app is
  * still showing in English. Assert on it in the app's own test:
  *
- *     expect(missingKitLabels(de)).toEqual([]);
+ *     expect(missingKitLabels(labels, DEFAULT_UI_KIT_LABELS)).toEqual([]);
  *
  * `reference` is the complete tree to check against — pass
  * {@link DEFAULT_UI_KIT_LABELS} (src/i18n/defaults.ts). It is a parameter rather than an import
  * because the defaults live beside their components, and this module is imported BY
- * those components.
+ * those components. Left out (a test file is not type-checked), it throws saying so
+ * rather than "Cannot convert undefined or null to object" (keksdose, 0.18).
  */
 declare function missingKitLabels(labels: UiKitLabelOverrides | undefined, reference: UiKitLabels): string[];
 
-export { FIELD_DISPLAY as $, type AppShellLabels as A, Button as B, type CalculatorLabels as C, CopyButton as D, type CopyButtonLabels as E, type CopyButtonProps as F, type CurrencyLabels as G, DEFAULT_APP_SHELL_LABELS as H, DEFAULT_CALCULATOR_LABELS as I, DEFAULT_COMBOBOX_LABELS as J, DEFAULT_COMMON_LABELS as K, DEFAULT_COPY_BUTTON_LABELS as L, DEFAULT_CURRENCY_LABELS as M, DEFAULT_DATE_PICKER_LABELS as N, DEFAULT_FILE_LABELS as O, DEFAULT_FILE_PICKER_LABELS as P, DEFAULT_FORM_ACTIONS_LABELS as Q, DEFAULT_MULTI_SELECT_LABELS as R, DEFAULT_PASSWORD_REVEAL_LABELS as S, DEFAULT_PICKER_SHEET_LABELS as T, DEFAULT_SWIPEABLE_ROW_LABELS as U, DEFAULT_TABS_LABELS as V, DEFAULT_TOP_BAR_LABELS as W, type DatePickerLabels as X, EmptyState as Y, type EmptyStateProps as Z, FIELD_BASE as _, type ButtonClassesOptions as a, type UiKitLabels as a$, FIELD_FLOATING_PAD as a0, FIELD_INVALID as a1, FIELD_TRIGGER as a2, FIELD_WRITABLE_LOOK as a3, FLOATING_INPUT_CLASS as a4, FLOATING_LABEL_CLASS as a5, FLOATING_LABEL_STATIC as a6, FieldChevron as a7, type FieldChevronProps as a8, FieldHint as a9, type IconButtonToneColor as aA, type IconButtonVariant as aB, Input as aC, type InputProps as aD, type KitLinkComponent as aE, type KitLinkProps as aF, Label as aG, type LabelOverride as aH, type LabelProps as aI, type MultiSelectLabels as aJ, PHONE_QUERY as aK, type PasswordRevealLabels as aL, type PickerSheetLabels as aM, type ResponsiveFormActionsPlacement as aN, Select as aO, type SelectProps as aP, Spinner as aQ, type SpinnerProps as aR, type SwipeableRowLabels as aS, type TabItem as aT, Tabs as aU, type TabsLabels as aV, type TabsProps as aW, Textarea as aX, type TextareaProps as aY, type TopBarLabels as aZ, type UiKitLabelOverrides as a_, type FieldHintProps as aa, FieldLabel as ab, type FieldLabelProps as ac, FileButton as ad, type FileButtonProps as ae, type FileLabels as af, type FilePickerLabels as ag, type FileRejection as ah, type FileRejectionReason as ai, type FileScreenOptions as aj, FloatingField as ak, type FloatingFieldProps as al, FormActions as am, type FormActionsAlign as an, type FormActionsDestructive as ao, type FormActionsLabels as ap, type FormActionsPlacement as aq, type FormActionsProps as ar, type FormActionsStickyWithin as as, type FormActionsSubmitProps as at, IconButton as au, type IconButtonGlyphSize as av, type IconButtonLinkProps as aw, type IconButtonProps as ax, type IconButtonSize as ay, type IconButtonTone as az, type ButtonLinkProps as b, UiKitProvider as b0, type UiKitProviderProps as b1, type UseFilePickerOptions as b2, type UseFilePickerReturn as b3, buttonClasses as b4, formatFileSize as b5, matchesAccept as b6, missingKitLabels as b7, resolvePasswordRevealLabels as b8, useFilePicker as b9, useKitChartTooltipPlacement as ba, useKitFileLabels as bb, useKitLabelOverrides as bc, useKitLabels as bd, useKitLink as be, useKitLocale as bf, useKitWeekStart as bg, type FilePickHandler as bh, formatAccept as bi, judgePick as bj, screenFiles as bk, summariseRejections as bl, type ButtonProps as c, type ButtonSize as d, type ButtonTone as e, type ButtonVariant as f, Card as g, CardAction as h, type CardActionProps as i, CardContent as j, type CardContentProps as k, type CardDensity as l, CardDescription as m, type CardDescriptionProps as n, CardFooter as o, type CardFooterProps as p, CardHeader as q, type CardHeaderProps as r, type CardProps as s, CardTitle as t, type CardTitleLevel as u, type CardTitleProps as v, type CardTone as w, type ChartTooltipPlacement as x, type ComboboxLabels as y, type CommonLabels as z };
+export { FIELD_BASE as $, type AppShellLabels as A, Button as B, type CalculatorLabels as C, CopyButton as D, type CopyButtonLabels as E, type CopyButtonProps as F, type CurrencyLabels as G, DEFAULT_APP_SHELL_LABELS as H, DEFAULT_CALCULATOR_LABELS as I, DEFAULT_COMBOBOX_LABELS as J, DEFAULT_COMMON_LABELS as K, DEFAULT_COPY_BUTTON_LABELS as L, DEFAULT_CURRENCY_LABELS as M, DEFAULT_DATE_PICKER_LABELS as N, DEFAULT_FILE_LABELS as O, DEFAULT_FILE_PICKER_LABELS as P, DEFAULT_FORM_ACTIONS_LABELS as Q, DEFAULT_MULTI_SELECT_LABELS as R, DEFAULT_PASSWORD_REVEAL_LABELS as S, DEFAULT_PICKER_SHEET_LABELS as T, DEFAULT_SHARE_CARD_LABELS as U, DEFAULT_SWIPEABLE_ROW_LABELS as V, DEFAULT_TABS_LABELS as W, DEFAULT_TOP_BAR_LABELS as X, type DatePickerLabels as Y, EmptyState as Z, type EmptyStateProps as _, type ButtonClassesOptions as a, type SharePendingGrant as a$, FIELD_DISPLAY as a0, FIELD_FLOATING_PAD as a1, FIELD_INVALID as a2, FIELD_TRIGGER as a3, FIELD_WRITABLE_LOOK as a4, FLOATING_INPUT_CLASS as a5, FLOATING_LABEL_CLASS as a6, FLOATING_LABEL_STATIC as a7, FieldChevron as a8, type FieldChevronProps as a9, type IconButtonTone as aA, type IconButtonToneColor as aB, type IconButtonVariant as aC, Input as aD, type InputProps as aE, type KitLinkComponent as aF, type KitLinkProps as aG, Label as aH, type LabelOverride as aI, type LabelProps as aJ, type MultiSelectLabels as aK, PHONE_QUERY as aL, type PasswordRevealLabels as aM, type PickerSheetLabels as aN, type ResponsiveFormActionsPlacement as aO, Select as aP, type SelectProps as aQ, type ShareAddRequest as aR, type ShareCandidate as aS, ShareCard as aT, type ShareCardLabels as aU, type ShareCardProps as aV, ShareDialog as aW, type ShareDialogProps as aX, type ShareGrantee as aY, SharePanel as aZ, type SharePanelProps as a_, FieldHint as aa, type FieldHintProps as ab, FieldLabel as ac, type FieldLabelProps as ad, FileButton as ae, type FileButtonProps as af, type FileLabels as ag, type FilePickerLabels as ah, type FileRejection as ai, type FileRejectionReason as aj, type FileScreenOptions as ak, FloatingField as al, type FloatingFieldProps as am, FormActions as an, type FormActionsAlign as ao, type FormActionsDestructive as ap, type FormActionsLabels as aq, type FormActionsPlacement as ar, type FormActionsProps as as, type FormActionsStickyWithin as at, type FormActionsSubmitProps as au, IconButton as av, type IconButtonGlyphSize as aw, type IconButtonLinkProps as ax, type IconButtonProps as ay, type IconButtonSize as az, type ButtonLinkProps as b, type ShareRole as b0, Spinner as b1, type SpinnerProps as b2, type SwipeableRowLabels as b3, type TabItem as b4, Tabs as b5, type TabsLabels as b6, type TabsProps as b7, Textarea as b8, type TextareaProps as b9, type TopBarLabels as ba, type UiKitLabelOverrides as bb, type UiKitLabels as bc, UiKitProvider as bd, type UiKitProviderProps as be, type UseFilePickerOptions as bf, type UseFilePickerReturn as bg, buttonClasses as bh, formatFileSize as bi, matchesAccept as bj, missingKitLabels as bk, resolvePasswordRevealLabels as bl, useFilePicker as bm, useKitChartTooltipPlacement as bn, useKitFileLabels as bo, useKitLabelOverrides as bp, useKitLabels as bq, useKitLink as br, useKitLocale as bs, useKitWeekStart as bt, type FilePickHandler as bu, formatAccept as bv, judgePick as bw, screenFiles as bx, summariseRejections as by, type ButtonProps as c, type ButtonSize as d, type ButtonTone as e, type ButtonVariant as f, Card as g, CardAction as h, type CardActionProps as i, CardContent as j, type CardContentProps as k, type CardDensity as l, CardDescription as m, type CardDescriptionProps as n, CardFooter as o, type CardFooterProps as p, CardHeader as q, type CardHeaderProps as r, type CardProps as s, CardTitle as t, type CardTitleLevel as u, type CardTitleProps as v, type CardTone as w, type ChartTooltipPlacement as x, type ComboboxLabels as y, type CommonLabels as z };

package/dist/lib/floating-stack.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What floats over the bottom of the screen right now, so a notice that comes and goes
+ * can sit above it instead of on it.
+ *
+ * kastlan 0.18: its offline pill is a `bottom-start` FloatingActionButton, and
+ * `ServerWakeNotice` sits in the same corner — right after a break both show at once
+ * (the photo outbox syncs while the first reads wake the server), one over the other.
+ * The FAB's `offset` cannot help: the notice comes and goes, and on a phone it is
+ * nearly as wide as the screen, so a FAB in EITHER corner can be under it.
+ *
+ * Measured, not declared: a FloatingActionButton registers its fixed element while it
+ * is mounted, and a notice asks {@link clearanceAbove} for the height it has to clear —
+ * whatever offset, `extended` label or `hidden` state the controls are in. A control
+ * that is `hidden` measures 0 × 0 and is skipped, so kastlan's pill, which stays
+ * mounted and hidden while there is nothing to report, costs the notice nothing.
+ *
+ * Internal: not exported from the barrel.
+ */
+/** Track `element` until the returned function is called. Size changes — a label that
+ *  grows, `hidden` toggling — notify the subscribers too. */
+declare function registerFloating(element: HTMLElement): () => void;
+/** Hear every registration, removal and size change. */
+declare function subscribeFloating(listener: () => void): () => void;
+/**
+ * The distance from the viewport's bottom edge to the top of the highest visible
+ * floating control that shares a column with `element` — what `element` has to clear —
+ * or `null` when nothing is under it.
+ */
+declare function clearanceAbove(element: HTMLElement | null): number | null;
+
+export { clearanceAbove, registerFloating, subscribeFloating };

package/dist/lib/floating-stack.js

@@ -0,0 +1,42 @@
+"use client";
+const occupants = /* @__PURE__ */ new Set();
+const listeners = /* @__PURE__ */ new Set();
+let observer = null;
+function notify() {
+  for (const listener of listeners) listener();
+}
+function registerFloating(element) {
+  occupants.add(element);
+  if (observer === null && typeof ResizeObserver !== "undefined") observer = new ResizeObserver(notify);
+  observer?.observe(element);
+  notify();
+  return () => {
+    occupants.delete(element);
+    observer?.unobserve(element);
+    notify();
+  };
+}
+function subscribeFloating(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function clearanceAbove(element) {
+  if (!element) return null;
+  const own = element.getBoundingClientRect();
+  let top = Infinity;
+  for (const other of occupants) {
+    const box = other.getBoundingClientRect();
+    if (box.width === 0 || box.height === 0) continue;
+    if (box.right <= own.left || box.left >= own.right) continue;
+    top = Math.min(top, box.top);
+  }
+  return top === Infinity ? null : Math.max(0, window.innerHeight - top);
+}
+export {
+  clearanceAbove,
+  registerFloating,
+  subscribeFloating
+};
+//# sourceMappingURL=floating-stack.js.map

package/dist/lib/floating-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/floating-stack.ts"],"sourcesContent":["/**\n * What floats over the bottom of the screen right now, so a notice that comes and goes\n * can sit above it instead of on it.\n *\n * kastlan 0.18: its offline pill is a `bottom-start` FloatingActionButton, and\n * `ServerWakeNotice` sits in the same corner — right after a break both show at once\n * (the photo outbox syncs while the first reads wake the server), one over the other.\n * The FAB's `offset` cannot help: the notice comes and goes, and on a phone it is\n * nearly as wide as the screen, so a FAB in EITHER corner can be under it.\n *\n * Measured, not declared: a FloatingActionButton registers its fixed element while it\n * is mounted, and a notice asks {@link clearanceAbove} for the height it has to clear —\n * whatever offset, `extended` label or `hidden` state the controls are in. A control\n * that is `hidden` measures 0 × 0 and is skipped, so kastlan's pill, which stays\n * mounted and hidden while there is nothing to report, costs the notice nothing.\n *\n * Internal: not exported from the barrel.\n */\n\nconst occupants = new Set<HTMLElement>();\nconst listeners = new Set<() => void>();\nlet observer: ResizeObserver | null = null;\n\nfunction notify() {\n  for (const listener of listeners) listener();\n}\n\n/** Track `element` until the returned function is called. Size changes — a label that\n *  grows, `hidden` toggling — notify the subscribers too. */\nexport function registerFloating(element: HTMLElement): () => void {\n  occupants.add(element);\n  if (observer === null && typeof ResizeObserver !== \"undefined\") observer = new ResizeObserver(notify);\n  observer?.observe(element);\n  notify();\n  return () => {\n    occupants.delete(element);\n    observer?.unobserve(element);\n    notify();\n  };\n}\n\n/** Hear every registration, removal and size change. */\nexport function subscribeFloating(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/**\n * The distance from the viewport's bottom edge to the top of the highest visible\n * floating control that shares a column with `element` — what `element` has to clear —\n * or `null` when nothing is under it.\n */\nexport function clearanceAbove(element: HTMLElement | null): number | null {\n  if (!element) return null;\n  const own = element.getBoundingClientRect();\n  let top = Infinity;\n  for (const other of occupants) {\n    const box = other.getBoundingClientRect();\n    if (box.width === 0 || box.height === 0) continue;\n    if (box.right <= own.left || box.left >= own.right) continue;\n    top = Math.min(top, box.top);\n  }\n  return top === Infinity ? null : Math.max(0, window.innerHeight - top);\n}\n"],"mappings":";AAmBA,MAAM,YAAY,oBAAI,IAAiB;AACvC,MAAM,YAAY,oBAAI,IAAgB;AACtC,IAAI,WAAkC;AAEtC,SAAS,SAAS;AAChB,aAAW,YAAY,UAAW,UAAS;AAC7C;AAIO,SAAS,iBAAiB,SAAkC;AACjE,YAAU,IAAI,OAAO;AACrB,MAAI,aAAa,QAAQ,OAAO,mBAAmB,YAAa,YAAW,IAAI,eAAe,MAAM;AACpG,YAAU,QAAQ,OAAO;AACzB,SAAO;AACP,SAAO,MAAM;AACX,cAAU,OAAO,OAAO;AACxB,cAAU,UAAU,OAAO;AAC3B,WAAO;AAAA,EACT;AACF;AAGO,SAAS,kBAAkB,UAAkC;AAClE,YAAU,IAAI,QAAQ;AACtB,SAAO,MAAM;AACX,cAAU,OAAO,QAAQ;AAAA,EAC3B;AACF;AAOO,SAAS,eAAe,SAA4C;AACzE,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,MAAM,QAAQ,sBAAsB;AAC1C,MAAI,MAAM;AACV,aAAW,SAAS,WAAW;AAC7B,UAAM,MAAM,MAAM,sBAAsB;AACxC,QAAI,IAAI,UAAU,KAAK,IAAI,WAAW,EAAG;AACzC,QAAI,IAAI,SAAS,IAAI,QAAQ,IAAI,QAAQ,IAAI,MAAO;AACpD,UAAM,KAAK,IAAI,KAAK,IAAI,GAAG;AAAA,EAC7B;AACA,SAAO,QAAQ,WAAW,OAAO,KAAK,IAAI,GAAG,OAAO,cAAc,GAAG;AACvE;","names":[]}

package/dist/lib/server-wake.d.ts

@@ -0,0 +1,146 @@
+/**
+ * "Is the server asleep, or is the app broken?" — the cold-start watchdog, lifted
+ * from keksdose (feedback #199) so kastlan and Kurvenschmiede get it too.
+ *
+ * All three backends run on Cloud Run with `--min-instances=0`: after an idle
+ * period the container is gone and the first request has to start it, which takes
+ * several seconds and occasionally more. Nothing in the UI said so, and none of the
+ * axios instances has a timeout, so the honest experience was a spinner that looked
+ * stuck. This counts the in-flight requests a cold start would actually delay and
+ * escalates in two steps, so a merely slow response says "still loading" and only a
+ * genuinely long wait blames the sleeping server.
+ *
+ * Framework-free on purpose (no zustand, no axios, no React): a counter, two timers
+ * and a listener set, read by `useServerWakeStage` through `useSyncExternalStore`.
+ * The adapters below take the app's axios instance / fetch as an ARGUMENT, so the
+ * kit never imports either.
+ *
+ * WHAT ARMS IT, and why the default is narrow:
+ *   - reads (GET) — what every page does on open — always;
+ *   - writes only when the app says so (`watchReadsAnd(/\/auth\/login\b/)`): the
+ *     auth POSTs that gate the app are the only writes a user waits on before the
+ *     app exists at all, so a cold start there looks exactly like a broken login.
+ * An UPLOAD must never be watched — a statement PDF or a photo takes seconds on a
+ * perfectly warm server, and "the server is waking up" during a 4 s upload would
+ * simply be false. With the default that holds by itself (an upload is a POST);
+ * an app widening `shouldWatch` keeps its upload routes out of it.
+ *
+ * Nor a DOWNLOAD, for the same reason (kastlan 0.18): axios answers only once the
+ * whole body is in, so a generated PDF or a large photo — a GET — ran past both
+ * thresholds on a warm server, and held the count for every read beside it. The
+ * default filter skips a request whose `responseType` is `"blob"`, `"arraybuffer"` or
+ * `"stream"`; a custom filter gets the request as its third argument to do the same.
+ * (`wrapFetch` ends the wait at the headers, so a download through it is harmless.)
+ *
+ * It never arms while the browser is offline, whatever `shouldWatch` says: that state
+ * has its own, truthful indicator, and a request that never left the device is not
+ * evidence of anything about the server.
+ */
+/** `slow` = longer than a warm server ever takes; `waking` = long enough that a cold
+ *  start is the only sensible explanation. */
+type ServerWakeStage = "idle" | "slow" | "waking";
+/** Decides which requests count. `method` arrives lower-cased (`"get"` when the
+ *  request named none — axios's and fetch's default); `url` as the client had it;
+ *  `request` is what the adapter saw — for axios the request config itself, so
+ *  `responseType` or the app's own fields can decide. */
+type ServerWakeFilter = (method: string, url: string, request: ServerWakeRequest) => boolean;
+interface ServerWakeOptions {
+    /** Past this, a warm round trip is out of the question (a cold database query on a
+     *  free tier can still take a second, so it is not tighter). Default 2000 ms. */
+    slowMs?: number;
+    /** Past this, the container was almost certainly scaled to zero. Default 7000 ms. */
+    wakingMs?: number;
+    /** Which requests count. Default {@link watchReadsAnd}`()` — GETs only, downloads
+     *  excluded. The offline guard runs before it and cannot be overridden. */
+    shouldWatch?: ServerWakeFilter;
+}
+/** What a request is, for {@link ServerWakeWatcher.track} and a {@link ServerWakeFilter}. */
+interface ServerWakeRequest {
+    method?: string;
+    url?: string;
+    /** axios's `responseType`. `"blob"`, `"arraybuffer"` and `"stream"` mark a download,
+     *  which the default filter does not count. */
+    responseType?: string;
+}
+interface ServerWakeWatcher {
+    /**
+     * Count a request that is going out, and arm the escalation if it is the first.
+     * Returns whether it was counted — the caller MUST call {@link end} exactly once
+     * for every `true`, or the counter never returns to zero and the notice sticks.
+     * (The axios adapter stashes it on the request config for that reason.)
+     * `request` reaches the filter as its third argument; default `{ method, url }`.
+     */
+    start(method?: string, url?: string, request?: ServerWakeRequest): boolean;
+    /** A counted request settled — either way: an error still proves the server
+     *  answered or gave up. When the last one does, the notice goes away. Never takes
+     *  the counter below zero. */
+    end(): void;
+    /** `start` + `end` around a promise (or a function returning one), for a request
+     *  that does not go through an adapter. Resolves and rejects as the work does. */
+    track<T>(work: PromiseLike<T> | (() => PromiseLike<T>), request?: ServerWakeRequest): Promise<T>;
+    /** Back to a pristine watchdog — for tests, which share an instance across cases. */
+    reset(): void;
+    /** `useSyncExternalStore`'s pair. Listeners hear stage changes only. */
+    subscribe(listener: () => void): () => void;
+    getStage(): ServerWakeStage;
+    /** Counted requests currently outstanding. */
+    getInFlight(): number;
+}
+/**
+ * The usual filter: every GET, plus any other request whose URL matches `writes` —
+ * keksdose's `/\/auth\/(login|register|demo-session)\b/` — but never a download
+ * (`responseType` `"blob"`, `"arraybuffer"` or `"stream"`). Keep upload routes out of
+ * the pattern (see the module comment).
+ */
+declare function watchReadsAnd(writes?: RegExp): ServerWakeFilter;
+declare function createServerWake({ slowMs, wakingMs, shouldWatch, }?: ServerWakeOptions): ServerWakeWatcher;
+/**
+ * The shared instance: what `<ServerWakeNotice />`, `useServerWakeStage()`,
+ * {@link attachServerWake} and {@link wrapFetch} use when no watcher is passed. GETs
+ * only, default timings — an app that also watches its login POST creates its own
+ * with {@link createServerWake} and passes it to both ends.
+ */
+declare const serverWake: ServerWakeWatcher;
+/** The config fields the watchdog reads — what axios's request config has. The whole
+ *  config reaches the filter, so an app's filter can read the rest of it. */
+interface ServerWakeAxiosConfig {
+    method?: string;
+    url?: string;
+    responseType?: string;
+}
+/** The slice of an interceptor manager the adapter uses. A method (not a function
+ *  property) so axios's wider `use(onFulfilled?, onRejected?, options?)` fits it. */
+interface InterceptorManagerLike<V> {
+    use(onFulfilled: (value: V) => V | Promise<V>, onRejected: (error: unknown) => unknown): number;
+    eject(id: number): void;
+}
+/** An axios instance, structurally — so the kit types the adapter without importing
+ *  axios. `axios.create()`'s result fits it as is. */
+interface AxiosLikeInstance<C extends ServerWakeAxiosConfig, R extends {
+    config: C;
+}> {
+    interceptors: {
+        request: InterceptorManagerLike<C>;
+        response: InterceptorManagerLike<R>;
+    };
+}
+/**
+ * Drive a watcher from an axios instance's interceptors: `attachServerWake(api)`.
+ * Returns a function that ejects both interceptors again.
+ *
+ * Attach it BEFORE the app's own response interceptors: axios runs those in the order
+ * they were added, so the wake one ends the wait before a 401 handler awaits a token
+ * refresh — otherwise the notice would keep counting a request that has already been
+ * answered. (Request-side order does not matter.)
+ */
+declare function attachServerWake<C extends ServerWakeAxiosConfig, R extends {
+    config: C;
+}>(instance: AxiosLikeInstance<C, R>, watcher?: ServerWakeWatcher): () => void;
+/**
+ * A `fetch` that drives a watcher: `const apiFetch = wrapFetch(fetch)`. The wait ends
+ * when the response's HEADERS arrive (or the call fails) — the server is awake by then,
+ * however long the body takes.
+ */
+declare function wrapFetch(fetchImpl?: typeof fetch, watcher?: ServerWakeWatcher): typeof fetch;
+
+export { type AxiosLikeInstance, type ServerWakeAxiosConfig, type ServerWakeFilter, type ServerWakeOptions, type ServerWakeRequest, type ServerWakeStage, type ServerWakeWatcher, attachServerWake, createServerWake, serverWake, watchReadsAnd, wrapFetch };