@oxy.so/bloom 4.0.0 → 4.1.0

package/lib/typescript/module/place-details/PlacePopularTimes.d.ts

@@ -0,0 +1,45 @@
+import React from 'react';
+import type { PlacePopularTimesProps } from './types';
+/**
+ * How busy a place is, hour by hour, for the day you pick.
+ *
+ * IT IS A CHART AND NOT A METER, and the difference is not decoration: a meter
+ * answers "how full is this one thing", and every reading here only means
+ * something against the twenty-three beside it. So it is drawn the way every
+ * other chart in Bloom is drawn — `react-native-svg` bars on `chart-cards`'
+ * own geometry (`singleBarSlot`, `roundedBarPath`) in one of `chart-cards`'
+ * nine series hues, over the chart track colour. Nothing here invents a shape
+ * or a palette.
+ *
+ *   plot     `height` tall (120 by default), one band per hour; the bar is the
+ *            band less `barCategoryGap` on each side, radius 4
+ *   track    the full plot height behind every bar, so a quiet hour is still a
+ *            hit target's worth of drawing and a CLOSED hour reads as a gap
+ *            rather than as a missing one
+ *   domain   a fixed 0–100. A per-day maximum would make Tuesday's quiet peak
+ *            as tall as Saturday's queue, which is the one comparison this
+ *            chart exists to allow
+ *   now      the current hour takes the hue's `active` step and keeps its axis
+ *            label even when its neighbours' are dropped
+ *   axis     every hour is labelled where they fit; below that, every second
+ *            or third, because twenty-four labels across a phone is 16px each
+ *
+ * ## Which chart card this is NOT
+ *
+ * `StepsCard` draws exactly these bars — and draws them inside the medical
+ * card's fixed 244 height, under its own headline, its week pill and its
+ * count-up, with seven labelled bands. A place sheet has a section header
+ * already and needs twenty-four bands with a day switch, so reusing that card
+ * would have meant suppressing four of its five parts. The BAR maths is what
+ * was worth sharing, and that is what is imported.
+ *
+ * ## The day switch drops "now" with the day
+ *
+ * `currentHourIndex` is a property of a DAY, so switching to Tuesday removes
+ * the marker and the live line. Tuesday has no "now", and a marker that stayed
+ * put would be a reading of a different day.
+ */
+declare function PlacePopularTimesComponent({ days, day, defaultDay, onDayChange, height, hue, daysLabel, accessibilityLabel, emptyLabel, style, testID, }: PlacePopularTimesProps): import("react/jsx-runtime").JSX.Element;
+export declare const PlacePopularTimes: React.MemoExoticComponent<typeof PlacePopularTimesComponent>;
+export {};
+//# sourceMappingURL=PlacePopularTimes.d.ts.map

package/lib/typescript/module/place-details/PlacePopularTimes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlacePopularTimes.d.ts","sourceRoot":"","sources":["../../../../src/place-details/PlacePopularTimes.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAqB7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAiBtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,iBAAS,0BAA0B,CAAC,EAClC,IAAI,EACJ,GAAG,EACH,UAAU,EACV,WAAW,EACX,MAA2C,EAC3C,GAAO,EACP,SAAiB,EACjB,kBAAkB,EAClB,UAAmC,EACnC,KAAK,EACL,MAAM,GACP,EAAE,sBAAsB,2CA+KxB;AAED,eAAO,MAAM,iBAAiB,8DAAmC,CAAC"}

