zabi-components 8.0.0 → 8.1.0

package/dist/components/util/photo.d.ts

@@ -0,0 +1,215 @@
+/**
+ * Public types and pure helpers for `PhotoGrid` and `PhotoViewer`.
+ *
+ * Everything a gesture means is worked out here, on numbers: where a pinch
+ * leaves the photo, how far it may be panned, whether a swipe turns the page.
+ * The components only feed pointers in and apply the result, so the
+ * arithmetic can be tested without a browser.
+ */
+import type { Component } from "svelte";
+export type PhotoKey = string | number;
+/** One photo. `PhotoGrid` and `PhotoViewer` take the same array. */
+export interface Photo {
+    /** Stable identity, when the same `src` may appear twice or may change. Without it, `src` is the identity. */
+    id?: PhotoKey;
+    /** The full image, shown in the viewer. */
+    src: string;
+    /** A small version for the grid, and for the viewer while the full image loads. Without it, `src`. */
+    thumbSrc?: string;
+    /** What the photo shows, for those who cannot see it. */
+    alt: string;
+    /** Width of the full image in px. With `height` it reserves the photo's box before it has loaded. */
+    width: number;
+    /** Height of the full image in px. */
+    height: number;
+    /** Shown under the photo in the viewer. */
+    caption?: string;
+}
+export declare function photoKey(photo: Photo): PhotoKey;
+/** Payload of PhotoGrid's `onselect`. */
+export interface PhotoGridSelectDetail {
+    photo: Photo;
+    index: number;
+    /** False when the press cleared the photo's selection (only in `multiple`). */
+    selected: boolean;
+    /** Every selected key after the change: one or none in `single`. */
+    keys: PhotoKey[];
+}
+/** Every built-in string of PhotoGrid. Pass a partial object to `strings` to translate. */
+export interface PhotoGridStrings {
+    /** Visible label and name of the tile that adds a photo. */
+    addPhoto: string;
+    /** Name of a photo that has no `alt`. */
+    photoName: (position: number, total: number) => string;
+    /** Name of the last tile when it stands for the photos not shown. */
+    morePhotos: (count: number) => string;
+    /** Name of the button that opens a photo, in a grid where a press selects. */
+    openPhoto: (name: string) => string;
+    /** How to get around by keyboard. Read once when focus enters the grid, and shown while it has keyboard focus. */
+    keyboardHint: string;
+}
+export declare const PHOTO_GRID_STRINGS: PhotoGridStrings;
+/** What the user did to close the viewer. `swipe` is a swipe down on the photo. */
+export type PhotoViewerCloseReason = "escape" | "close-button" | "swipe";
+/** Something to do with the photo that is showing: share it, delete it. */
+export interface PhotoViewerAction {
+    id: string;
+    label: string;
+    /** An icon component, as `@lucide/svelte` icons are. */
+    icon?: Component<{
+        size?: number;
+        class?: string;
+    }>;
+    /** `danger` for a destructive action such as Delete. */
+    tone?: "danger";
+    disabled?: boolean;
+    onclick: (photo: Photo, index: number) => void;
+}
+/** Every built-in string of PhotoViewer. Pass a partial object to `strings` to translate. */
+export interface PhotoViewerStrings {
+    close: string;
+    previous: string;
+    next: string;
+    /** The counter that is shown: "3 / 12". */
+    counter: (position: number, total: number) => string;
+    /** The same for a screen reader, read out after the photo's `alt`: "3 of 12". */
+    position: (position: number, total: number) => string;
+    /** Announced, with a spinner, when a photo takes a while to load. */
+    loading: string;
+    /** Shown when a photo cannot be loaded. */
+    loadError: string;
+    retry: string;
+    /** Name of the menu that holds the actions that do not fit in the bar. */
+    moreActions: string;
+    /** The button that shows all of a long caption, and the one that folds it again. */
+    showMore: string;
+    showLess: string;
+    /** Name of a photo that has no `alt`. */
+    photoName: (position: number, total: number) => string;
+}
+export declare const PHOTO_VIEWER_STRINGS: PhotoViewerStrings;
+/** How many actions the viewer's bar shows before the rest go into a menu. */
+export declare const MAX_BAR_ACTIONS = 3;
+/** The actions shown in the bar, and those that go into the menu. */
+export declare function splitActions<T>(actions: readonly T[], max?: number): {
+    bar: T[];
+    menu: T[];
+};
+/** An index held inside a list of `count` photos; -1 for an empty list. */
+export declare function clampIndex(index: number, count: number): number;
+/** What the grid shows of `total` photos under `max`, and how many the last tile stands for. */
+export declare function visibleCount(total: number, max: number | undefined): {
+    shown: number;
+    hidden: number;
+};
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Where the photo is. `scale` 1 is the photo fitted to the screen. `x` and
+ * `y` are how far its centre is from the centre of the screen, in px.
+ */
+export interface PhotoTransform {
+    scale: number;
+    x: number;
+    y: number;
+}
+export declare const REST: PhotoTransform;
+export declare const MIN_SCALE = 1;
+export declare const MAX_SCALE = 4;
+/** What a double tap zooms to. */
+export declare const DOUBLE_TAP_SCALE = 2.5;
+export declare const isZoomed: (transform: PhotoTransform) => boolean;
+/** The largest size a photo of `photo` px takes inside `view` without being cropped. */
+export declare function fitSize(photo: Size, view: Size): Size;
+/**
+ * The transform with its pan held to the photo's edges: an edge of the photo
+ * never comes further in than the edge of the screen, and a side that is
+ * narrower than the screen stays centred. `fit` is the photo's size at scale 1.
+ */
+export declare function clampPan(transform: PhotoTransform, fit: Size, view: Size): PhotoTransform;
+/**
+ * Zooms to `scale` so that the point of the photo under `point` stays under
+ * it. `point` is measured from the centre of the screen.
+ */
+export declare function zoomAbout(transform: PhotoTransform, scale: number, point: Point, fit: Size, view: Size): PhotoTransform;
+/** Two fingers on the glass: the point between them, and how far apart they are. */
+export interface PinchSample {
+    centre: Point;
+    distance: number;
+}
+export declare function pinchSample(first: Point, second: Point): PinchSample;
+/**
+ * Where a pinch has taken the photo: scaled by how much the fingers have
+ * spread, about the point that was between them when it began, and moved with
+ * that point. Points are measured from the centre of the screen.
+ */
+export declare function pinchTransform(start: PhotoTransform, from: PinchSample, now: PinchSample, fit: Size, view: Size): PhotoTransform;
+/** A pinch let go a hair above the fitted size is the fitted size. */
+export declare function settleZoom(transform: PhotoTransform, fit: Size, view: Size): PhotoTransform;
+/** A double tap: in to 2.5 times about the tap from the fitted photo, and back to fitted from any zoom. */
+export declare function doubleTapTransform(transform: PhotoTransform, point: Point, fit: Size, view: Size): PhotoTransform;
+/** The photo moved by `delta` px, held to its edges. */
+export declare function panBy(transform: PhotoTransform, delta: Point, fit: Size, view: Size): PhotoTransform;
+/** One step of the keyboard or the wheel: in or out by half again, about the centre. */
+export declare const ZOOM_STEP = 1.5;
+/** Movement under this many px is a press, not a drag. */
+export declare const TAP_SLOP = 8;
+/** A press shorter than this is a tap, and two taps closer together than this are a double tap. */
+export declare const TAP_MS = 300;
+/** Two taps further apart than this are two taps. */
+export declare const DOUBLE_TAP_RADIUS = 32;
+export declare function isDoubleTap(previous: {
+    time: number;
+    point: Point;
+} | null, now: {
+    time: number;
+    point: Point;
+}): boolean;
+/**
+ * Which way a drag on the fitted photo is going, once it has gone far enough
+ * to tell: `x` turns the page, `down` closes, and null is not yet known. A
+ * drag upwards is neither, and stays null.
+ */
+export declare function dragAxis(delta: Point, slop?: number): "x" | "down" | null;
+/** Part of the screen's width a slow swipe has to cross to turn the page. */
+export declare const TURN_DISTANCE = 0.25;
+/** Part of the screen's height a slow swipe down has to cross to close. */
+export declare const CLOSE_DISTANCE = 0.2;
+/**
+ * What a horizontal swipe does when the finger lifts. A flick decides by its
+ * direction; a slow one by how far it went. Swiping left shows the next
+ * photo, and the previous one in a right-to-left layout. At either end there
+ * is nothing to turn to.
+ */
+export declare function swipeTurn(options: {
+    /** px moved; negative is to the left. */
+    distance: number;
+    /** px per ms at release; negative is to the left. */
+    velocity: number;
+    width: number;
+    index: number;
+    count: number;
+    rtl?: boolean;
+    flick: number;
+}): -1 | 0 | 1;
+/** Whether a swipe down closes the viewer when the finger lifts. */
+export declare function swipeCloses(options: {
+    /** px moved down. */
+    distance: number;
+    /** px per ms at release; positive is down. */
+    velocity: number;
+    height: number;
+    flick: number;
+}): boolean;
+/**
+ * How far a drag past the first or last photo moves it: a third of the
+ * finger's travel, so it gives but does not come away.
+ */
+export declare function resist(distance: number): number;
+//# sourceMappingURL=photo.d.ts.map

