react-listing-engine 0.1.0

package/dist/styled/index.d.cts

@@ -0,0 +1,123 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { c as IListingCardProps, e as IListingEmptyProps, f as IListingFilterPanelProps, g as IListingLoadingProps, h as IListingMarkerProps, i as IListingPopupProps, j as IListingResultHeaderProps, k as IListingSearchProps, l as IListingSidebarProps, I as IListingToolbarProps, d as IListingComponents } from '../components-provider-CF0Mo0B8.cjs';
+export { B as BottomNav, b as BottomNavView, I as IBottomNavAction, c as IBottomNavProps, d as IStyledListingLayoutProps, L as ListingApp, e as ListingAppMapProp, a as ListingAppProps, S as StyledListingLayout } from '../listing-app-pKMQBuQI.cjs';
+import '../entity-adapter.interface-BDgbSxhq.cjs';
+import '../map-provider.interface-BMnwW3ob.cjs';
+import '../listing-config-options.interface-ZJYY_ZvR.cjs';
+
+/**
+ * Default `/styled` `Card` slot. Renders an optional image, title, subtitle,
+ * badge and price from a plain view-model item -- image -> title -> address
+ * (subtitle) -> info line (badge) -> price, using only `.rle-*` classes (see
+ * `styles.css`). Doubles as the clickable/selectable surface (`onSelect`):
+ * when given, the card is a `<button type="button">` so it's keyboard
+ * operable and announces as a toggle (`aria-pressed`) for free; the
+ * `[type='button']` attribute selector in `styles.css` is what gives it the
+ * pointer/hover/focus affordances the plain `<article>` variant doesn't get.
+ */
+declare function StyledCard({ item, selected, onSelect }: IListingCardProps): react.JSX.Element;
+
+/** Default `/styled` `Empty` slot: a centered empty state with an icon, heading and hint. */
+declare function StyledEmpty(_props: IListingEmptyProps): react.JSX.Element;
+
+/** Default `/styled` `FilterPanel` slot (`.rle-filter-panel`): stacks one filter control per row inside `Sidebar`. */
+declare function StyledFilterPanel({ children }: IListingFilterPanelProps): react.JSX.Element;
+
+/** Default `/styled` `Loading` slot: a shimmering `.rle-skeleton` grid, announced via `role="status"`. */
+declare function StyledLoading(_props: IListingLoadingProps): react.JSX.Element;
+
+/** Default `/styled` `Marker` slot: a teardrop price pin (`.rle-pin`, Rentler-style, pointer via CSS `::after`) for a map point. */
+declare function StyledMarker({ point }: IListingMarkerProps): react.JSX.Element;
+
+/**
+ * Default `/styled` `Popup` slot: a small `.rle-popup` card with an
+ * accessible close button. `role="group"` + `aria-label` (rather than
+ * `role="dialog"`) since this is a non-modal, non-focus-trapped popup
+ * anchored to a map marker -- `dialog` without modality/focus management
+ * would misrepresent it to AT users. Mirrors `/shadcn`'s `DefaultPopup`.
+ */
+declare function StyledPopup({ entity, onClose }: IListingPopupProps): react.JSX.Element;
+
+/** Default `/styled` `ResultHeader` slot: `"{count} results"`, or `"{count} of {total} results"` when a distinct total is known. */
+declare function StyledResultHeader({ count, total }: IListingResultHeaderProps): react.JSX.Element;
+
+/** Default `/styled` `Search` slot: a plain `.rle-input` text input. */
+declare function StyledSearch({ value, onChange, placeholder }: IListingSearchProps): react.JSX.Element;
+
+/** Default `/styled` `Sidebar` slot (`.rle-sidebar`): the outer chrome for the filters column. */
+declare function StyledSidebar({ children }: IListingSidebarProps): react.JSX.Element;
+
+/** Default `/styled` `Toolbar` slot: a bordered bar (`.rle-toolbar`) wrapping arbitrary children. */
+declare function StyledToolbar({ children }: IListingToolbarProps): react.JSX.Element;
+
+/**
+ * Convenience wrapper around `ListingComponentsProvider` that wires in every
+ * package-shipped `Styled*` component (via `styledDefaultComponents`, the
+ * shared source of truth). Use this for a fully styled, Tailwind-free UI out
+ * of the box -- pair it with `import 'react-listing-engine/styles.css'`; use
+ * `ListingComponentsProvider` directly (with your own components for some or
+ * all slots) otherwise -- the two compose fine since `ListingComponentsProvider`
+ * falls back per-slot. Mirrors `/shadcn`'s `ListingComponentsProviderWithDefaults`.
+ */
+declare function StyledComponentsProviderWithDefaults({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+
+/**
+ * Every `/styled` default, keyed by slot -- the single source of truth for
+ * `StyledComponentsProviderWithDefaults`, mirroring `/shadcn`'s
+ * `shadcnDefaultComponents`.
+ *
+ * Kept as a plain object, not JSX, so a caller can merge it with
+ * `{ ...styledDefaultComponents, ...overrides }` and hand the result to ONE
+ * `ListingComponentsProvider`. This matters because `ListingComponentsProvider`
+ * merges `provided ?? ITS OWN private, UNSTYLED fallbacks` per slot -- it does
+ * not read the parent context (see `~/react/components-provider.tsx`).
+ * Nesting a bare `ListingComponentsProvider` (with only the overrides) INSIDE
+ * a `StyledComponentsProviderWithDefaults` would therefore silently reset
+ * every un-overridden slot back to the bare fallback instead of the styled
+ * default -- exactly the bug this object exists to avoid.
+ */
+declare const styledDefaultComponents: IListingComponents;
+
+interface IBottomSheetProps {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    title?: string;
+    children?: ReactNode;
+    footer?: ReactNode;
+}
+/**
+ * Dependency-free mobile bottom sheet -- the `/styled` adapter's own modal
+ * primitive, used by `StyledListingLayout` for the mobile filters panel.
+ * Deliberately NOT the `~/shadcn` adapter's Radix-based `Sheet`: `/styled`
+ * ships zero UI dependencies beyond `react`/`react-dom`, so this is a small
+ * hand-rolled implementation covering just what a filters sheet needs --
+ * portal, backdrop-click/Escape-to-close, a body-scroll lock, and the
+ * `.rle-sheet--open` slide-up transition. Not a full focus trap (Tab can
+ * still escape to the rest of the page while open) -- only initial focus
+ * placement, which is enough for this component's scope; a real focus trap
+ * is a documented future enhancement if/when this needs to satisfy a
+ * stricter modal-dialog a11y bar.
+ *
+ * MOUNT/ANIMATE: rendering is driven by two pieces of state instead of one --
+ * `rendered` (is the sheet in the DOM at all) flips synchronously with
+ * `open`, but `animateOpen` (does it carry the `.rle-sheet--open` class) is
+ * deferred one animation frame past mount. That gap is what lets the
+ * transform transition actually run: mounting directly with `.rle-sheet--open`
+ * already applied would paint the very first frame already in its final
+ * (slid-up) position, and a CSS transition never animates a property that
+ * never visibly changes. On close, both flags drop together and the sheet
+ * unmounts immediately -- no exit animation. Simpler than tracking an
+ * exit-in-progress phase, and an acceptable trade-off for a filters sheet
+ * (see the task brief: "keep it mounted briefly for exit or just unmount --
+ * simple is fine").
+ *
+ * SSR-safe: `document` is only ever touched inside effects/the portal-target
+ * check below, never during the render body itself, so this component is
+ * inert (renders nothing) until it has mounted client-side.
+ */
+declare function BottomSheet({ open, onOpenChange, title, children, footer }: IBottomSheetProps): react.ReactPortal | null;
+
+export { BottomSheet, type IBottomSheetProps, StyledCard, StyledComponentsProviderWithDefaults, StyledEmpty, StyledFilterPanel, StyledLoading, StyledMarker, StyledPopup, StyledResultHeader, StyledSearch, StyledSidebar, StyledToolbar, styledDefaultComponents };

package/dist/styled/index.d.ts

@@ -0,0 +1,123 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { c as IListingCardProps, e as IListingEmptyProps, f as IListingFilterPanelProps, g as IListingLoadingProps, h as IListingMarkerProps, i as IListingPopupProps, j as IListingResultHeaderProps, k as IListingSearchProps, l as IListingSidebarProps, I as IListingToolbarProps, d as IListingComponents } from '../components-provider-CjMxkxrP.js';
+export { B as BottomNav, b as BottomNavView, I as IBottomNavAction, c as IBottomNavProps, d as IStyledListingLayoutProps, L as ListingApp, e as ListingAppMapProp, a as ListingAppProps, S as StyledListingLayout } from '../listing-app-De6OqpUC.js';
+import '../entity-adapter.interface-BDgbSxhq.js';
+import '../map-provider.interface-BxexMT3X.js';
+import '../listing-config-options.interface-ZJYY_ZvR.js';
+
+/**
+ * Default `/styled` `Card` slot. Renders an optional image, title, subtitle,
+ * badge and price from a plain view-model item -- image -> title -> address
+ * (subtitle) -> info line (badge) -> price, using only `.rle-*` classes (see
+ * `styles.css`). Doubles as the clickable/selectable surface (`onSelect`):
+ * when given, the card is a `<button type="button">` so it's keyboard
+ * operable and announces as a toggle (`aria-pressed`) for free; the
+ * `[type='button']` attribute selector in `styles.css` is what gives it the
+ * pointer/hover/focus affordances the plain `<article>` variant doesn't get.
+ */
+declare function StyledCard({ item, selected, onSelect }: IListingCardProps): react.JSX.Element;
+
+/** Default `/styled` `Empty` slot: a centered empty state with an icon, heading and hint. */
+declare function StyledEmpty(_props: IListingEmptyProps): react.JSX.Element;
+
+/** Default `/styled` `FilterPanel` slot (`.rle-filter-panel`): stacks one filter control per row inside `Sidebar`. */
+declare function StyledFilterPanel({ children }: IListingFilterPanelProps): react.JSX.Element;
+
+/** Default `/styled` `Loading` slot: a shimmering `.rle-skeleton` grid, announced via `role="status"`. */
+declare function StyledLoading(_props: IListingLoadingProps): react.JSX.Element;
+
+/** Default `/styled` `Marker` slot: a teardrop price pin (`.rle-pin`, Rentler-style, pointer via CSS `::after`) for a map point. */
+declare function StyledMarker({ point }: IListingMarkerProps): react.JSX.Element;
+
+/**
+ * Default `/styled` `Popup` slot: a small `.rle-popup` card with an
+ * accessible close button. `role="group"` + `aria-label` (rather than
+ * `role="dialog"`) since this is a non-modal, non-focus-trapped popup
+ * anchored to a map marker -- `dialog` without modality/focus management
+ * would misrepresent it to AT users. Mirrors `/shadcn`'s `DefaultPopup`.
+ */
+declare function StyledPopup({ entity, onClose }: IListingPopupProps): react.JSX.Element;
+
+/** Default `/styled` `ResultHeader` slot: `"{count} results"`, or `"{count} of {total} results"` when a distinct total is known. */
+declare function StyledResultHeader({ count, total }: IListingResultHeaderProps): react.JSX.Element;
+
+/** Default `/styled` `Search` slot: a plain `.rle-input` text input. */
+declare function StyledSearch({ value, onChange, placeholder }: IListingSearchProps): react.JSX.Element;
+
+/** Default `/styled` `Sidebar` slot (`.rle-sidebar`): the outer chrome for the filters column. */
+declare function StyledSidebar({ children }: IListingSidebarProps): react.JSX.Element;
+
+/** Default `/styled` `Toolbar` slot: a bordered bar (`.rle-toolbar`) wrapping arbitrary children. */
+declare function StyledToolbar({ children }: IListingToolbarProps): react.JSX.Element;
+
+/**
+ * Convenience wrapper around `ListingComponentsProvider` that wires in every
+ * package-shipped `Styled*` component (via `styledDefaultComponents`, the
+ * shared source of truth). Use this for a fully styled, Tailwind-free UI out
+ * of the box -- pair it with `import 'react-listing-engine/styles.css'`; use
+ * `ListingComponentsProvider` directly (with your own components for some or
+ * all slots) otherwise -- the two compose fine since `ListingComponentsProvider`
+ * falls back per-slot. Mirrors `/shadcn`'s `ListingComponentsProviderWithDefaults`.
+ */
+declare function StyledComponentsProviderWithDefaults({ children }: {
+    children: ReactNode;
+}): react.JSX.Element;
+
+/**
+ * Every `/styled` default, keyed by slot -- the single source of truth for
+ * `StyledComponentsProviderWithDefaults`, mirroring `/shadcn`'s
+ * `shadcnDefaultComponents`.
+ *
+ * Kept as a plain object, not JSX, so a caller can merge it with
+ * `{ ...styledDefaultComponents, ...overrides }` and hand the result to ONE
+ * `ListingComponentsProvider`. This matters because `ListingComponentsProvider`
+ * merges `provided ?? ITS OWN private, UNSTYLED fallbacks` per slot -- it does
+ * not read the parent context (see `~/react/components-provider.tsx`).
+ * Nesting a bare `ListingComponentsProvider` (with only the overrides) INSIDE
+ * a `StyledComponentsProviderWithDefaults` would therefore silently reset
+ * every un-overridden slot back to the bare fallback instead of the styled
+ * default -- exactly the bug this object exists to avoid.
+ */
+declare const styledDefaultComponents: IListingComponents;
+
+interface IBottomSheetProps {
+    open: boolean;
+    onOpenChange(open: boolean): void;
+    title?: string;
+    children?: ReactNode;
+    footer?: ReactNode;
+}
+/**
+ * Dependency-free mobile bottom sheet -- the `/styled` adapter's own modal
+ * primitive, used by `StyledListingLayout` for the mobile filters panel.
+ * Deliberately NOT the `~/shadcn` adapter's Radix-based `Sheet`: `/styled`
+ * ships zero UI dependencies beyond `react`/`react-dom`, so this is a small
+ * hand-rolled implementation covering just what a filters sheet needs --
+ * portal, backdrop-click/Escape-to-close, a body-scroll lock, and the
+ * `.rle-sheet--open` slide-up transition. Not a full focus trap (Tab can
+ * still escape to the rest of the page while open) -- only initial focus
+ * placement, which is enough for this component's scope; a real focus trap
+ * is a documented future enhancement if/when this needs to satisfy a
+ * stricter modal-dialog a11y bar.
+ *
+ * MOUNT/ANIMATE: rendering is driven by two pieces of state instead of one --
+ * `rendered` (is the sheet in the DOM at all) flips synchronously with
+ * `open`, but `animateOpen` (does it carry the `.rle-sheet--open` class) is
+ * deferred one animation frame past mount. That gap is what lets the
+ * transform transition actually run: mounting directly with `.rle-sheet--open`
+ * already applied would paint the very first frame already in its final
+ * (slid-up) position, and a CSS transition never animates a property that
+ * never visibly changes. On close, both flags drop together and the sheet
+ * unmounts immediately -- no exit animation. Simpler than tracking an
+ * exit-in-progress phase, and an acceptable trade-off for a filters sheet
+ * (see the task brief: "keep it mounted briefly for exit or just unmount --
+ * simple is fine").
+ *
+ * SSR-safe: `document` is only ever touched inside effects/the portal-target
+ * check below, never during the render body itself, so this component is
+ * inert (renders nothing) until it has mounted client-side.
+ */
+declare function BottomSheet({ open, onOpenChange, title, children, footer }: IBottomSheetProps): react.ReactPortal | null;
+
+export { BottomSheet, type IBottomSheetProps, StyledCard, StyledComponentsProviderWithDefaults, StyledEmpty, StyledFilterPanel, StyledLoading, StyledMarker, StyledPopup, StyledResultHeader, StyledSearch, StyledSidebar, StyledToolbar, styledDefaultComponents };

package/dist/styled/index.js

@@ -0,0 +1,2 @@
+"use client";
+import{b as r,c as p,d as i,e as d,f as y,g as l,h as n,i as m,j as s,k as a,l as t,m as S,n as f,o as P,p as u}from"../chunk-2T5PE5MB.js";import{p as e}from"../chunk-PFPHWJAA.js";import{jsx as g}from"react/jsx-runtime";function L({children:o}){return g(e,{...t,children:o})}export{S as BottomNav,f as BottomSheet,u as ListingApp,r as StyledCard,L as StyledComponentsProviderWithDefaults,p as StyledEmpty,i as StyledFilterPanel,P as StyledListingLayout,d as StyledLoading,y as StyledMarker,l as StyledPopup,n as StyledResultHeader,m as StyledSearch,s as StyledSidebar,a as StyledToolbar,t as styledDefaultComponents};