package/lib/typescript/module/place-details/PlaceTransit.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { PlaceTransitProps } from './types';
+/**
+ * The stops around a place, each with the lines that call there and what is
+ * due next.
+ *
+ *   stop        a mode glyph (bus, metro, train, tram, ferry), the stop's name
+ *               in `body-semibold` and how far it is under it. Pressable when
+ *               the app can pan its map to it, with the library's one hover
+ *               wash and one focus ring
+ *   lines       `directions`' own `TransitLineBadge`, imported — an operator's
+ *               line colour is drawn by the badge that already knows how to
+ *               MEASURE a readable label against it, and a second badge here
+ *               would be a second answer to that question
+ *   departures  one row each: the line badge, where it is going, and the time
+ *               on the right, tabular so a column of times lines up
+ *   live        a dot in the success tone AND the word "live" in the row's
+ *               announcement. A colour is not a fact: green alone says nothing
+ *               to a reader who cannot see it, and it is the first thing a
+ *               high-contrast mode takes away
+ *
+ * Each departure is ONE utterance ("Line L4 to Pla del Bosc, 4 min, live"),
+ * because read part by part a column of three badges and three times is six
+ * announcements the listener has to pair up themselves.
+ */
+declare function PlaceTransitComponent({ stops, onPressStop, departureLimit, realtimeLabel, emptyLabel, accessibilityLabel, footer, style, testID, }: PlaceTransitProps): import("react/jsx-runtime").JSX.Element | null;
+export declare const PlaceTransit: React.MemoExoticComponent<typeof PlaceTransitComponent>;
+export {};
+//# sourceMappingURL=PlaceTransit.d.ts.map

package/lib/typescript/module/place-details/PlaceTransit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceTransit.d.ts","sourceRoot":"","sources":["../../../../src/place-details/PlaceTransit.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAY7C,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AAoBnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,qBAAqB,CAAC,EAC7B,KAAK,EACL,WAAW,EACX,cAAc,EACd,aAAsB,EACtB,UAAsC,EACtC,kBAAqC,EACrC,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,iBAAiB,kDA6JnB;AAED,eAAO,MAAM,YAAY,yDAA8B,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { BloomIconComponent } from '../icons/icon-component';
+import type { PlaceBusyTrend, PlaceInfoAction, PlaceTransitMode } from './types';
+/**
+ * The glyph each row action draws on its right — the one place a reader finds
+ * out what the press will do before making it. `none` draws nothing; a row
+ * that navigates keeps `SettingsListItem`'s own chevron.
+ */
+export declare const PLACE_INFO_ACTION_ICON: Readonly<Record<Exclude<PlaceInfoAction, 'none' | 'edit'>, BloomIconComponent>>;
+/**
+ * What each action does, said at the END of the row's name.
+ *
+ * It belongs to the NAME and not to `accessibilityHint`, which was the first
+ * shape this took: **react-native-web drops `accessibilityHint` entirely** —
+ * the rendered button carries no `title`, no `aria-description`, nothing — so
+ * on web the row announced a fact and never said it could be pressed, while
+ * native read it correctly. Same class as `accessibilityState`, same fix: the
+ * one spelling that reaches both platforms.
+ *
+ * It goes last because the fact is what the reader is looking for. `edit` and
+ * `none` say nothing: an "edit" row's own words already are the verb.
+ */
+export declare const PLACE_INFO_ACTION_LABELS: Readonly<Record<PlaceInfoAction, string>>;
+/** The English default trend sentences for the current hour. */
+export declare const PLACE_BUSY_LABELS: Readonly<Record<PlaceBusyTrend, string>>;
+/** The glyph each kind of stop draws. */
+export declare const PLACE_TRANSIT_MODE_ICON: Readonly<Record<PlaceTransitMode, BloomIconComponent>>;
+/** The English default mode words, for a stop's announced name. */
+export declare const PLACE_TRANSIT_MODE_LABELS: Readonly<Record<PlaceTransitMode, string>>;
+export interface PlaceDetailsGeometry {
+    /** Between the blocks of one section. */
+    blockGap: number;
+    /** Between two rows of a list. */
+    rowGap: number;
+    /** A leading glyph. */
+    glyph: number;
+    /** The popular-times plot, axis labels excluded. */
+    chartHeight: number;
+    /** Under the plot, for the hour labels. */
+    chartAxis: number;
+    /** The corner of a busyness bar and of its track. */
+    barRadius: number;
+    /** A bar's share of its band that is GAP, per side (`barCategoryGap`). */
+    barCategoryGap: number;
+    /** The narrowest an hour label may sit from its neighbour before one is dropped. */
+    hourLabelPitch: number;
+}
+/**
+ * One screen, one set of numbers. The gaps are `listing-details`' own rungs
+ * (12 / 16 / 24) so a place's section and a home's section stack identically;
+ * only the chart has measurements of its own, because nothing else in Bloom
+ * draws a day of hours.
+ */
+export declare const PLACE_DETAILS_GEOMETRY: PlaceDetailsGeometry;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/place-details/constants.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAMtE,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAO9E,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAItE,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAM1F,CAAC;AAEF,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAMhF,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;IACvB,oFAAoF;IACpF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBASpC,CAAC"}

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