package/dist/components/util/photo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../../src/components/util/photo.ts"],"names":[],"mappings":"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"}

package/dist/components/util/portal.d.ts

@@ -0,0 +1,23 @@
+import type { Action } from "svelte/action";
+/**
+ * Where to render the node: `true` for `document.body`, an element, or a
+ * selector. `false` leaves the node where the template put it.
+ */
+export type PortalTarget = boolean | HTMLElement | string;
+/**
+ * Moves an overlay out of its ancestors so none of them can trap it: a
+ * `transform`, `filter` or `contain` ancestor becomes the containing block of a
+ * `position: fixed` child, and an `overflow: hidden` one then clips it.
+ *
+ * SSR-safe by construction: actions never run on the server, so the markup is
+ * rendered in place and moved on mount. The node is removed on destroy, and
+ * Svelte's own teardown of a node that has already gone is a no-op.
+ *
+ * Put it on the single root element of an `{#if}` block. The theme is a `.dark`
+ * class on an ancestor, so a node portalled to `body` keeps it only when the
+ * class sits on `<html>` or `<body>`.
+ *
+ * Usage: `<div use:portal>` or `<div use:portal={enabled}>`.
+ */
+export declare const portal: Action<HTMLElement, PortalTarget | undefined>;
+//# sourceMappingURL=portal.d.ts.map

