@oxy.so/bloom 4.0.0 → 4.1.0

package/lib/typescript/module/place-list/constants.d.ts

@@ -0,0 +1,32 @@
+import type { BloomIconComponent } from '../icons/icon-component';
+import type { PlaceListVisibility } from './types';
+/** The English default visibility words. */
+export declare const PLACE_LIST_VISIBILITY_LABELS: Readonly<Record<PlaceListVisibility, string>>;
+/** The glyph each visibility draws on its badge. */
+export declare const PLACE_LIST_VISIBILITY_ICON: Readonly<Record<PlaceListVisibility, BloomIconComponent>>;
+export interface PlaceListGeometry {
+    /** The cover strip's height. */
+    cover: number;
+    /** The strip's corner. */
+    coverRadius: number;
+    /** Between the strip's tiles. */
+    seam: number;
+    /** How many photos the strip shows. */
+    coverPhotos: number;
+    /** Between the card's blocks, and between two places in a list. */
+    gap: number;
+    /** A move or remove control's box. */
+    control: number;
+    /** The glyph inside that box. */
+    controlGlyph: number;
+}
+/**
+ * The strip is 112 tall because that is `listing-card`'s compact thumbnail
+ * (`COMPACT_PHOTO_SIZE`), which is the height of the place rows the list is
+ * made of — so a list's cover and the first place under it agree.
+ *
+ * The controls are 44 because that is the smallest comfortable touch target,
+ * and a saved list is edited with a thumb.
+ */
+export declare const PLACE_LIST_GEOMETRY: PlaceListGeometry;
+//# sourceMappingURL=constants.d.ts.map

package/lib/typescript/module/place-list/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/place-list/constants.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,4CAA4C;AAC5C,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAItF,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CAIhG,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAQjC,CAAC"}

package/lib/typescript/module/place-list/index.d.ts