@@ -0,0 +1,11 @@
+export { PlaceAmenities } from './PlaceAmenities';
+export { PlaceHours } from './PlaceHours';
+export { PlaceInfoList } from './PlaceInfoList';
+export { PlacePopularTimes } from './PlacePopularTimes';
+export { PlaceTransit } from './PlaceTransit';
+export { PLACE_BUSY_LABELS, PLACE_DETAILS_GEOMETRY, PLACE_INFO_ACTION_LABELS, PLACE_INFO_ACTION_ICON, PLACE_TRANSIT_MODE_ICON, PLACE_TRANSIT_MODE_LABELS, } from './constants';
+export type { PlaceDetailsGeometry } from './constants';
+export { busyTrendLabel, describeBusyChart, describeDeparture, describeHoursDay, describeInfoItem, describeTransitStop, formatHoursDay, infoActionWord, resolvePlaceDetailsPaint, } from './shared';
+export type { HoursFormat, PlaceDetailsPaint } from './shared';
+export type { PlaceAmenitiesLayout, PlaceAmenitiesProps, PlaceAmenity, PlaceBusyHour, PlaceBusyTrend, PlaceHoursDay, PlaceHoursInterval, PlaceHoursProps, PlaceInfoAction, PlaceInfoItem, PlaceInfoListProps, PlacePopularTimesDay, PlacePopularTimesProps, PlaceTransitDeparture, PlaceTransitMode, PlaceTransitProps, PlaceTransitStop, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/place-details/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC/D,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,99 @@
+/**
+ * What the place-details parts paint, and the pure text they assemble.
+ *
+ * Every colour is read RELATIVE to the surface the block was dropped on
+ * (`styles/surface-levels.ts`) — the same body of a screen renders in a bottom
+ * sheet on a phone, in a `ContentPanel` on a desktop and on the bare page in a
+ * story, and nothing here picks a ramp stop.
+ */
+import { type SurfaceTextPaint } from '../styles/surface-levels';
+import type { Theme } from '../theme/types';
+import type { PlaceHoursDay, PlaceInfoAction, PlaceInfoItem, PlacePopularTimesDay, PlaceTransitDeparture, PlaceTransitStop } from './types';
+export interface PlaceDetailsPaint extends SurfaceTextPaint {
+    /** A rule between two rows, and a stop's spine. */
+    hairline: string;
+    /** One step off the surface — a chart's empty track, a quiet tile. */
+    fill: string;
+    /** The keyboard focus ring. */
+    ring: string;
+    /** A live reading: the success fill, and what reads on it. */
+    live: string;
+}
+export declare function resolvePlaceDetailsPaint(theme: Theme, surface: string): PlaceDetailsPaint;
+/** What pressing does, as a word. Empty means "say nothing". */
+export declare function infoActionWord(action: PlaceInfoAction | undefined, override: string | undefined, labels: Partial<Record<PlaceInfoAction, string>> | undefined): string;
+/**
+ * A row in one utterance: the kind, the value, then what pressing does.
+ *
+ * "Address: Carrer del Forn 12, Copy" rather than "Carrer del Forn 12,
+ * Address" — a list of five rows is scanned by its KINDS, and a reader who
+ * wants the third one should not have to listen to two addresses to find out
+ * which is which. The verb is last because it is what happens IF they act.
+ *
+ * It is in the name rather than in `accessibilityHint` because web drops the
+ * hint; the note on {@link PLACE_INFO_ACTION_LABELS} has the mechanism. An
+ * explicit `accessibilityLabel` replaces the whole thing, verb included — a
+ * caller spelling the name out is spelling all of it.
+ */
+export declare function describeInfoItem(item: PlaceInfoItem, labels?: Partial<Record<PlaceInfoAction, string>>): string;
+export interface HoursFormat {
+    /** Between the two ends of one stretch. */
+    interval: string;
+    /** Between two stretches of a split day. */
+    split: string;
+    /** A day with no stretches. */
+    closed: string;
+}
+export declare const DEFAULT_HOURS_FORMAT: HoursFormat;
+/**
+ * A day's hours as ONE line: `07:30 – 14:00, 17:00 – 20:00`.
+ *
+ * A split day stays on one line rather than wrapping to two, because the week
+ * is read as a COLUMN of days and a day that takes two rows breaks the
+ * alignment that makes the column scannable. Both stretches are short; the pair
+ * fits in the space one does.
+ */
+export declare function formatHoursDay(day: PlaceHoursDay, format?: HoursFormat): string;
+/**
+ * A day row in one utterance, in reading order: today's word, the day, the
+ * hours, then the exception.
+ *
+ * Today is SAID and not only marked, and so is the exception — a heavier weight
+ * and a badge are both silent, and "Monday 07:30 to 14:00" read in the same
+ * voice as the other six is exactly the row a reader was trying to find.
+ */
+export declare function describeHoursDay(day: PlaceHoursDay, format?: HoursFormat, todayLabel?: string): string;
+/** The trend sentence as drawn, or `null` when the day does not claim one. */
+export declare function busyTrendLabel(day: PlacePopularTimesDay): string | null;
+/** 0–100, clamped. A closed hour draws no bar whatever it says. */
+export declare function busyValue(value: number): number;
+/**
+ * The chart in one sentence, because the chart is ONE element.
+ *
+ * Twenty-four bars two pixels wide are twenty-four tab stops that say a number
+ * each, which is not a reading of anything. So the image is named with what a
+ * person would actually take from the picture: which day, when it peaks, and
+ * what is happening right now.
+ */
+export declare function describeBusyChart(day: PlacePopularTimesDay): string;
+/**
+ * Which hour labels are drawn: every `step`-th one, where the step is the
+ * smallest that keeps neighbouring labels `pitch` apart.
+ *
+ * Every hour labelled is unreadable below about 600px — twenty-four labels
+ * over a phone's width is 16px each — and dropping the ones that do not fit is
+ * the axis's own job, not the caller's.
+ */
+export declare function hourLabelStep(count: number, width: number, pitch: number): number;
+/** A stop in one utterance: what it is, its name, how far. */
+export declare function describeTransitStop(stop: PlaceTransitStop): string;
+/**
+ * A departure in one utterance: the line, where it goes, when it leaves, and
+ * whether the time came off a vehicle.
+ *
+ * "Live" is a WORD here and a colour on screen. A row that is only green says
+ * nothing at all to a reader who cannot see it, and green is also the first
+ * thing to go in a high-contrast mode.
+ */
+export declare function describeDeparture(departure: PlaceTransitDeparture, realtimeLabel?: string): string;
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/place-details/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAM5C,OAAO,KAAK,EAEV,aAAa,EACb,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EAErB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAUzF;AAMD,gEAAgE;AAChE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GAC3D,MAAM,CAIR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,GAChD,MAAM,CAKR;AAMD,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,GAAE,WAAkC,GAAG,MAAM,CAIrG;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,MAAM,GAAE,WAAkC,EAC1C,UAAU,SAAU,GACnB,MAAM,CAOR;AAMD,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,GAAG,IAAI,CAIvE;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAuBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjF;AAMD,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAMlE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,aAAa,SAAS,GACrB,MAAM,CASR"}

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

@@ -0,0 +1,291 @@
+import type { ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { TransitLine } from '../directions/types';
+import type { BloomIconComponent } from '../icons/icon-component';
+import type { PlaceOpenState } from '../place-card/types';
+/**
+ * What pressing a row DOES. It chooses the trailing glyph and the verb the row
+ * is announced with, and nothing else — the clipboard, the dialler and the
+ * browser belong to the app.
+ *
+ * `none` is a row that carries a fact and takes no press (a plus code with
+ * nothing to copy to). It is a member rather than "omit `onPress`" because a
+ * row can be `disabled` while still being a copy row, and the glyph has to
+ * survive that.
+ */
+export type PlaceInfoAction = 'copy' | 'call' | 'open' | 'directions' | 'edit' | 'none';
+/** One row of the block you act on: a glyph, a value, and one thing it does. */
+export interface PlaceInfoItem {
+    /** Identifies the row; keys it and is handed back to `onPress`. */
+    id: string;
+    /**
+     * The VALUE — the address, the number, the domain, the plus code. It is the
+     * row's first line because it is what the reader came for.
+     */
+    value: string;
+    /** What the value is ("Address", "Phone"), drawn quietly under it. */
+    label?: string;
+    /**
+     * How many lines the value may take. Default `2` — a postal address does not
+     * fit on one across a phone, and the part that would be cut is the part that
+     * identifies it. `0` never truncates.
+     */
+    numberOfLines?: number;
+    /** The glyph on the left. Sized and coloured by the row. */
+    icon?: BloomIconComponent;
+    /** Default `none`. */
+    action?: PlaceInfoAction;
+    /** Called with the row's id. A row with neither this nor `href` takes no press. */
+    onPress?: (id: string) => void;
+    /**
+     * Announced instead of the composed `"<label>: <value>, <action>"`. Pass it
+     * when the value is not a word a screen reader can read out (a plus code).
+     * It replaces the WHOLE name, the action word included.
+     */
+    accessibilityLabel?: string;
+    /**
+     * The word for what pressing does, said at the end of the name. Defaults to
+     * the action's own English word ({@link PLACE_INFO_ACTION_LABELS}); `''`
+     * says nothing.
+     */
+    actionLabel?: string;
+    disabled?: boolean;
+}
+export interface PlaceInfoListProps {
+    items: readonly PlaceInfoItem[];
+    /** A heading over the card, in the settings-list register. */
+    title?: string;
+    /** A quiet line under the card. */
+    footer?: string;
+    /** Replaces the English action words for every row that does not carry its own. */
+    actionLabels?: Partial<Record<PlaceInfoAction, string>>;
+    style?: StyleProp<ViewStyle>;
+    /** Each row gets `<testID>-<item id>`. */
+    testID?: string;
+}
+/** One stretch the place is open. Both ends are pre-formatted by the app. */
+export interface PlaceHoursInterval {
+    /** "07:30". */
+    open: string;
+    /** "14:00". */
+    close: string;
+}
+/** One line of the week. */
+export interface PlaceHoursDay {
+    /** Identifies the day; keys the row. Defaults to `label`. */
+    id?: string;
+    /** The day's name as drawn ("Monday"). */
+    label: string;
+    /**
+     * The stretches it is open, in order. A day with none is CLOSED — that is
+     * the whole encoding, so an app cannot say "closed" and list hours at once.
+     */
+    intervals?: readonly PlaceHoursInterval[];
+    /** This day's closed word, when the default does not fit ("Closed for the season"). */
+    closedLabel?: string;
+    /**
+     * A reason this day is not the usual one ("Public holiday"). Drawn as a
+     * badge on the row and added to its announced name.
+     */
+    exception?: string;
+    /** The day the reader is in. Marked on the row and named in its announcement. */
+    today?: boolean;
+}
+export interface PlaceHoursProps {
+    /** The week, starting on whichever day the app starts its week on. */
+    days: readonly PlaceHoursDay[];
+    /**
+     * Whether the place is open NOW. Chooses the tone of the state pill; the
+     * words are {@link PlaceOpenState}'s, shared with `PlaceCard` so one place
+     * cannot be "Open" on the header and "Closing soon" here.
+     */
+    state?: PlaceOpenState;
+    /** Replaces the English state word ("Open", "Closing soon", …). */
+    stateLabel?: string;
+    /**
+     * TODAY'S LINE, pre-formatted and whole: "Open until 20:00", "Closes soon",
+     * "Closed — opens 07:30 tomorrow". It is a sentence the app composes, never
+     * assembled here from the intervals: a clock, a timezone and a language are
+     * three things Bloom does not have.
+     */
+    summary?: string;
+    /** Whether the week is showing. Controlled when set. */
+    expanded?: boolean;
+    /** Default `false`. */
+    defaultExpanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    /** The word added to today's row. Default `"Today"`. */
+    todayLabel?: string;
+    /** A day with no intervals. Default `"Closed"`. */
+    closedLabel?: string;
+    /** Between the two ends of an interval. Default `" – "` (an en dash). */
+    intervalSeparator?: string;
+    /** Between two intervals of a split day. Default `", "`. */
+    splitSeparator?: string;
+    /**
+     * Names the block. Default `"Opening hours"`.
+     *
+     * The TOGGLE takes no name of its own: it is named by the state word and the
+     * summary it draws, which is the better button name ("Open, Open until
+     * 20:00") and the one that cannot disagree with what is on screen.
+     */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Parts get `<testID>-toggle`, `-state`, `-summary`, `-week`, `-day-<n>`. */
+    testID?: string;
+}
+/** How the amenities are drawn. */
+export type PlaceAmenitiesLayout = 'list' | 'chips';
+/** One thing the place has, or pointedly does not. */
+export interface PlaceAmenity {
+    /** The thing, in the reader's words ("Step-free entrance"). */
+    label: string;
+    icon?: BloomIconComponent;
+    /** A second line, `list` only ("Ramp at the side door"). */
+    description?: string;
+    /** `false` strikes the label through and mutes the glyph. Default `true`. */
+    available?: boolean;
+}
+export interface PlaceAmenitiesProps {
+    items: readonly PlaceAmenity[];
+    /** Default `list`. */
+    layout?: PlaceAmenitiesLayout;
+    /** `list` only: `auto` (default) is two columns from 560 wide. */
+    columns?: 1 | 2 | 'auto';
+    /** Draw only the first `limit` amenities. */
+    limit?: number;
+    /** Draws "Show all" when set and more exist than are drawn. */
+    onShowAll?: () => void;
+    /** The full count when `items` is already a subset. Default `items.length`. */
+    total?: number;
+    /** Default `(n) => \`Show all ${n} amenities\``. */
+    showAllLabel?: (total: number) => string;
+    /** Prefixed to an unavailable amenity's name. Default `"Not available"`. */
+    unavailableLabel?: string;
+    /** Names the block. `chips` only — the list names each row instead. Default `"Amenities"`. */
+    accessibilityLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    testID?: string;
+}
+/**
+ * How now compares with the usual. Three members rather than a number because
+ * it is the only part of a busyness reading a person acts on, and the word for
+ * it ({@link PLACE_BUSY_LABELS}) has to be translatable.
+ */
+export type PlaceBusyTrend = 'busier' | 'typical' | 'quieter';
+/** One hour of the day. */
+export interface PlaceBusyHour {
+    /** The hour as drawn on the axis ("6a", "12p", "18:00"). */
+    label: string;
+    /** How busy, 0–100. Clamped; a closed hour draws the empty track whatever this says. */
+    value: number;
+    /** The place is shut this hour: the track is drawn with no bar. */
+    closed?: boolean;
+    /** The hour's spoken name ("6 in the morning"), when the label is two characters. */
+    accessibilityLabel?: string;
+}
+/** One day of the week, with its own hours and its own "now". */
+export interface PlacePopularTimesDay {
+    /** Identifies the day; selects it and keys the bars. */
+    id: string;
+    /** The day on the switch ("Mon"). Keep it short — seven of these share a row. */
+    label: string;
+    /** The day's full name, announced instead of the two letters on the switch. */
+    accessibilityLabel?: string;
+    hours: readonly PlaceBusyHour[];
+    /**
+     * The hour the reader is IN, as an index into `hours`. Only the day that
+     * carries one draws the "now" marker, so switching days drops it — which is
+     * the honest answer, since Tuesday has no "now".
+     */
+    currentHourIndex?: number;
+    /** How the current hour compares with its usual. Draws the live line. */
+    trend?: PlaceBusyTrend;
+    /** Replaces the English trend sentence for this day. */
+    trendLabel?: string;
+}
+export interface PlacePopularTimesProps {
+    days: readonly PlacePopularTimesDay[];
+    /** The shown day's id. Controlled when set. */
+    day?: string;
+    /** Defaults to the day carrying a `currentHourIndex`, else the first. */
+    defaultDay?: string;
+    onDayChange?: (id: string) => void;
+    /** The plot's height in px, axis labels excluded. Default `120`. */
+    height?: number;
+    /** Which of the nine chart hues the bars take. Default `1`, the theme's own seed hue. */
+    hue?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+    /** Names the day switch. Default `"Day"`. */
+    daysLabel?: string;
+    /**
+     * Names the chart, which is ONE image: the bars are not tab stops and each
+     * is two pixels wide. Defaults to a sentence naming the day, the busiest
+     * hour and the current one.
+     */
+    accessibilityLabel?: string;
+    /** A day whose `hours` is empty. Default `"No data for this day"`. */
+    emptyLabel?: string;
+    style?: StyleProp<ViewStyle>;
+    /** Parts get `<testID>-days`, `-chart`, `-live`, `-bar-<n>`. */
+    testID?: string;
+}
+/** What kind of vehicle stops here. Chooses the stop's glyph. */
+export type PlaceTransitMode = 'bus' | 'metro' | 'train' | 'tram' | 'ferry';
+/** One vehicle leaving this stop. */
+export interface PlaceTransitDeparture {
+    /** Identifies the departure; keys the row. */
+    id: string;
+    /** The line, drawn with `directions`' own `TransitLineBadge`. */
+    line: TransitLine;
+    /** Where this one is going ("Pla del Bosc"). */
+    headsign?: string;
+    /** When it leaves, pre-formatted and short ("4 min", "18:42"). Drawn tabular. */
+    time: string;
+    /**
+     * The time came off a vehicle rather than off a timetable. Drawn in the
+     * success tone with a dot, and SAID — a colour is not a fact.
+     */
+    realtime?: boolean;
+    /** Replaces the composed row name ("Line L4 to Pla del Bosc, 4 min, live"). */
+    accessibilityLabel?: string;
+}
+/** One stop near the place. */
+export interface PlaceTransitStop {
+    /** Identifies the stop; keys it and is handed back to `onPressStop`. */
+    id: string;
+    /** The stop's name ("Plaça de les Bruixes"). */
+    name: string;
+    /** Default `bus`. */
+    mode?: PlaceTransitMode;
+    /** How far, pre-formatted ("120 m · 2 min"). */
+    distance?: string;
+    /**
+     * The lines that call here, as badges under the name. Give these even when
+     * `departures` is empty: a stop with no vehicle due still tells the reader
+     * which lines it is on.
+     */
+    lines?: readonly TransitLine[];
+    /** The next few vehicles, in order. */
+    departures?: readonly PlaceTransitDeparture[];
+    /** A word about this stop ("Step-free access"). */
+    note?: string;
+}
+export interface PlaceTransitProps {
+    stops: readonly PlaceTransitStop[];
+    /** Makes each stop's header pressable — an app pans its map to the stop. */
+    onPressStop?: (id: string) => void;
+    /** Draw only this many departures per stop. Default: all of them. */
+    departureLimit?: number;
+    /** The word added to a live departure's name. Default `"live"`. */
+    realtimeLabel?: string;
+    /** A stop with no departures. Default `"No departures right now"`. */
+    emptyLabel?: string;
+    /** Names the list. Default `"Nearby transit"`. */
+    accessibilityLabel?: string;
+    /** Extra content under the stops — a "see all stops" button. */
+    footer?: ReactNode;
+    style?: StyleProp<ViewStyle>;
+    /** Parts get `<testID>-stop-<n>`, `-stop-<n>-departure-<m>`. */
+    testID?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/place-details/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAExF,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,sBAAsB;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,mFAAmF;IACnF,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC1C,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAC/B,sBAAsB;IACtB,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACzB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9D,2BAA2B;AAC3B,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACtC,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5E,qCAAqC;AACrC,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,IAAI,EAAE,WAAW,CAAC;IAClB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,uCAAuC;IACvC,UAAU,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC9C,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PlaceListProps } from './types';
+/**
+ * The places inside a saved list: the place, the person's note about it, and
+ * the controls that move or remove it.
+ *
+ *   place     `PlaceCard` at `density="row"`, untouched — a saved place and a
+ *             search result are the same object, so this list draws no row of
+ *             its own and inherits the thumbnail, the rating, the open state
+ *             and the composed announcement with it
+ *   note      the person's own line, with a document glyph, announced as
+ *             "Note: get the sourdough before noon". It is a SIBLING of the
+ *             place's press target rather than part of its name: the place is
+ *             the place, and the note is what someone said about it
+ *   controls  move earlier, move later, remove — 44 boxes, right-aligned
+ *             under the row
+ *
+ * ## Reordering is buttons, and the buttons ARE the accessible path
+ *
+ * `moveItem` (`hooks/list-reorder`) is the same list maths the track list, the
+ * queue and the photo grid use, so "move" means one thing in this package.
+ * There is no pointer drag here: `SortablePhotoGrid`'s drag is grid geometry —
+ * a point resolved to a cell in a fixed row of columns — and a column of rows
+ * of different heights is a different problem, not a smaller one. Buttons are
+ * also what a keyboard and a screen reader get from a drag surface anyway, so
+ * the list is fully operable with the half that exists.
+ *
+ * Every move is announced politely, and every row is KEYED BY ITS ID — so on
+ * web the button that was just pressed keeps the focus and travels with its
+ * row, and a reader can press "move later" three times without hunting for it
+ * again.
+ *
+ * The first row's "move earlier" and the last row's "move later" are DISABLED
+ * rather than absent: a control that disappears at the end of its travel moves
+ * the two beside it under the pointer.
+ */
+declare function PlaceListComponent({ places, onReorder, onRemove, disabled, labels, empty, accessibilityLabel, style, testID, }: PlaceListProps): import("react/jsx-runtime").JSX.Element;
+export declare const PlaceList: React.MemoExoticComponent<typeof PlaceListComponent>;
+export {};
+//# sourceMappingURL=PlaceList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceList.d.ts","sourceRoot":"","sources":["../../../../src/place-list/PlaceList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAepE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,iBAAS,kBAAkB,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,QAAQ,EACR,QAAgB,EAChB,MAAM,EACN,KAAK,EACL,kBAAmC,EACnC,KAAK,EACL,MAAM,GACP,EAAE,cAAc,2CAoHhB;AAED,eAAO,MAAM,SAAS,sDAA2B,CAAC"}

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

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { PlaceListCardProps } from './types';
+/**
+ * A saved list of places — "Want to go", "Favourites", "Coffee, ranked".
+ *
+ *   cover   a 112 strip of the first four places' photos, 2px seams, radius
+ *           12: the first tile takes two shares of the row and the rest one
+ *           each, so a list with photos reads as a PLACE and not as a folder.
+ *           With no photos it is one tinted tile holding `empty`
+ *   body    the list's glyph and its name (`body-semibold`), then one quiet
+ *           meta line — the count, then who it is shared with
+ *   people  `AvatarGroup` on the right, 24 each, at most three
+ *   badge   the visibility, with its own glyph: private, shared, public
+ *
+ * THE COUNT AND THE SHARING ARE ONE LINE, not two rows of chrome. A saved list
+ * is scanned in a grid of them, and the only questions asked of a card in that
+ * grid are "which list is this" and "how much is in it".
+ *
+ * The card is ONE press target carrying four facts, so it announces them as
+ * one sentence (`composePlaceListName`) rather than leaving the reader to
+ * assemble "Want to go 12 places Shared Ana Marc" out of four runs.
+ *
+ * `AvatarGroup` here takes no `onPressItem`: a button inside the card's own
+ * press target is the nested control this library refuses everywhere, and a
+ * collaborator's profile belongs on the list's own screen.
+ */
+declare function PlaceListCardComponent(props: PlaceListCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const PlaceListCard: React.MemoExoticComponent<typeof PlaceListCardComponent>;
+export {};
+//# sourceMappingURL=PlaceListCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceListCard.d.ts","sourceRoot":"","sources":["../../../../src/place-list/PlaceListCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAa7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,2CA4IxD;AAED,eAAO,MAAM,aAAa,0DAA+B,CAAC"}