package/dist/components/util/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/components/util/portal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;AAW1D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,YAAY,GAAG,SAAS,CA8BhE,CAAC"}

package/dist/components/util/pull-to-refresh.d.ts

@@ -0,0 +1,27 @@
+/** Public types and pure helpers for `PullToRefresh`. */
+/** The words a `PullToRefresh` says by itself. */
+export interface PullToRefreshStrings {
+    /** Shown while the list is being pulled, short of the threshold. */
+    pull: string;
+    /** Shown once letting go would refresh. */
+    release: string;
+    /** Shown, and announced, while the refresh runs. */
+    refreshing: string;
+    /** Announced when it has finished. */
+    done: string;
+    /** The button that refreshes without the gesture. */
+    refresh: string;
+}
+export declare const DEFAULT_PULL_TO_REFRESH_STRINGS: PullToRefreshStrings;
+/**
+ * How far the indicator has come out for a finger that has travelled
+ * `distance` px: half as far, so the list feels held, and never more than one
+ * and a half times the threshold.
+ */
+export declare function pullDistance(distance: number, threshold: number): number;
+/**
+ * What scrolls the element: its nearest ancestor that scrolls on the block
+ * axis, or the page.
+ */
+export declare function scrollContainerOf(element: HTMLElement): HTMLElement;
+//# sourceMappingURL=pull-to-refresh.d.ts.map

package/dist/components/util/pull-to-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-to-refresh.d.ts","sourceRoot":"","sources":["../../../src/components/util/pull-to-refresh.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACjC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,+BAA+B,EAAE,oBAM7C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAOnE"}