@@ -0,0 +1,8 @@
+export { PlaceList } from './PlaceList';
+export { PlaceListCard } from './PlaceListCard';
+export { PLACE_LIST_GEOMETRY, PLACE_LIST_VISIBILITY_ICON, PLACE_LIST_VISIBILITY_LABELS, } from './constants';
+export type { PlaceListGeometry } from './constants';
+export { DEFAULT_PLACE_LIST_LABELS, composePlaceListName, placeListCountLabel, placeListSharedWithLabel, resolvePlaceListPaint, } from './shared';
+export type { PlaceListPaint } from './shared';
+export type { PlaceListCardProps, PlaceListLabels, PlaceListPlace, PlaceListProps, PlaceListVisibility, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/place-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/place-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,cAAc,EACd,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/lib/typescript/module/place-list/shared.d.ts

@@ -0,0 +1,38 @@
+/**
+ * What `place-list` paints, and the pure text it assembles.
+ *
+ * The colours are read off the surface the card or the list was dropped on
+ * (`styles/surface-levels.ts`) — a saved list is shown on a page, in a sheet
+ * and inside a panel, and nothing here picks a ramp stop.
+ */
+import { type SurfaceTextPaint } from '../styles/surface-levels';
+import type { Theme } from '../theme/types';
+import type { PlaceListCardProps, PlaceListLabels, PlaceListPlace } from './types';
+export interface PlaceListPaint extends SurfaceTextPaint {
+    /** Behind a cover photo that has not loaded, and the empty strip. */
+    tile: string;
+    /** A rule between two entries. */
+    hairline: string;
+    /** The keyboard focus ring. */
+    ring: string;
+}
+export declare function resolvePlaceListPaint(theme: Theme, surface: string): PlaceListPaint;
+/** `"12 places"`, and `"1 place"` for the one that would otherwise read wrong. */
+export declare function placeListCountLabel(count: number): string;
+/** `"Shared with 3"`. */
+export declare function placeListSharedWithLabel(count: number): string;
+/**
+ * The card in one utterance, in reading order: the name, how much is in it,
+ * who it is shared with, and whether anyone else can see it.
+ *
+ * Composed rather than left to ARIA's contents algorithm for the same reason
+ * `PlaceCard` composes its row: the card is ONE press target, and without a
+ * name it is announced as "Want to go 12 places Shared with 3 Shared" in one
+ * run with no commas.
+ */
+export declare function composePlaceListName(props: PlaceListCardProps): string;
+/** Every word `PlaceList` speaks, before the caller overrides any of them. */
+export declare const DEFAULT_PLACE_LIST_LABELS: PlaceListLabels;
+/** A place's name, for the controls that talk about it. */
+export declare function placeNameOf(entry: PlaceListPlace): string;
+//# sourceMappingURL=shared.d.ts.map

package/lib/typescript/module/place-list/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/place-list/shared.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEnF,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAOnF;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,yBAAyB;AACzB,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAOtE;AAED,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,EAAE,eAMvC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAEzD"}

package/lib/typescript/module/place-list/types.d.ts

@@ -0,0 +1,102 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { AvatarGroupItem } from '../avatar-group/types';
+import type { BloomIconComponent } from '../icons/icon-component';
+import type { PlaceCardProps } from '../place-card/types';
+/**
+ * Who can see a saved list. Three members because the middle one is the
+ * interesting case: a list that is not private is usually shared with NAMED
+ * people rather than published, and an app that can only say public/private
+ * has to lie about the common one.
+ */
+export type PlaceListVisibility = 'private' | 'shared' | 'public';
+export interface PlaceListCardProps {
+    /** The list's name ("Want to go", "Coffee, ranked"). */
+    name: string;
+    /** How many places are in it. Drawn through `countLabel`. */
+    count?: number;
+    /** Default `(n) => n === 1 ? '1 place' : \`${n} places\``. */
+    countLabel?: (count: number) => string;
+    /**
+     * The cover strip: the first four places' photos, each an absolute URL or an
+     * id the app's `ImageResolver` turns into one. The first one is wide.
+     */
+    photos?: readonly string[];
+    /** The `ImageResolver` rendition for a photo id. Ignored for URLs. */
+    photoVariant?: string;
+    /** What to draw on the strip when the list has no photos yet. */
+    empty?: ReactNode;
+    /**
+     * The list's own glyph, beside the name. DECORATIVE — a glyph put in the
+     * `name` string is read out as its character and cannot be coloured.
+     */
+    icon?: BloomIconComponent;
+    /**
+     * The person's colour for this list. It paints the glyph and tints the empty
+     * strip. It is the caller's colour and not a token, because a list's colour
+     * is a choice Bloom has no ramp for.
+     */
+    color?: string;
+    /** Default `private`. */
+    visibility?: PlaceListVisibility;
+    /** Replaces the English visibility word. */
+    visibilityLabel?: string;
+    /** The people it is shared with, as `AvatarGroup` items. */
+    collaborators?: readonly AvatarGroupItem[];
+    /** Default `(n) => \`Shared with ${n}\``. Announced, and drawn when there is room. */
+    sharedWithLabel?: (count: number) => string;
+    /** Opens the list. */
+    onPress?: () => void;
+    /** Replaces the composed name ("Want to go, 12 places, shared with 3"). */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Parts get `<testID>-cover`, `-name`, `-meta`, `-people`. */
+    testID?: string;
+}
+/** One place inside a saved list: the place, plus what the person said about it. */
+export interface PlaceListPlace {
+    /** Identifies the entry. Reordering, removing and keying all use it. */
+    id: string;
+    /**
+     * The place itself, drawn by `PlaceCard` at `density="row"` — the same row a
+     * search result is, because a saved place and a found place are the same
+     * object. `density`, `style` and `testID` are the list's to set.
+     */
+    place: Omit<PlaceCardProps, 'density' | 'style' | 'testID'>;
+    /** The person's own line about it ("Get the sourdough before noon"). */
+    note?: string;
+}
+/** Every word `PlaceList` speaks that is not in the data. */
+export interface PlaceListLabels {
+    /** Default `` (position) => `Move to position ${position - 1}` ``. */
+    moveEarlier: (position: number) => string;
+    /** Default `` (position) => `Move to position ${position + 1}` ``. */
+    moveLater: (position: number) => string;
+    /** Default `` (name) => `Remove ${name} from the list` ``. */
+    remove: (name: string) => string;
+    /** Announced politely after a move. Default `` (name, position, total) => `${name} moved to position ${position} of ${total}` ``. */
+    moved: (name: string, position: number, total: number) => string;
+    /** Names a place's note for a screen reader. Default `"Note"`. */
+    note: string;
+}
+export interface PlaceListProps {
+    places: readonly PlaceListPlace[];
+    /**
+     * Called with the WHOLE list in its new order. Setting it draws the move
+     * controls; without it the list is not reorderable.
+     */
+    onReorder?: (places: PlaceListPlace[]) => void;
+    /** Called with the entry's id. Setting it draws the remove control. */
+    onRemove?: (id: string) => void;
+    /** Stops reordering and removing, without hiding the controls. */
+    disabled?: boolean;
+    labels?: Partial<PlaceListLabels>;
+    /** Drawn instead of the list when there are no places. */
+    empty?: ReactNode;
+    /** Names the list. Default `"Saved places"`. */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Parts get `<testID>-item-<n>`, `-item-<n>-up`, `-down`, `-remove`, `-status`. */
+    testID?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/place-list/types.d.ts.map

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

package/lib/typescript/module/progressive-blur/ProgressiveBlur.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressiveBlur.d.ts","sourceRoot":"","sources":["../../../../src/progressive-blur/ProgressiveBlur.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,SAAa,EACb,SAAiB,EACjB,GAAG,IAAI,EACR,EAAE,oBAAoB,2CAsBtB;yBA3Be,eAAe"}
+{"version":3,"file":"ProgressiveBlur.d.ts","sourceRoot":"","sources":["../../../../src/progressive-blur/ProgressiveBlur.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,SAAa,EACb,SAAiB,EACjB,GAAG,IAAI,EACR,EAAE,oBAAoB,2CAuBtB;yBA5Be,eAAe"}

package/lib/typescript/module/proof-of-delivery/ProofOfDelivery.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+import type { ProofOfDeliveryProps } from './types';
+/**
+ * It happened: the proofs an app asks for at the door, and one result.
+ *
+ *   heading    the title and its line, when the caller gives them
+ *   blocks     one `Field` per proof, 20 apart, in the order the door is
+ *              worked through (`PROOF_ORDER`) whatever order the caller listed
+ *              them in — recipient, signature, code, photo, note
+ *   summary    after a confirm that could not go through, an `error`
+ *              `Admonition` in a `role="alert"` naming what is still missing
+ *   confirm    a primary `Button`, full width
+ *
+ * Every block is an existing Bloom control asked for one thing:
+ *
+ *   recipient  `TextFieldInput`
+ *   signature  `SignaturePad` (this family's one new surface)
+ *   code       `InputOtp` — it already cleans, pads and reports completion
+ *   photo      `SortablePhotoGrid` — the app owns the picker, the grid owns
+ *              the order, the per-photo upload state and the retry
+ *   note       `Textarea`
+ *
+ * `FileUpload` is deliberately not the photo control. It is a DROP ZONE with an
+ * upload lifecycle of its own — right for a document on a desktop, wrong at a
+ * door, where the photo comes from a camera the app opens and what has to be on
+ * screen afterwards is the picture, its upload state and a way to take another.
+ *
+ * ## Every proof is a `Field`, so being required is said once
+ *
+ * The label, the hint, the required mark, the error and the association with
+ * the control are the field's (`docs/composition.mdx`). Two of the five draw
+ * SEVERAL controls — the signature is a pad and a name, the photo is a grid —
+ * so those fields are `multiple`: one id on three inputs is invalid, and one
+ * error described by three inputs is announced three times.
+ *
+ * ## The confirm control is never disabled
+ *
+ * It fires `onSubmit` on every press, with `missing` filled in. A disabled
+ * confirm is the failure mode this avoids: the reader presses, nothing happens,
+ * and nothing on screen says why — least of all to a screen reader, which is
+ * told only that a button is dimmed. Pressing with something outstanding puts
+ * the error on each missing field AND the summary at the bottom, so the answer
+ * arrives in the same gesture that asked the question.
+ *
+ * The errors appear only AFTER the first press. A form that is red before it
+ * has been filled in is a form that is wrong about the reader.
+ */
+declare function ProofOfDeliveryComponent({ proofs, required, value: valueProp, defaultValue, onChange, onSubmit, onAddPhoto, onRetryPhoto, codeLength, signatureHeight, maxPhotos, submitting, disabled, title, description, actions, labels: labelOverrides, accessibilityLabel, style, testID, }: ProofOfDeliveryProps): import("react/jsx-runtime").JSX.Element;
+export declare const ProofOfDelivery: React.MemoExoticComponent<typeof ProofOfDeliveryComponent>;
+export {};
+//# sourceMappingURL=ProofOfDelivery.d.ts.map

package/lib/typescript/module/proof-of-delivery/ProofOfDelivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProofOfDelivery.d.ts","sourceRoot":"","sources":["../../../../src/proof-of-delivery/ProofOfDelivery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAuBpE,OAAO,KAAK,EAAa,oBAAoB,EAAwB,MAAM,SAAS,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,iBAAS,wBAAwB,CAAC,EAChC,MAAoB,EACpB,QAAa,EACb,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,UAAc,EACd,eAAe,EACf,SAAa,EACb,UAAkB,EAClB,QAAgB,EAChB,KAAK,EACL,WAAW,EACX,OAAO,EACP,MAAM,EAAE,cAAc,EACtB,kBAAwC,EACxC,KAAK,EACL,MAAM,GACP,EAAE,oBAAoB,2CAkNtB;AAED,eAAO,MAAM,eAAe,4DAAiC,CAAC"}

package/lib/typescript/module/proof-of-delivery/SignaturePad.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { SignaturePadProps } from './types';
+declare function SignaturePadComponent({ value: valueProp, defaultValue, onChange, onStrokeEnd, height, ink, strokeWidth, typed, disabled, labels: labelOverrides, accessibilityLabel, style, testID, }: SignaturePadProps): import("react/jsx-runtime").JSX.Element;
+export declare const SignaturePad: React.MemoExoticComponent<typeof SignaturePadComponent>;
+export {};
+//# sourceMappingURL=SignaturePad.d.ts.map

package/lib/typescript/module/proof-of-delivery/SignaturePad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignaturePad.d.ts","sourceRoot":"","sources":["../../../../src/proof-of-delivery/SignaturePad.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuD,MAAM,OAAO,CAAC;AAqB5E,OAAO,KAAK,EAAE,iBAAiB,EAAmC,MAAM,SAAS,CAAC;AAmDlF,iBAAS,qBAAqB,CAAC,EAC7B,KAAK,EAAE,SAAS,EAChB,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,MAAiC,EACjC,GAAG,EACH,WAAwC,EACxC,KAAY,EACZ,QAAgB,EAChB,MAAM,EAAE,cAAc,EACtB,kBAAkB,EAClB,KAAK,EACL,MAAM,GACP,EAAE,iBAAiB,2CAsMnB;AAED,eAAO,MAAM,YAAY,yDAA8B,CAAC"}

package/lib/typescript/module/proof-of-delivery/constants.d.ts

@@ -0,0 +1,40 @@
+import type { ProofKind, ProofOfDeliveryLabels } from './types';
+/** Every default word the family draws. */
+export declare const PROOF_LABELS: Required<ProofOfDeliveryLabels>;
+/**
+ * The order the door is worked through, and it is not arbitrary.
+ *
+ * Recipient first, because it is the one question the courier asks out loud and
+ * the answer to it decides the rest. Then the two proofs the RECIPIENT takes
+ * part in — the signature they give and the code they read out — then the photo,
+ * which is taken after they have gone, and the note last, because it is written
+ * about everything above it.
+ */
+export declare const PROOF_ORDER: readonly ProofKind[];
+/**
+ * The pad's geometry.
+ *
+ * `baseline` is where the rule sits as a fraction of the height: a signature is
+ * written ON a line, and without one a finger starts wherever it lands and the
+ * capture reads as a doodle. 0.72 leaves a descender's worth of room under it.
+ */
+export declare const PROOF_GEOMETRY: {
+    readonly padHeight: 180;
+    readonly padRadius: 12;
+    readonly baseline: 0.72;
+    /** How far in from each side the baseline stops. */
+    readonly baselineInset: 16;
+    readonly strokeWidth: 2.5;
+    /** Between the blocks of the form. */
+    readonly gap: 20;
+    /** Between a block's own parts. */
+    readonly blockGap: 8;
+    /**
+     * How far a finger must travel before a press becomes a stroke. Below it a
+     * single tap still records a DOT, which is what a full stop in a signature
+     * is — the threshold decides smoothing, never whether ink was laid down.
+     */
+    readonly smoothing: 2;
+};
+export type ProofGeometry = typeof PROOF_GEOMETRY;
+//# sourceMappingURL=constants.d.ts.map

package/lib/typescript/module/proof-of-delivery/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/proof-of-delivery/constants.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhE,2CAA2C;AAC3C,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,qBAAqB,CAqBxD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAM3C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;IAIzB,oDAAoD;;;IAGpD,sCAAsC;;IAEtC,mCAAmC;;IAEnC;;;;OAIG;;CAEK,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC"}

package/lib/typescript/module/proof-of-delivery/index.d.ts

@@ -0,0 +1,8 @@
+export { ProofOfDelivery } from './ProofOfDelivery';
+export { SignaturePad } from './SignaturePad';
+export { PROOF_GEOMETRY, PROOF_LABELS, PROOF_ORDER } from './constants';
+export type { ProofGeometry } from './constants';
+export { EMPTY_PROOF, EMPTY_SIGNATURE, completeProofValue, hasSignatureInk, isProofGiven, isSignatureGiven, missingProofs, orderProofs, resolveProofPaint, shouldKeepSignaturePoint, signaturePath, } from './shared';
+export type { ProofPaint } from './shared';
+export type { ProofKind, ProofOfDeliveryLabels, ProofOfDeliveryProps, ProofOfDeliveryResult, ProofOfDeliveryValue, SignaturePadProps, SignaturePoint, SignatureStroke, SignatureValue, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/proof-of-delivery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/proof-of-delivery/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,GACf,MAAM,SAAS,CAAC"}

package/lib/typescript/module/proof-of-delivery/shared.d.ts

@@ -0,0 +1,79 @@
+import type { SurfaceTextPaint } from '../styles/surface-levels';
+import type { Theme } from '../theme/types';
+import type { ProofKind, ProofOfDeliveryValue, SignaturePoint, SignatureStroke, SignatureValue } from './types';
+export interface ProofPaint {
+    surface: string;
+    hairline: string;
+    /** The pad's own fill — the next level up from whatever it is drawn on. */
+    pad: string;
+    text: string;
+    textSecondary: string;
+    textTertiary: string;
+    /** The text rungs that clear AA on the PAD, which is not the form's fill. */
+    padText: SurfaceTextPaint;
+}
+export declare function resolveProofPaint(theme: Theme, surface: string): ProofPaint;
+/** The empty value: nothing drawn, nothing typed, nothing photographed. */
+export declare const EMPTY_SIGNATURE: SignatureValue;
+export declare const EMPTY_PROOF: ProofOfDeliveryValue;
+/** Fills the gaps in a partial value with the empty one, leaving the rest alone. */
+export declare function completeProofValue(value: Partial<ProofOfDeliveryValue> | undefined): ProofOfDeliveryValue;
+/**
+ * One stroke as SVG path data, smoothed.
+ *
+ *   no points     `''` — nothing drawn is not a path of length zero, it is no
+ *                 path at all, and an `<path d="">` is an element the browser
+ *                 still lays out
+ *   one point     a DOT: a zero-length line with a round cap, which is what a
+ *                 full stop in a signature is. Without this a tap lays down
+ *                 nothing and the reader taps harder
+ *   two or more   a move, then a quadratic through the MIDPOINTS of successive
+ *                 points, ending on the last point. Midpoint smoothing is what
+ *                 turns a 60-samples-a-second polyline into something that
+ *                 reads as handwriting; joining the raw points draws the
+ *                 pointer's own stair-stepping
+ *
+ * Coordinates are rounded to two places: a signature does not need a
+ * ten-thousandth of a pixel, and the untrimmed floats triple the size of a
+ * value an app is about to upload.
+ */
+export declare function signaturePath(stroke: SignatureStroke): string;
+/**
+ * Whether a point is far enough from the last one to be worth keeping.
+ *
+ * A pointer reports the same coordinate many times while a finger rests, and
+ * every repeat is a quadratic segment of length zero that the smoothing then
+ * has to average. Dropping them is what keeps the path proportional to the
+ * MOVEMENT rather than to the duration of the press.
+ */
+export declare function shouldKeepSignaturePoint(last: SignaturePoint | undefined, point: SignaturePoint, minDistance?: number): boolean;
+/** Whether anything has been drawn. A stroke with no points is not one. */
+export declare function hasSignatureInk(value: SignatureValue | undefined): boolean;
+/**
+ * Whether a signature has been GIVEN, by either path.
+ *
+ * Drawn ink and a typed name are the same answer, and this is the one place
+ * that is decided — so a screen-reader user who typed their name is never told
+ * the signature is missing.
+ */
+export declare function isSignatureGiven(value: SignatureValue | undefined): boolean;
+/**
+ * Whether one proof has been given.
+ *
+ * A code counts only once it is FULL: `InputOtp` reports every keystroke, and
+ * "2 of 4 digits" is not a code the recipient read out. `codeLength` is
+ * therefore part of the question rather than something the caller checks after.
+ */
+export declare function isProofGiven(kind: ProofKind, value: ProofOfDeliveryValue, codeLength: number): boolean;
+/**
+ * The required proofs that have not been given, in the order they were asked.
+ *
+ * A proof that is required but NOT DRAWN cannot be missing: an app that asks for
+ * four proofs and requires a fifth it never showed would refuse a delivery over
+ * a control nobody could see. The intersection is taken deliberately, and the
+ * ORDER is the drawn order so the summary reads down the form.
+ */
+export declare function missingProofs(value: ProofOfDeliveryValue, required: readonly ProofKind[], shown: readonly ProofKind[], codeLength: number): ProofKind[];
+/** The proofs to draw, in the canonical order, with anything unknown dropped. */
+export declare function orderProofs(proofs: readonly ProofKind[]): ProofKind[];
+//# sourceMappingURL=shared.d.ts.map

package/lib/typescript/module/proof-of-delivery/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/proof-of-delivery/shared.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EACV,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAY3E;AAED,2EAA2E;AAC3E,eAAO,MAAM,eAAe,EAAE,cAA+C,CAAC;AAE9E,eAAO,MAAM,WAAW,EAAE,oBAMzB,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS,GAC/C,oBAAoB,CAQtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAe7D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,KAAK,EAAE,cAAc,EACrB,WAAW,GAAE,MAAiC,GAC7C,OAAO,CAGT;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAE1E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,oBAAoB,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,UAAU,EAAE,MAAM,GACjB,SAAS,EAAE,CAEb;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAErE"}

package/lib/typescript/module/proof-of-delivery/types.d.ts

@@ -0,0 +1,165 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { SortablePhoto } from '../sortable-media';
+/** One point of a drawn stroke, in the pad's own coordinates. */
+export interface SignaturePoint {
+    x: number;
+    y: number;
+}
+/** One unbroken line: the points between a finger going down and coming up. */
+export type SignatureStroke = readonly SignaturePoint[];
+/**
+ * A signature, which is EITHER drawn OR typed and never has to be both.
+ *
+ * Both halves live in one value because they are one answer to one question.
+ * A pad that reported only strokes would make the typed name a second field the
+ * app had to remember to collect, and the first app that forgot it would ship a
+ * signature step no screen-reader user could complete.
+ */
+export interface SignatureValue {
+    /** What was drawn, oldest stroke first. */
+    strokes: readonly SignatureStroke[];
+    /** What was typed instead. */
+    typedName?: string;
+}
+/**
+ * The five things an app can ask for at the door.
+ *
+ * Each is independent: an app asks for none, one, or all five, and says
+ * separately which of the ones it asked for it will not accept a delivery
+ * without.
+ */
+export type ProofKind = 'signature' | 'photo' | 'code' | 'recipient' | 'note';
+/** Everything collected at the door. */
+export interface ProofOfDeliveryValue {
+    signature: SignatureValue;
+    /** The photos, in order, handed to `SortablePhotoGrid` unchanged. */
+    photos: readonly SortablePhoto[];
+    /** The code the recipient read out. Digits only — `InputOtp` cleans it. */
+    code: string;
+    /** Who took it. */
+    recipient: string;
+    /** Anything else about how it went. */
+    note: string;
+}
+/** What the whole thing reports: the value, and what is still missing from it. */
+export interface ProofOfDeliveryResult extends ProofOfDeliveryValue {
+    /**
+     * The REQUIRED proofs that have not been given, in the order they were asked.
+     * Empty means the delivery can be recorded.
+     */
+    missing: readonly ProofKind[];
+}
+/** Every word the family speaks, in one prop. */
+export interface ProofOfDeliveryLabels {
+    /** Over the signature block. Default `"Signature"`. */
+    signature?: string;
+    /** The pad's own name and hint. Defaults `"Signature"` / `"Sign with your finger"`. */
+    signaturePad?: string;
+    signatureHint?: string;
+    /** Said instead of the hint once something has been drawn. Default `"Signed"`. */
+    signed?: string;
+    /** The clear control. Default `"Clear the signature"`. */
+    clear?: string;
+    /** The typed alternative's label and placeholder. Defaults `"Or type your name"` / `"Full name"`. */
+    typeName?: string;
+    typeNamePlaceholder?: string;
+    /** Over the photo block. Default `"Photo"`. */
+    photo?: string;
+    /** Under it. Default `"Where you left it, or the parcel with the recipient."`. */
+    photoHint?: string;
+    /** Over the code block. Default `"Delivery code"`. */
+    code?: string;
+    /** Under it. Default `"Ask the recipient to read out the code in their app."`. */
+    codeHint?: string;
+    /** Over the recipient block. Default `"Who received it"`. */
+    recipient?: string;
+    recipientPlaceholder?: string;
+    /** Over the note block. Default `"Note"`. */
+    note?: string;
+    notePlaceholder?: string;
+    /** The submit control. Default `"Confirm the delivery"`. */
+    submit?: string;
+    /** Marks a block the app will not accept without. Default `"Required"`. */
+    required?: string;
+    /** Shown on a required block that is still empty, after a submit. Default `"This is needed before you can confirm."`. */
+    missing?: string;
+    /** The line over the missing list, after a failed submit. Default `` (n) => n === 1 ? 'One thing is still missing' : `${n} things are still missing` ``. */
+    missingSummary?: (count: number) => string;
+}
+export interface SignaturePadProps {
+    /** Controlled value. */
+    value?: SignatureValue;
+    /** Uncontrolled initial value. Default no strokes and no typed name. */
+    defaultValue?: SignatureValue;
+    onChange?: (value: SignatureValue) => void;
+    /** Called with the finished stroke each time the finger comes up. */
+    onStrokeEnd?: (stroke: SignatureStroke) => void;
+    /** How tall the drawing surface is. Default 180. */
+    height?: number;
+    /** The ink. Default the theme's text colour — a signature is writing, not a brand mark. */
+    ink?: string;
+    /** How thick the ink is. Default 2.5. */
+    strokeWidth?: number;
+    /**
+     * Draws the "or type your name" field under the pad. Default `true`.
+     *
+     * SETTING IT TO `false` REMOVES THE ONLY PATH A SCREEN-READER USER HAS. Do it
+     * only where the app collects the name somewhere else on the same screen.
+     */
+    typed?: boolean;
+    /** Stops drawing and typing, and dims the whole block. */
+    disabled?: boolean;
+    labels?: ProofOfDeliveryLabels;
+    /** Names the block. Default `"Signature"`. */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Derives `-pad`, `-stroke-<n>`, `-clear`, `-typed`. */
+    testID?: string;
+}
+export interface ProofOfDeliveryProps {
+    /** Which proofs are drawn, in the order they are asked. Default all five. */
+    proofs?: readonly ProofKind[];
+    /**
+     * Which of the drawn proofs the app will not record a delivery without.
+     * Default none — every proof is optional until an app says otherwise.
+     */
+    required?: readonly ProofKind[];
+    /** Controlled value. Any field left out falls back to the empty one. */
+    value?: Partial<ProofOfDeliveryValue>;
+    /** Uncontrolled initial value. */
+    defaultValue?: Partial<ProofOfDeliveryValue>;
+    onChange?: (value: ProofOfDeliveryValue) => void;
+    /**
+     * The one result. It fires on EVERY press, with `missing` filled in — see
+     * `ProofOfDelivery`'s note on why the confirm control is never disabled.
+     */
+    onSubmit?: (result: ProofOfDeliveryResult) => void;
+    /** Opens the app's own picker. Without it the photo block draws no add tile. */
+    onAddPhoto?: () => void;
+    /** Draws the retry control on a failed photo. */
+    onRetryPhoto?: (id: string) => void;
+    /** How many boxes the code has. Default `4`. */
+    codeLength?: number;
+    /** How tall the signature pad is. Default 180. */
+    signatureHeight?: number;
+    /** Hides the add tile once this many photos are in. Default `4`. */
+    maxPhotos?: number;
+    /** Dims the confirm control and stops the press while the app is saving. */
+    submitting?: boolean;
+    /** Stops every control. */
+    disabled?: boolean;
+    /** A heading over the whole thing. */
+    title?: string;
+    /** A line under the heading. */
+    description?: string;
+    /** Replaces the confirm control entirely. */
+    actions?: ReactNode;
+    labels?: ProofOfDeliveryLabels;
+    /** Names the form. Default `"Proof of delivery"`. */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Derives `-signature`, `-photo`, `-code`, `-recipient`, `-note`, `-submit`. */
+    testID?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/proof-of-delivery/types.d.ts.map

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

package/lib/typescript/module/screen/Screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../../src/screen/Screen.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,eAAsB,EAAE,eAA2B,EAAE,cAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,2CA0CrP"}
+{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../../src/screen/Screen.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,eAAsB,EAAE,eAA2B,EAAE,cAAsB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,2CA+CrP"}

package/lib/typescript/module/screen/context.d.ts

@@ -5,6 +5,8 @@ export interface ScreenContextValue {
     collapseProgress: SharedValue<number>;
     collapseTarget: SharedValue<number>;
     activeScrollerId: SharedValue<string | null>;
+    /** Document-flow Screen has already reserved its content clearance. */
+    contentInsetsHandled?: boolean;
     topInset: number;
     bottomInset: number;
 }

package/lib/typescript/module/screen/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/screen/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpJ,eAAO,MAAM,uBAAuB,uDAAoD,CAAC;AAEzF,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAC5E,wBAAgB,gBAAgB,8BAAwC;AACxE,wBAAgB,SAAS,IAAI,kBAAkB,CAI9C"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/screen/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpJ,eAAO,MAAM,uBAAuB,uDAAoD,CAAC;AAEzF,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAC5E,wBAAgB,gBAAgB,8BAAwC;AACxE,wBAAgB,SAAS,IAAI,kBAAkB,CAI9C"}

package/lib/typescript/module/screen/types.d.ts

@@ -8,7 +8,7 @@ export interface ScreenProps extends ViewProps {
     active?: boolean;
     /** inherit shell navigation motion; shared establishes a shell; isolated resets it for a modal. */
     navigationScope?: 'inherit' | 'shared' | 'isolated';
-    /** Web document scroller: keep chrome sticky inside this column. */
+    /** Web document flow: bind window scrolling automatically, reserve chrome clearance, and keep chrome sticky within this column. Explicit list bindings take priority. */
     documentScroll?: boolean;
     bottomBar?: ReactNode;
     /** Standalone action; with navigation use BottomBar.action instead. */