@nice2dev/events 1.1.9 → 1.2.0

package/dist/index.d.ts

@@ -409,18 +409,12 @@ export declare interface NiceCollageItem {
     durationMs?: number;
 }
 
-/**
- * {@link NiceEventMedia} — responsive media gallery (photos / videos) built from
- * Nice* controls: NiceUpload for adding media and NiceCardGroup for the layout.
- * Each card keeps its thumbnail, caption and actions together on one line and
- * wraps responsively; broken images fall back to a themed placeholder.
- */
 export declare const NiceEventMedia: default_2.ForwardRefExoticComponent<NiceEventMediaProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for {@link NiceEventMedia}. */
 export declare interface NiceEventMediaProps {
-    /** Media items. */
-    items: EventMediaItem[];
+    /** Media items. Optional: without them the gallery is empty. */
+    items?: EventMediaItem[];
     /** Called when uploading new media. */
     onUpload?: (file: File, caption?: string) => void;
     /** Called when deleting media. */
@@ -545,32 +539,14 @@ export declare interface NiceExpenseIssue {
     reason: 'no-payer' | 'unknown-payer' | 'no-participants';
 }
 
-/**
- * {@link NiceExpenseSplit} — who paid, who owes, and the shortest way to square up.
- *
- * Three views over the same data: the expense list, each person's net balance,
- * and a settlement plan that reduces the debt graph to few transfers (at most
- * one less than the number of people who owe or are owed). The plan is not
- * provably minimal — exact minimisation is NP-hard — but it is what every
- * comparable product ships and it is optimal in ordinary cases.
- *
- * Arithmetic runs on integer minor units, so balances sum to exactly zero and
- * no rounding drifts. Expenses in different currencies are grouped and settled
- * separately rather than converted: applying an exchange rate silently at
- * render time would be a correctness bug, and this package has no business
- * owning FX rates.
- *
- * `BillingItem.isPaid` does not affect balances — it records that the vendor
- * was paid, not that the group settled up.
- */
 export declare const NiceExpenseSplit: default_2.ForwardRefExoticComponent<NiceExpenseSplitProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for {@link NiceExpenseSplit}. */
 export declare interface NiceExpenseSplitProps {
-    /** Expenses, using the existing `BillingItem` shape. */
-    items: BillingItem[];
-    /** Everyone who can pay or owe. */
-    participants: Array<{
+    /** Expenses, using the existing `BillingItem` shape. Optional: without them nothing is owed. */
+    items?: BillingItem[];
+    /** Everyone who can pay or owe. Optional: without them the split is empty. */
+    participants?: Array<{
         id: string;
         name: string;
         avatarUrl?: string;
@@ -665,8 +641,8 @@ export declare interface NiceGiftRegistryItem {
 
 /** Props for {@link NiceGiftRegistry}. */
 export declare interface NiceGiftRegistryProps {
-    /** Items on the list. */
-    items: NiceGiftRegistryItem[];
+    /** Items on the list. Optional: without them the list is empty. */
+    items?: NiceGiftRegistryItem[];
     /**
      * `registry` tracks quantities and money towards each gift; `wishlist` is
      * the same list without the money — priority and a bought/not-bought flag.
@@ -728,8 +704,13 @@ export declare const NiceInvitationDesigner: default_2.ForwardRefExoticComponent
 
 /** Props for {@link NiceInvitationDesigner}. */
 export declare interface NiceInvitationDesignerProps {
-    /** The template being edited. */
-    template: NiceInvitationTemplate;
+    /**
+     * The template being edited (controlled). Optional: leave it out and the designer keeps
+     * its own template, seeded from `defaultTemplate` or starting blank.
+     */
+    template?: NiceInvitationTemplate;
+    /** Initial template when uncontrolled. */
+    defaultTemplate?: NiceInvitationTemplate;
     onTemplateChange?: (template: NiceInvitationTemplate) => void;
     /** Placeholders offered as insert buttons. */
     tokens?: NiceInvitationToken[];
@@ -804,19 +785,6 @@ export declare interface NiceKaraokePickerProps {
     style?: default_2.CSSProperties;
 }
 
-/**
- * {@link NiceMediaCollage} — arrange photos and video into an ordered collage
- * and play it back as a slideshow.
- *
- * The companion to `NiceEventMedia`: that one is for browsing what people
- * uploaded, this one is for deciding what the montage looks like. Tiles are
- * reordered by dragging or from the keyboard (focus a tile, Space to pick it
- * up, arrows to move, Space to drop, Escape to cancel) — pointer events
- * throughout, so it works on a phone.
- *
- * Order is controlled by the caller: the component sorts the `items` it is
- * given and reports moves through `onReorder`.
- */
 export declare const NiceMediaCollage: default_2.ForwardRefExoticComponent<NiceMediaCollageProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Arrangement used by `NiceMediaCollage`. */
@@ -824,8 +792,8 @@ export declare type NiceMediaCollageLayout = 'sequence' | 'grid' | 'mosaic';
 
 /** Props for {@link NiceMediaCollage}. */
 export declare interface NiceMediaCollageProps {
-    /** Tiles, in the order they should appear. */
-    items: NiceCollageItem[];
+    /** Tiles, in the order they should appear. Optional: without them the collage is empty. */
+    items?: NiceCollageItem[];
     /** Arrangement. `sequence` is a single ordered strip; the others are grids. */
     layout?: NiceMediaCollageLayout;
     /**
@@ -878,8 +846,8 @@ export declare const NiceParticipantList: default_2.ForwardRefExoticComponent<Ni
 
 /** Props for {@link NiceParticipantList}. */
 export declare interface NiceParticipantListProps {
-    /** The roster. */
-    participants: EventParticipant[];
+    /** The roster. Optional: without it the list is empty. */
+    participants?: EventParticipant[];
     /**
      * `organizer` manages everyone; `guest` shows only the viewer's own entry
      * with RSVP actions.
@@ -1028,33 +996,12 @@ export declare interface NiceRsvpSelection {
     note?: string;
 }
 
-/**
- * {@link NiceSeatingChart} — pick seats from a venue plan, at any venue size.
- *
- * Renders SVG with three levels of detail chosen from how many seats are
- * actually in view: whole sections when zoomed out, row strips in between,
- * individual seats up close. Because the tier is decided *after* culling, a
- * 20 000-seat stadium and a 200-seat theatre both draw a bounded number of
- * nodes — the cap is `maxRenderedSeats`, not the size of the chart.
- *
- * Two ways in, both always present. The map supports pan, pinch-zoom and a
- * roving keyboard cursor (arrows to move, Home/End for the row ends,
- * PageUp/PageDown between sections, Enter to toggle). Moving the cursor forces
- * seat-level detail and pans to follow, because a focused element that gets
- * culled away takes the focus with it. Alongside it, `showList` opens a plain
- * section → row → seat picker with a "best available" button — the only
- * workable path with a screen reader, and the one most sighted buyers want too.
- *
- * Accessible seats are distinguished by shape, pattern and text as well as
- * colour, and survive being sold: use `Seat.accessType`, since `SeatStatus`
- * alone cannot represent a sold wheelchair space.
- */
 export declare const NiceSeatingChart: default_2.ForwardRefExoticComponent<NiceSeatingChartProps & default_2.RefAttributes<HTMLDivElement>>;
 
 /** Props for {@link NiceSeatingChart}. */
 export declare interface NiceSeatingChartProps {
-    /** The venue layout, using the existing `SeatingChart` type. */
-    chart: SeatingChart;
+    /** The venue layout, using the existing `SeatingChart` type. Optional: without it the chart has no sections. */
+    chart?: SeatingChart;
     /** `select` lets a buyer pick seats; `view` is read-only; `design` is reserved. */
     mode?: 'design' | 'select' | 'view';
     /** Selection rules: how many, which categories, whether gaps are allowed. */
@@ -1128,6 +1075,9 @@ export declare interface NiceSettlementTransfer {
 
 /**
  * {@link NiceSongPicker} — Song selection for music events.
+ *
+ * Nice controls and texts through `t()` (1.2.0); it used a bare input, native buttons and a
+ * "+" glyph, all in English.
  */
 export declare const NiceSongPicker: default_2.ForwardRefExoticComponent<NiceSongPickerProps & default_2.RefAttributes<HTMLDivElement>>;
 
@@ -1461,11 +1411,4 @@ export declare interface VenueZoneOccupancy {
  */
 export declare type VenueZoneType = 'stage' | 'vip' | 'general' | 'standing' | 'seated' | 'bar' | 'food-court' | 'backstage' | 'entrance' | 'exit' | 'emergency-exit' | 'restroom' | 'parking' | 'press' | 'tech-booth' | 'medical' | 'security' | 'custom';
 
-/**
- * @deprecated Use `VenueZoneOccupancy`. `@nice2dev/ui-buildings` exports a different
- * `ZoneOccupancy` (a building sensor reading), so importing both packages collided;
- * this alias is removed in 1.2.0.
- */
-export declare type ZoneOccupancy = VenueZoneOccupancy;
-
 export { }