package/dist/components/util/radio-keys.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Where a key moves the selection in a radio group laid out in a row, as
+ * Rating and SegmentedControl are. Kept out of the components so it can be
+ * tested without a DOM.
+ *
+ * It is the native radio contract: Right and Down go to the next option, Left
+ * and Up to the previous one, both wrap, and Left and Right swap in a
+ * right-to-left layout.
+ *
+ * `current` is the option that has focus, which is not always the selected
+ * one: a screen reader's cursor can put focus on any radio, and the keys then
+ * move from where the user is. It is -1 when focus is on none of them: the
+ * next option is then the first, and the previous one the last.
+ *
+ * `hasSelection` is false while the group is empty. A forward key then selects
+ * the focused option itself instead of stepping over it, so Right on an empty
+ * rating gives one star, not two.
+ *
+ * Returns -1 for a key that is not a navigation key, or when there is nothing
+ * to move to.
+ */
+export declare function radioKeyIndex(key: string, current: number, count: number, rtl?: boolean, hasSelection?: boolean): number;
+/** Whether `node` is laid out right to left. */
+export declare function isRtl(node: Element): boolean;
+//# sourceMappingURL=radio-keys.d.ts.map

package/dist/components/util/radio-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio-keys.d.ts","sourceRoot":"","sources":["../../../src/components/util/radio-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,GAAG,UAAQ,EACX,YAAY,UAAO,GACpB,MAAM,CAeR;AAED,gDAAgD;AAChD,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAE5C"}

package/dist/components/util/rating.d.ts

@@ -0,0 +1,23 @@
+/** Types and pure helpers for `Rating`. Kept out of the component so they can be tested without a DOM. */
+/** Every built-in string. Pass a partial object to `strings` to translate. */
+export interface RatingStrings {
+    /**
+     * Accessible name of one star ("4 of 5 stars"), and of a read-only
+     * rating as a whole ("3.5 of 5 stars"). `value` is already formatted.
+     */
+    starLabel: (value: string, max: number) => string;
+    /** Accessible name of the clear button that `clearable` adds. */
+    clearLabel: string;
+    /** Shown, and read, for a read-only rating without a value. */
+    noRating: string;
+}
+export declare const RATING_STRINGS: RatingStrings;
+/** Number of stars: a whole number, at least one. */
+export declare function starCount(max: number): number;
+/** `value` held within 0..max; `null` for no rating or a value that is not a number. */
+export declare function clampRating(value: number | null | undefined, max: number): number | null;
+/** How much of star `star` (counted from 1) is filled, 0 to 1. */
+export declare function starFill(value: number | null, star: number): number;
+/** The value with at most one decimal: 4, 3.5, 3.7. */
+export declare function defaultRatingFormat(value: number): string;
+//# sourceMappingURL=rating.d.ts.map

package/dist/components/util/rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.d.ts","sourceRoot":"","sources":["../../../src/components/util/rating.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAE1G,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,EAAE,aAI5B,CAAC;AAEF,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxF;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/components/util/ready-made-strings.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The words of the components that come with text of their own: the colour
+ * picker, the ready-made contact form, and the two the docs site is built
+ * from. Each takes its own as `strings`; what is left out stays as it is here.
+ */
+/** `ColorPicker`. */
+export interface ColorPickerStrings {
+    /** Accessible name of the field the hex value is typed in. */
+    hexInput: string;
+    /** Accessible name of the swatch button that opens the picker. */
+    open: string;
+    /** Accessible name of the picker that opens. */
+    picker: string;
+    /** Accessible name of the hue slider in it. */
+    hue: string;
+    /** Accessible name of the colour map: the two sliders below, on one surface. */
+    area: string;
+    /** Accessible name of the map's slider that goes across. */
+    saturation: string;
+    /** Accessible name of the map's slider that goes up and down. */
+    lightness: string;
+    /** The message under the field while what is typed is not a hex colour. */
+    invalidHex: string;
+}
+export declare const DEFAULT_COLOR_PICKER_STRINGS: ColorPickerStrings;
+/** `ContactForm`: every label, placeholder and message of the form. */
+export interface ContactFormStrings {
+    heading: string;
+    nameLabel: string;
+    namePlaceholder: string;
+    emailLabel: string;
+    emailPlaceholder: string;
+    messageLabel: string;
+    messagePlaceholder: string;
+    subscribeLabel: string;
+    submit: string;
+    /** Under a field left empty or filled in wrongly. */
+    nameRequired: string;
+    emailRequired: string;
+    emailInvalid: string;
+    messageRequired: string;
+    /** The box above the fields when the form could not be sent: its three lines. */
+    errorTitle: string;
+    errorMessage: string;
+    errorRecovery: string;
+}
+export declare const DEFAULT_CONTACT_FORM_STRINGS: ContactFormStrings;
+/** `PropsTable`. The caption is the `caption` prop. */
+export interface PropsTableStrings {
+    name: string;
+    type: string;
+    required: string;
+    default: string;
+    description: string;
+    yes: string;
+    no: string;
+    /** Shown instead of the table when there are no props. */
+    empty: string;
+}
+export declare const DEFAULT_PROPS_TABLE_STRINGS: PropsTableStrings;
+/** `ComponentDemo`. */
+export interface ComponentDemoStrings {
+    /** The two tabs, and what the switch between them is called. */
+    preview: string;
+    code: string;
+    showPreview: string;
+    showCode: string;
+}
+export declare const DEFAULT_COMPONENT_DEMO_STRINGS: ComponentDemoStrings;
+/**
+ * Lays `strings` layers over a component's defaults, later layers winning. A
+ * key whose value is `undefined` is skipped, so `strings={{ close: t.close }}`
+ * with `t.close` missing keeps the default instead of blanking it. `null` and
+ * the empty string are kept: those are choices.
+ */
+export declare function mergeStrings<T extends object>(defaults: T, ...layers: Array<Partial<T> | null | undefined>): T;
+//# sourceMappingURL=ready-made-strings.d.ts.map

package/dist/components/util/ready-made-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ready-made-strings.d.ts","sourceRoot":"","sources":["../../../src/components/util/ready-made-strings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAqB;AACrB,MAAM,WAAW,kBAAkB;IAC/B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,4BAA4B,EAAE,kBAS1C,CAAC;AAEF,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,4BAA4B,EAAE,kBAiB1C,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,2BAA2B,EAAE,iBASzC,CAAC;AAEF,uBAAuB;AACvB,MAAM,WAAW,oBAAoB;IACjC,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,8BAA8B,EAAE,oBAK5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EACzC,QAAQ,EAAE,CAAC,EACX,GAAG,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAChD,CAAC,CASH"}

package/dist/components/util/scroll-padding.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `scroll-padding-bottom` on a scrolling box, shared between the things that
+ * lie over its bottom edge.
+ *
+ * Each of them saves what was there and puts it back when it leaves. Done one
+ * by one that goes wrong as soon as two overlap in time: the second saves the
+ * first one's value as "what was there", and if the first leaves first, the
+ * second later restores a value nobody owns any more. Here the box's own
+ * value is saved once, the largest request is what is set, and the box gets
+ * its own value back when the last request is released.
+ */
+/**
+ * Asks for room at the bottom of `container`. `set` gives or changes the
+ * amount in px; `release` withdraws the request. Call it in the browser.
+ */
+export declare function reserveScrollPaddingBottom(container: HTMLElement): {
+    set: (px: number) => void;
+    release: () => void;
+};
+//# sourceMappingURL=scroll-padding.d.ts.map

package/dist/components/util/scroll-padding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-padding.d.ts","sourceRoot":"","sources":["../../../src/components/util/scroll-padding.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,WAAW,GAAG;IAChE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACvB,CAuBA"}

package/dist/components/util/segmented-control.d.ts

@@ -0,0 +1,16 @@
+import type { Component } from "svelte";
+/** An icon component, as `@lucide/svelte` icons are. */
+export type SegmentedControlIcon = Component<{
+    size?: number;
+    class?: string;
+}>;
+/** One entry of SegmentedControl's `options`. */
+export interface SegmentedControlOption {
+    value: string;
+    label: string;
+    /** Rendered before the label. Decorative: the label names the segment. */
+    icon?: SegmentedControlIcon;
+    /** A disabled segment cannot be chosen, and the arrow keys skip it. */
+    disabled?: boolean;
+}
+//# sourceMappingURL=segmented-control.d.ts.map

package/dist/components/util/segmented-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmented-control.d.ts","sourceRoot":"","sources":["../../../src/components/util/segmented-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhF,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/components/util/select.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Every word a `Select` says by itself, shown or only read out. An app in
+ * another language passes its own through `strings`; what it leaves out stays
+ * as it is here. The older props for six of them (`placeholder`,
+ * `searchPlaceholder`, `noResultsText`, `loadingText`, `emptyStateTitle`,
+ * `emptyStateDescription`) still work, and win over `strings`.
+ */
+export interface SelectStrings {
+    /** Shown in the field while nothing is chosen, and the first, empty option of the native select. */
+    placeholder: string;
+    /** Placeholder and accessible name of the search field above the options. */
+    searchPlaceholder: string;
+    /** Shown in the list when the search matches nothing. */
+    noResults: string;
+    /** Shown in the field and in the list while `isLoading`. */
+    loading: string;
+    /** Heading of the box shown in the list when there are no options at all. */
+    emptyTitle: string;
+    /** The line under that heading. */
+    emptyDescription: string;
+    /** Accessible name of the list of options. */
+    listLabel: string;
+    /** Accessible name of the close button of the sheet the list opens in on a phone. */
+    closeLabel: string;
+    /** Accessible name of that sheet's grip while its button takes the sheet up to full height. */
+    expandLabel: string;
+    /** The same, while it takes the sheet back down. */
+    collapseLabel: string;
+}
+export declare const DEFAULT_SELECT_STRINGS: SelectStrings;
+/** How a Select shows its options. See the `presentation` prop. */
+export type SelectPresentation = "auto" | "popover" | "sheet" | "native";
+/** Marks the native `<select>` a Select renders, so a choice made in it before the page hydrates can be found. */
+export declare const NATIVE_SELECT_ATTRIBUTE = "data-zabi-select";
+/**
+ * What the visitor (or the browser, restoring a form) chose in `element`
+ * before its component mounted; `undefined` when it still has the value the
+ * server rendered, and for an element this module never saw.
+ */
+export declare function choiceBeforeMount(element: Element): string | undefined;
+//# sourceMappingURL=select.d.ts.map

package/dist/components/util/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/util/select.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC1B,oGAAoG;IACpG,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAWpC,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzE,kHAAkH;AAClH,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAgD1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE"}

package/dist/components/util/sheet-drag.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Dragging a bottom sheet with a finger or a pointer. Shared by `BottomSheet`
+ * and `SlideUp`, so the two cannot disagree on what a swipe is.
+ *
+ * It only reports the gesture: how far the pointer has travelled since the
+ * drag began and how fast it was going at the end. What that means (move the
+ * panel, snap, close) is the caller's.
+ */
+export interface SheetDragCallbacks {
+    /** Asked when a gesture could begin. Return false to leave it alone. */
+    canStart?: () => boolean;
+    onStart?: () => void;
+    /** `distance` in px since the drag began; positive is down. */
+    onMove: (distance: number) => void;
+    /** `velocity` in px per ms over the last moments of the drag; positive is down. */
+    onEnd: (distance: number, velocity: number, event: Event) => void;
+    /** The browser took the gesture back (a call came in, the pointer was lost). */
+    onCancel?: () => void;
+}
+export interface SheetDragTargets {
+    /**
+     * The grip and the area around it. A drag that starts here moves the
+     * sheet in either direction. Give it `touch-action: none`.
+     */
+    handleZone: HTMLElement;
+    /**
+     * The scrolling content. A touch that starts here scrolls it; only a
+     * downward swipe that begins with the content at its top moves the sheet.
+     */
+    scroller?: HTMLElement | null;
+}
+/** Movement under this many px is a press, not a drag. */
+export declare const DRAG_SLOP = 6;
+/**
+ * When a pointer or touch event happened: its own `timeStamp`, which is when
+ * the finger moved. The time the handler runs is later by however busy the
+ * page is, and unevenly so, which made a flick on a janky frame (or a loaded
+ * machine) measure slower than it was and spring back. An event without a
+ * usable stamp gets the clock.
+ */
+export declare function timeOf(event: Event): number;
+/**
+ * How fast a pointer was moving over the last moments of a gesture, on one
+ * axis. Also used by `PhotoViewer`, for both axes.
+ */
+export declare function createVelocityTracker(): {
+    reset(y: number, time: number): void;
+    add(y: number, time: number): void;
+    velocity(): number;
+};
+/**
+ * Listens for drags on a sheet. Call it when the sheet is open, in the
+ * browser, and call the returned function when it closes.
+ */
+export declare function attachSheetDrag({ handleZone, scroller }: SheetDragTargets, callbacks: SheetDragCallbacks): () => void;
+/** A flick: faster than this, in px per ms, and the direction decides, not the distance. */
+export declare const FLICK_VELOCITY = 0.5;
+/** True where the user has asked for less motion, or where that cannot be asked. */
+export declare function prefersReducedMotion(): boolean;
+//# sourceMappingURL=sheet-drag.d.ts.map

package/dist/components/util/sheet-drag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheet-drag.d.ts","sourceRoot":"","sources":["../../../src/components/util/sheet-drag.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,kBAAkB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+DAA+D;IAC/D,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,mFAAmF;IACnF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClE,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,UAAU,EAAE,WAAW,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AAED,0DAA0D;AAC1D,eAAO,MAAM,SAAS,IAAI,CAAC;AAS3B;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAG3C;AAKD;;;GAGG;AACH,wBAAgB,qBAAqB;aAIpB,MAAM,QAAQ,MAAM;WAGtB,MAAM,QAAQ,MAAM;gBAIf,MAAM;EAYzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,gBAAgB,EAC1C,SAAS,EAAE,kBAAkB,GAC9B,MAAM,IAAI,CAwKZ;AAED,4FAA4F;AAC5F,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,oFAAoF;AACpF,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C"}

package/dist/components/util/sidebar.d.ts

@@ -0,0 +1,63 @@
+/**
+ * The words the sidebar components say by themselves. Each takes its own as
+ * `strings`; `SidebarNavigation` takes them all and hands the footer and the
+ * brand header theirs.
+ */
+/** `SidebarBrandHeader`. */
+export interface SidebarBrandHeaderStrings {
+    /** The logo's alt text when neither `logoAlt` nor `brandName` is given. */
+    brandAlt: string;
+}
+export declare const DEFAULT_SIDEBAR_BRAND_HEADER_STRINGS: SidebarBrandHeaderStrings;
+/** `SidebarFooter`. */
+export interface SidebarFooterStrings {
+    /** Accessible name of the footer. */
+    accountAndSettings: string;
+    /** Accessible name of the profile button in a collapsed rail. */
+    openAccountPanel: string;
+    /** The same button in an expanded sidebar, with the profile's name. */
+    openAccountPanelFor: (name: string) => string;
+}
+export declare const DEFAULT_SIDEBAR_FOOTER_STRINGS: SidebarFooterStrings;
+/** `SidebarAccountPanel`. */
+export interface SidebarAccountPanelStrings {
+    /** Accessible name of the panel. */
+    panelLabel: string;
+    /** The panel's heading. */
+    title: string;
+    /** Accessible name of the close button. */
+    closeLabel: string;
+    /** Accessible name of the list of rows. */
+    listLabel: string;
+    /** The first row, above the profile's name. */
+    account: string;
+    /** The row that switches the theme. */
+    theme: string;
+    /** That row's second line, in each mode. */
+    lightMode: string;
+    darkMode: string;
+    /** With `themeModes="three"`: the mode that follows the system. */
+    systemMode: string;
+    /** The badge on that row, in each mode. */
+    light: string;
+    dark: string;
+    system: string;
+    /** The second line of the log-out row. Its first line is `logoutLabel`. */
+    signOut: string;
+}
+export declare const DEFAULT_SIDEBAR_ACCOUNT_PANEL_STRINGS: SidebarAccountPanelStrings;
+/** `SidebarNavigation`: its own words, and those of the footer and the brand header in it. */
+export interface SidebarNavigationStrings extends SidebarFooterStrings, SidebarBrandHeaderStrings {
+    /** Accessible name of the main list of links, when it has no section heading. */
+    primaryNavigation: string;
+    /** Accessible name of the second list of links. */
+    secondaryNavigation: string;
+    /** Accessible name of a list under a section heading, from the heading. */
+    sectionNavigation: (section: string) => string;
+    /** Shown when a search matches no link: the heading. */
+    noMatchesTitle: string;
+    /** And the line under it, with what was searched for. */
+    noMatchesDescription: (term: string) => string;
+}
+export declare const DEFAULT_SIDEBAR_NAVIGATION_STRINGS: SidebarNavigationStrings;
+//# sourceMappingURL=sidebar.d.ts.map